Документация Шлюзы SMS сообщений

Документация

Лицензионный ключ отправляется автоматически на почту аккаунта покупателя, если письма Вы не нашли, проверьте папку спам, если письмо в спаме, то пожалуйста поставьте отметку не спам. При отсутствии ключа в папке спам напишите в поддержку. Подробная информация о получении файлов и ключа по ссылке.

 

Установка:

1. Разархивируйте архив
2. В админ панели сайта меню Дополнения - Установка дополнений - Загрузите архив artservsms.ocmod.zip
3. Меню Менеджер дополнений (Модификации) - обновите кэш модификаций
4. Установите модуль в разделе Админ панель - Дополнения - Модули - ART&PR Шлюзы SMS сообщений(при отсутвии данного модуля в меню воспользуйтесь установкой вручную описанной ниже)
5. Зайдите в настройки модуля (ссылка Изменить)
6. Введите настройки. (Если Вы не получили лицензионный ключ, то запросите его по ссылке).
7. Включить модуль (статус включено). Сохранить настройки.
8. Для магазинов 3.0 Очистите кеш шаблонов (главная страница админ панели -> шестеренка справа вверху)

Установка вручную:

1. Разархивируйте архив
2. Разархивируйте архив artservsms.ocmod.zip, внутри папка upload и файл install.xml
3. С помощью файлового доступа к сайту (ftp или ssh) загрузите все содержимое папки upload в корень сайта
4. Для магазинов 2.0-2.1 Переименуйте install.xml в artservsms.ocmod.xml
5. В админ панели сайта меню Дополнения - Установка дополнений - Загрузите файл artservsms.ocmod.xml
6. Меню Менеджер дополнений (Модификации) - обновите кэш модификаций
7. Установите модуль в разделе Админ панель - Дополнения - Модули - ART&PR Шлюзы SMS сообщений (ВНИМАНИЕ! отсутствие данного пункта может быть свзяно с отсутвием языка модуля, копируйте папку языка из архива в свою папку языка, либо вы произвели копирование файлов не корректно)
8. Зайдите в настройки модуля (ссылка Изменить)
9. Введите настройки. (Если Вы не получили лицензионный ключ, то запросите его по ссылке)
10. Включить модуль (статус включено). Сохранить настройки.
11. Для магазинов 3.0 Очистите кеш шаблонов (главная страница админ панели -> шестеренка справа вверху)

 

Обновление на новую версию:

1. Создайте резервную копию базы данных и файлов сайта
2. Для магазинов 2.0-2.1 Удалите модификатор модуля
3. Установите модуль согласно инструкции УСТАНОВКА выше с перезаписью файлов (не забудте обновить модификаторы и кеш шаблона)
4. Внимание! Обязательно пересохраните настройки.

 

Инструкция по работе:

 

1. При смене статуса или создания заказа отправляется сообщение созданное Вами в настройках модуля
2. Вы можете использовать разные сообщения для разных статусов а также в зависимости от Нового заказа или смены статуса уже созданного заказа.
3. В настройках модуля добавьте нужное сообщение нажатием на кнопку "карандаш", введите текст, сохраните настройки.
4. В тексте комментариев Вы можете использовать переменные из заказа указанные ниже в разделе Переменные.

Не работает отправка сообщения:

Включите режим отладки в настройках модуля (Отладка - да)
Смените статус у заказа на тот для которого настроены уведомления
Смотрите журнал ошибок магазина на предмет записи artservsms Debug:

 

Использование шаблонов с сылками на оплату:

Функционал доступен только для магазинов 2.3 и 3.0.
Теперь вы можете использовать ссылки на оплату для формирования шаблона с использованием переменной ~paylink~
эта переменная работает только когда в заказе установлен метод оплаты ART&PR с возможностью генерации ссылок.

 

Переменные и использование полей из Simple:

Свои поля стандартного оформления заказа

Расположение Адрес оплаты
~payAddrCustom_IDПОЛЯ~

Расположение Адрес доставки
~shipAddrCustom_IDПОЛЯ~

Расположение Аккаунт
~accCustom_IDПОЛЯ~

