Перегляд вихідного коду сторінки Sms

==Описание==
Модули sms позволяют:
* отправить произвольное сообщение на телефон абонента
* отправить пароль на телефон абонента
* отправить sms абонентам по заданному фильтру
* автоматически за несколько дней отправлять напоминания абонентам о скором списании абонплаты в случае, если после этого баланс станет отрицательным
* отправить сообщение о пополнении счета


Sms модулей несколько - в зависимости через какой сервис будет идти отправка sms:
* turbosms -  сервис [https://turbosms.ua/ turbosms.ua]
* lifesms - оператор Lifecell

==Технические детали==

Каждая смс записывается в базу данных в соответствующую таблицу. Здесь есть небольшой нюанс. База данных turbosms - удаленная, принадлежит сервису turbosms.ua. Достаточно создать запись в этой базе и смс будет отправлена.

База данных lifesms - локальная, это и есть база NoDeny. Поэтому чтобы отправить sms, недостаточно просто создать запись в таблице lifesms - нужно запустить модуль ядра lifesms, который сканирует данную таблицу и связывается с сервером Lifecell.

==Напоминание о списаниях==
Это модуль ядра remindsms. Он периодически вычисляет: приведет ли ближайшее списание абонплаты к отрицательному балансу и если так - записывает соответствующее сообщение в базу данных turbosms или lifesms. 

===Отправка смс о предстоящем списании только по подписке===
Можно отправлять смс о предстоящем списании только если у абонента подключена дополнительная услуга с тегом remindsms. Таким образом у абонента может быть платная подписка на напоминания. А может быть и бесплатная (стоимость 0.001 аналог нулевой стоимости), тогда абоненты сами смогут выбирать нужны ли им смс или нет.

==Модули ядра==
* Если вы ходите отправлять смс через lifesms, вам нужно запускать модуль ядра lifesms
* Если вы хотите использовать напоминания о списаниях, вам нужно запускать модуль ядра remindsms.

==Номер телефона==

Номер телефона должен храниться в допполе с именем _adr_telefon дополнительных данных абонента. Это поле строковое и не фиксирует формат. То есть сотрудник может внести номер как: 067-11-22-333 / 0931122333 / +38097112233 или несколько номеров через запятую. Смс провайдер скорее всего будет требовать фиксированный формат номера, поэтому в настройках биллинга в разделе sms присутствует параметр "Код, который корректирует номер телефона".  В этом поле необходимо записать perl-код,  который будет преобразовывать телефон в формат, понятный смс-провайдеру. К сожалению, perl-код несколько труден для понимания, поэтому приведем несколько примеров:

<pre>
my $phone = $_;
$phone =~ s/^\s*//;
$phone =~ s/^\+//;
$phone =~ s/[^\d\-\(\)].*$//;
$phone =~ s/\D//g;
$phone =~ s/^3?8//g;
length($phone) == 10 or return '';
$phone =~ /^0/ or return '';
return '+38'.$phone;
</pre>

Допустим, в поле  _adr_telefon задано 2 телефона абонента:  ' +38(067)-123-44-55, 7888080'

Построчно расшифруем код, преобразующий номер телефона, и результат после каждой строчки кода:

<pre>
my $phone = $_;                     # эту строчку не меняйте, в ней мы указываем, что телефон будет в переменной $phone
$phone =~ s/^\s*//;                 # убираем пробелы, которые оператор мог случайно ввести перед номером телефона
                                    # получаем '+38(067)-123-44-55, 7888080'
$phone =~ s/^\+//;                  # убираем символ "плюс" перед номером телефона. Даже если в результате нам понадобится
                                    # префикс +380, оператор может ввести телефон как +380xxx, как 380xxx и как 0xxx.
                                    # получаем '38(067)-123-44-55, 7888080'
$phone =~ s/[^\d\-\(\)].*$//;       # удаляем 2й телефон. Получаем '38(067)-123-44-55'
$phone =~ s/\D//g;                  # удаляем не цифры. Получаем '380671234455'
$phone =~ s/^3?8//g;                # удаляем 3 или 38. Получаем '0671234455'
length($phone) == 10 or return '';  # если телефон состоит не из 10 цифр - считаем, что он некорректен
$phone =~ /^0/ or return '';        # если телефон начинается не на ноль - некорректен
return '+38'.$phone;                # возвращаем '+380671234455'
</pre>