link"Extended SMS notifications (for Ukraine only)" documentation

The addon allows to configure the automatic SMS sending to clients, administrators and sellers at different events: placing an order, changing the order status, delivery creation, call request, etc. Has very flexible delivery conditions setup and messages texts.
The addon works with SMS-fly, TurboSMS gateways. In future versions it can be expanded to work with any other SMS gateways providing API.

Add-on is compatible with the following Themes:

• YoupiTheme (compatible with correspond CS-Cart version);
• UniTheme2 (compatible with correspond CS-Cart version);
• Responsive.

General technical support conditions are available at this link (be sure to review these conditions, all solutions from the AlexBranding development team come with limited technical support).

In order to use our technical support, you need to:

1. Log in with your order owner account on https://cs-cart.alexbranding.com;
2. Go to the page My Account → Orders;
3. Find the corresponding order with the problem add-on in the orders list and pass to its details;
4. Find the “Support” link next to the corresponding add-on name (near you can find Documentation link also) and click on it;
5. Fill in the data with the problem, provide access to your CS-Cart installation (path to the administration panel, admin mail, admin password + FTP access) and create a ticket (after you will create the ticket, you will receive an e-mail and a special code to track the ticket in the future);
6. Wait for the specialist answer in accordance with the regulations of the technical support service and the priority of your ticket.

If you didn't receive an answer within the deadlines, according to the chosen ticket priority, send e-mail info@alexbranding.com with the ticket number, for which you did not receive an answer in time, and the team manager will solve the problem in compliance with regulations.

You can test the addon work with admin access using our demo server Demos for CS-Cart solutions from Alexbranding by choosing it in Addons list or just follow the link.

We recommend to note general restrictions:

1. All solutions from AlexBranding developers team require pre-installation of the AB: Addons Manager service addon. It is delivered free of charge and is responsible for such services: installation, upgrades, license verifications. Excluding this service addon usage is not possible;
2. Addon files may have a closed (encoded) part, in which only a license check is located;
3. The addon will work only on those domains, that are specified in the user's license. If you try to use the solution on CS-Cart installations, whose domains are not included in the license, the addon will be automatically turned off;
4. Local installation is not possible, so that the addon works on the additional domain (subdomain), enter this domain (subdomain) in the Domain field, when ordering (or write to info@alexbranding.com) - adding technical domains for the developing or for testing is always free.

After your order has been processed by our manager, it will be transferred to Completed state, you will receive an email to your mailbox with ordered add-ons license numbers (usually it takes from 15 minutes to 8 hours depending on the day time and week day).

Then follow the steps below, which differs depending on your version of the CS-Cart platform:

You can also install the add-on with a standard installation for CS-Cart. To do this, download the appropriate archive with an add-on version compatible with your version of the CS-Cart platform.
Go to the website cs-cart.alexbranding.com, log in under the account of the order holder and go to the page My Profile → Orders → Relevant Order, go to details and you will see a list of available archives for the ordered add-on. Download the version (archive) you need and make the installation (standard for CS-Cart installation: Add-ons → Downloaded add-ons and in the gearwheel menu select Manual installation).

For access to the add-on settings you should go to the page Administration panel → Add-ons → Manage add-ons and at the add-on name in the gearwheel menu select appropriate menu item.

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

Во вкладке этого шлюза заполните поля данными, полученными при регистрации.
Для использования шлюза SMS-Fly заполните настройки из вкладки SMS-Fly.
Для использования шлюза TurboSMS заполните настройки из вкладки TurboSMS.

Для уведомления администратора о новых заказах, обратных звонках или низком балансе счета заполните соответствующие поля во вкладке Уведомления администратора в настройках модуля.

Текст отправляемых сообщений можно изменить на странице редактирования переводов Административная панель → Администрирование → Текст и языки → Редактировать тексты. Чтобы отобразить все переменные выполните поиск по ab__esn.admin_messages, измените необходимый текст и нажмите кнопку Сохранить:

Для сообщения при обратном звонке ab__esn.admin_messages.call_request доступны плейсхолдеры:

• [name] - имя пользователя;
• [phone] - номер телефона пользователя;
• [time_from] и [time_to] - желательное время звонка.

Для сообщения при низком балансе на счету ab__esn.admin_messages.low_balance доступны плейсхолдеры:

• [gateway] - название шлюза;
• [balance] - остаток на счету.

Для сообщения при новом заказе ab__esn.admin_messages.new_order доступны плейсхолдеры:

• [order_id] - номер заказа;
• [sum] - общая сумма заказа в выбранной пользователем валюте;
• [currency] - валюта выбранная пользователем;
• [converted_sum] - общая сумма заказа в основной валюте витрины;
• [converted_currency] - основная валюта витрины;
• [amount] - общее количество товаров в заказе;
• [name] - имя и фамилия пользователя.

Для уведомления продавца о новых заказах и обратных звонках заполните соответствующие поля во вкладке Уведомления продавца в настройках модуля.

Текст отправляемых сообщений можно изменить на странице редактирования переводов Административная панель → Администрирование → Текст и языки → Редактировать тексты. Чтобы отобразить все переменные выполните поиск по ab__esn.vendor_messages, измените необходимый текст и нажмите кнопку Сохранить.

Для сообщения при обратном звонке ab__esn.vendor_messages.call_request доступны плейсхолдеры:

• [name] - имя пользователя
• [phone] - номер телефона пользователя
• [time_from] и [time_to] - желательное время звонка

Для сообщения при новом заказе ab__esn.vendor_messages.new_order доступны плейсхолдеры:

• [order_id] - номер заказа
• [sum] - общая сумма заказа в выбранной пользователем валюте;
• [currency] - валюта выбранная пользователем;
• [converted_sum] - общая сумма заказа в основной валюте витрины;
• [converted_currency] - основная валюта витрины;
• [amount] - общее количество товаров в заказе
• [name] - имя и фамилия пользователя

Увидеть остаток на счету в выбранном Вами SMS-шлюзе вы можете на странице Административная панель → АВ:Модули → АВ: Расширенные SMS уведомления → Тестирование.

Для тестирования отправки SMS-уведомления о статусе заказа перейдите на страницу Административная панель → Администрирование → Статусы → Статусы заказов и выберите в меню шестеренки нужного статуса заказа AB: Отправить тестовое SMS . Сообщение с установленным в настройках статуса текстом будет отправлено на номер администратора (указанный в настройках модуля). Так как при тестировании данных по заказу не существует, текст будет отправлятся как есть (без замены плейсходеров на какие-либо данные).

Для тестирования отправки SMS-уведомления о создании отгрузки перейдите на страницу Административная панель → Администрирование → Доставки и налоги → Способы доставки и выберите в меню шестеренки нужного способа доставки AB: Отправить тестовое SMS . Сообщение с установленным в настройках статуса текстом будет отправлено на номер администратора (указанный в настройках модуля). Так как при тестировании данных по заказу не существует, текст будет отправлятся как есть (без замены плейсходеров на какие-либо данные).

Модуль добавляет опции Просмотр настроек, Изменение настроек и Отправка SMS в права пользователей:

• Просмотр настроек разрешает просматривать настройки уведомлений на страницах редактирования статусов заказов и способов доставок;
• Изменение настроек позволяет редактировать эти данные;
• Отправка SMS разрешает отправлять все виды сообщений (тестовые, при смене статуса, при создании отгрузки и т.д.). Если администратору не разрешена отправка SMS, то сообщение не отправится ни при каких действиях и настройках сайта.