ID поля можно найти в адресной строке браузера при редактировании поля.

 

Свои поля simple

ID поля берется из вкладки "Настройка полей"

Для Simple 4.x
~paymentsimple4_IDполя~ - поле привязанное к адресу оплаты
~shippingsimple4_IDполя~ - поле привязанное к адресу доставки
~simple4_IDполя~ - поле привязанное к учетной записи покупателя или поле привязанное к методу

Выбор отображения отчества покупателя
Пример: 
Отчество: ~simple4_otchestvo~

 

Сторонние модули (работает в эксперементальном режиме):

Трек-номер заказа (toporchillo):
переменная ~track_no~ - добавляет номер накладной при условии что он существует в заказе.

 

Перемененная ~status_comment~ добавляет текст комментария из данного обновления статуса (например модули оплаты добавляют свои комментарии или вы вручную вписали текст комментария через просмотр заказа и добавление истории, или модули доставки которые меняют статус и добавляют в комментарий трек номер, теперь эти данные можно отправить в sms)

Также доступны переменные:
~order_id~ - номер заказа
~totals~ - итого заказа в валюте заказа
~products~ состав заказа
~dateNumOrder~ - дата заказа в формате 20.12.2021
~status_update~ - имя статуса на который происходит смена
~invoice_no~ - номер счета 
~invoice_prefix~ - префикс счета 
~store_id~ - id магазина 
~store_name~ - название магазина 
~store_url~ - url магазина 
~customer_id~ - id покупателя 
~customer_group_id~ - id группы покупателя
~fax~ - факс 
~email~ - почта 
~payment_firstname~ - имя плательщика 
~payment_lastname~ - фамилия плательщика 
~payment_company~ - компания плательщика 
~payment_address_1~ - адрес плательщика 
~payment_address_2~ - адрес2 плательщика 
~payment_postcode~ - индекс плательщика 
~payment_city~ - город плательщика 
~payment_zone_id~ - id гео зоны плательщика 
~payment_zone~ - гео зона плательщика 
~payment_zone_code~ - код зоны плательщика 
~payment_country_id~ - id страны плательщика 
~payment_country~ - страна плательщика 
~payment_iso_code_2~ - iso код плательщика 
~payment_iso_code_3~ - iso код плательщика 
~payment_address_format~ - формат адреса плательщика 
~payment_method~ - метод оплаты 
~payment_code~ - код оплаты    
~shipping_firstname~ - имя для доставки 
~shipping_lastname~ - фамилия для доставки 
~shipping_company~ - компания для доставки 
~shipping_address_1~ - адрес доставки 
~shipping_address_2~ - адрес2 доставки 
~shipping_postcode~ - индекс для доставки 
~shipping_city~ - город доставки 
~shipping_zone_id~ - id гео зоны доставки 
~shipping_zone~ - гео зона доставки 
~shipping_zone_code~ - код зоны доставки 
~shipping_country_id~ - id страны доставки 
~shipping_country~ - страна доставки 
~shipping_iso_code_2~ - iso код доставки 
~shipping_iso_code_3~ - iso код доставки 
~shipping_address_format~ - формат адреса доставки 
~shipping_method~ - метод доставки 
~shipping_code~ - код метода доставки 
~comment~ - комментарий 
~total~ - итого (из базы данных) 
~order_status_id~ - id статуса заказа 
~order_status~ - статус заказа зи базы данных (предыдущий статус)
~language_id~ - id языка 
~language_code~ - код языка 
~language_filename~ - файл языка 
~language_directory~ - дирректория языка 
~currency_id~ - id валюты 
~currency_code~ - код валюты 
~currency_value~ - курс валюты 
~ip~ - ip 
~forwarded_ip~ - переадресованный ip 
~user_agent~ - юзер агент 
~accept_language~ - язык 
~date_modified~ - дата изменения заказа 
~date_added~ - дата создания заказа

 

Использование из сторонних модулей:
Вызвать модель модуля можно из сторонних модулей, это позволит отправить сообщение указав текст и номер телефона (код страны обязателен) .
$this->load->model(extension/module/artservsms);
$this->model_extension_module_artservsms->startWaMessager('text', 'phone')