Модуль SMS уведомлений для Netcat

Установка модуля

Описание модуля.

Модуль предназначен для SMS уведомлений администраторов и покупателей сайта о статусе заказов.

    Обрабатываемые события:
  • Новый заказ
  • Оплата заказа
  • Отмена заказа
  • Изменение статуса заказа

SMS-уведомления, формируются по настраиваемым шаблонам отдельно для пользователей магазина и администратора.

Модуль покрывает большинство редакций NetCat, а не только Business(и старшие), в которых присутствует функционал интернет-магазина. Текущая реализация модуля позволяет реализовать смс-рассылку для любых редакций в которых есть компонент «Заказа».

Единственная проблема заключается в том, что если это не Business+редакция, то интегрировать с кастомным каталогом товаров и кастомной разработкой для хранения заказанных продуктов (и их цен) –сложная и проблематичная задача, поэтому для младших редакций с кастомными компонентами Заказа в смс-рассылках НЕ отсылается список заказанных продуктов, отсылается лишь базовая информация: номер заказа, информация по клиенту, статус заказа.

Начальная настройка модуля

Доступ к настройкам модуля можно получить перейдя в меню Настройка – InCore Dev: SMS уведомления. Откроется главный экран настроек.

Вам необходимо задать все настройки, чтобы модуль начал функционировать.

SMSGATE_CATALOGUE_ID - ID сайта магазина

SMSGATE_ORDER_SUB_ID - ID раздела с заказами

SMSGATE_ORDER_COMPONENT_ID - ID компонента с заказами

SMSGATE_CLIENT_FIO_FIELD_NAME - наименование поля с именем клиента

SMSGATE_CLIENT_PHONE_FIELD_NAME - наименование поля с телефоном клиента

SMSGATE_CLIENT_EMAIL_FIELD_NAME - наименование поля с e-mail-ом клиента

SMSGATE_CLIENT_ADDRESS_FIELD_NAME - наименование поля с адресом доставки клиенту

SMSGATE_ORDER_STATUS_FIELD_NAME - наименование поля со статусами в компоненте заказов

SMSGATE_ORDER_PAYED_STATUS_NAME - значение поля статус для оплаченного заказа

SMSGATE_CANCELED_STATUS_NAME - значение поля статус для отмененного заказа

SMSGATE_PRODUCT_NAME_FIELD_NAME - наименование поля с наименованием продукта в инфоблоке каталога (продукции)

SMSGATE_INCORE_SERVER_NAME - адрес сервера для отправки XML запросов (возможны варианты netcat4.incore1.ru или netcat5.incore1.ru)

SMSGATE_INCORE_USERNAME - логин полученный при регистрации

SMSGATE_INCORE_PASSWORD - пароль полученный при регистрации

SMSGATE_INCORE_SENDER_NAME - имя отправителя (уточняйте у своего менеджера)

SMSGATE_ADMIN_PHONE - телефон администратора в формате 79101234567

Настройки уведомлений

После основных настроек пользователь щелкает на ссылку сверху (вкладку) InCore Dev: SMS-уведомления и попадает на экран непосредственных настроек SMS рассылок.

Там идут шаблоны смс. Для каждого типа события по два шаблона на каждый (шаблон для админа и шаблон для пользователя). Каждый шаблон имеет чекбокс, по клику на который пользователь может либо включить его, либо отключить. SMS рассылка происходит только по включенным (активным) шаблонам.

Допускается в шаблонах писать любой текст, а так же использовать динамические «переменные», которые уже должны быть привычны пользователям NetCatпо различным моментам, по типу настраиваемых шаблонах писем и пр. Модуль поддерживает следующий список переменных для любого из событий рассылки.

Разрешенные к использованию переменныев шаблоне:

%INCORE_SHOP_NAME% - наименование магазина из настроек CMS

%INCORE_ORDER_ID% -ID заказа

%INCORE_STATUS% - статус заказа

%INCORE_CLIENT_NAME% - имя клиента

%INCORE_CLIENT_PHONE% - телефон клиента

%INCORE_CLIENT_EMAIL% - E-mail клиента

%INCORE_CLIENT_ADDRESS% - Адрес клиента

%INCORE_ORDERED_PRODUCTS% - заказанные товары. Только для редакций Business и старше.

Таким образом, если у пользователя Business+редакция и он хочет в смс рассылку включить список продуктов заказанных пользователем, он просто пишет в шаблоне в нужном месте

%INCORE_ORDERED_PRODUCTS% - система это понимает и при отсылке смс подставит в это место список товаров в формате:
Наименование товара 1 – Кол-во Шт. – Стоимость
...
Наименование товара N – Кол-во Шт. – Стоимость
Итого: общая стоимость заказа

После настроек шаблонов пользователь сохраняет все сделанное им и система готова к работе.

Дополнительные функции

Кроме всего прочего модуль ведет лог внутри своей папки на сервере всех отосланных на сервер данных в формате XMLи полученных от сервера на этот запрос ответов, с указанием точной даты и времени и типа события.

После полной настройки модуля можно реализовать отправку SMS сообщений из любого места в системе. Для того, чтобы иметь возможность отослать на тот или иной номер SMS сообщение с произвольным текстом, осуществите вызов функции incore_send_sms, принимающей два параметра: мобильный номер адресата и текст в произвольном формате. Пример использования функции (которую можно вызывать в макетах дизайна, шаблонах компонента и в ваших собственных обработчиках и пр. модулях системы NetCat) ниже:

<?php 
incore_send_sms("79871233222", "Текст, который будет отправлен в sms на номер в первом параметре.");
?>