init

Author: matthiez

.idea/.gitignore

@@ -0,0 +1,38 @@
+![](https://www.sms77.io/wp-content/uploads/2019/07/sms77-Logo-400x79.png "sms77 Logo")
+
+# sms77 SMS for Open Source Point of Sale
+
+This code implements sms77 as SMS gateway for sending messages via OSPOS.
+
+## Prerequisites
+
+- An API Key from [sms77](https://www.sms77.io) - you can create on in
+  your [developer dashboard](https://app.sms77.io/developer).
+- An existing [OSPOS](https://opensourcepos.org/) installation.
+
+## Installation
+
+The procedure for installing is very simple. You just need access to the installation path
+of OSPOS for replacing `/application/libraries/Sms_lib.php`
+with [Sms_lib.php](Sms_lib.php).
+
+## Setup
+
+1. Log in to your OSPOS dashboard.
+2. Go to `Configuration -> Setup & Conf -> Message`.
+3. Set `SMS-API Username` to any value, as the field is not used. Just make sure it's not
+   empty.
+4. Set `SMS-API Password` to your sms77 API key.
+5. Set `SMS-API Sender ID` to your sender identifier of choice with a maximum length of 11
+   alphanumeric or 16 numeric characters. This value gets displayed as the sender in the
+   receivers phone device. Please notice that country specific restrictions may apply,
+   e.g. some countries don't allow setting those at all.
+6. Optionally set `Saved Text Message` to a predefined message template.
+7. The last step is to save your configuration by clicking `Submit`.
+
+See the [screenshot](configuration.png) for an example configuration.
+
+## Support
+
+Feel free to [contact us](https://www.sms77.io/en/company/contact/) in case you need any
+assistance.

.idea/markdown.xml

@@ -0,0 +1,43 @@
+<?php if (!defined('BASEPATH')) exit('No direct script access allowed');
+
+/**
+ * SMS library
+ * Library with utilities to send texts via SMS Gateway (requires proxy implementation)
+ */
+class Sms_lib {
+    private $CI;
+
+    public function __construct() {
+        $this->CI =& get_instance();
+    }
+
+    /*
+     * SMS sending function
+     * Example of use: $response = sendSMS('4477777777', 'My test message');
+     */
+    public function sendSMS($to, $text) {
+        $password = $this->CI->encryption->decrypt($this->CI->config->item('msg_pwd'));
+        $from = $this->CI->config->item('msg_src');
+        $response = false;
+
+        if (!empty($password) && !empty($phone) && !empty($text) && !empty($from)) {
+            $ch = curl_init('https://gateway.sms77.io/api/sms');
+            $options = [
+                CURLOPT_HTTPHEADER => [
+                    'Accept: application/json',
+                    'Content-Type: application/json',
+                    'X-Api-Key: ' . $password,
+                ],
+                CURLOPT_POSTFIELDS => json_encode(compact('from', 'text', 'to')),
+                CURLOPT_RETURNTRANSFER => true,
+            ];
+            curl_setopt_array($ch, $options);
+            $response = curl_exec($ch);
+            curl_close($ch);
+        }
+
+        return $response;
+    }
+}
+
+?>