linkOverview
linkFeatures
linkGeneral information
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.
linkCompatibility
Available add-on version | CS-Cart/Multi-Vendor compatible versions |
---|---|
v2.0.2 |
4.12.1 – 4.17.2 |
v1.9.0 |
4.10.1 – 4.11.5 |
Add-on is compatible with the following Themes:
- YoupiTheme (compatible with correspond CS-Cart version);
- UniTheme2 (compatible with correspond CS-Cart version);
- Responsive.
linkSupport
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:
- Log in with your order owner account on https://cs-cart.alexbranding.com;
- Go to the page My Account → Orders;
- Find the corresponding order with the problem add-on in the orders list and pass to its details;
- Find the “Support” link next to the corresponding add-on name (near you can find Documentation link also) and click on it;
- 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);
- 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.
link Demo
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.
linkRestrictions and warnings
We recommend to note general restrictions:
- 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;
- Addon files may have a closed (encoded) part, in which only a license check is located;
- 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;
- 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.
linkUsage
linkInstallation
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).
linkSettings
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.
linkGeneral
link2. Test mode
link1. Admin phone
link2. Low balance
linkSMS-fly
link1. Login
link2. Password
link3. Alphaname
linkTurboSMS
link1. Login
link2. Password
link3. Alphaname
linkОбщие настройки
Для начала работы вам необходимо зарегистрироваться на сайте одного из SMS-шлюзов. Далее, в настройках модуля выберите шлюз (на котором Вы зарегистрировались):
Во вкладке этого шлюза заполните поля данными, полученными при регистрации.
Для использования шлюза SMS-Fly заполните настройки из вкладки SMS-Fly.
Для использования шлюза TurboSMS заполните настройки из вкладки TurboSMS.
linkУведомление администратора [CLONE]
Для уведомления администратора о новых заказах, обратных звонках или низком балансе счета заполните соответствующие поля во вкладке Уведомления администратора в настройках модуля.
Текст отправляемых сообщений можно изменить на странице редактирования переводов Административная панель → Администрирование → Текст и языки → Редактировать тексты. Чтобы отобразить все переменные выполните поиск по 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]
- имя и фамилия пользователя.
linkУведомление продавца (только мультивендор) [CLONE]
Для уведомления продавца о новых заказах и обратных звонках заполните соответствующие поля во вкладке Уведомления продавца в настройках модуля.
Текст отправляемых сообщений можно изменить на странице редактирования переводов Административная панель → Администрирование → Текст и языки → Редактировать тексты. Чтобы отобразить все переменные выполните поиск по 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]
- имя и фамилия пользователя
linkТестирование отправки сообщений
Увидеть остаток на счету в выбранном Вами SMS-шлюзе вы можете на странице Административная панель → АВ:Модули → АВ: Расширенные SMS уведомления → Тестирование.
Для тестирования отправки SMS-уведомления о статусе заказа перейдите на страницу Административная панель → Администрирование → Статусы → Статусы заказов и выберите в меню шестеренки нужного статуса заказа AB: Отправить тестовое SMS . Сообщение с установленным в настройках статуса текстом будет отправлено на номер администратора (указанный в настройках модуля). Так как при тестировании данных по заказу не существует, текст будет отправлятся как есть (без замены плейсходеров на какие-либо данные).
Для тестирования отправки SMS-уведомления о создании отгрузки перейдите на страницу Административная панель → Администрирование → Доставки и налоги → Способы доставки и выберите в меню шестеренки нужного способа доставки AB: Отправить тестовое SMS . Сообщение с установленным в настройках статуса текстом будет отправлено на номер администратора (указанный в настройках модуля). Так как при тестировании данных по заказу не существует, текст будет отправлятся как есть (без замены плейсходеров на какие-либо данные).
linkДополнительная информация
Модуль добавляет опции Просмотр настроек, Изменение настроек и Отправка SMS в права пользователей:
- Просмотр настроек разрешает просматривать настройки уведомлений на страницах редактирования статусов заказов и способов доставок;
- Изменение настроек позволяет редактировать эти данные;
- Отправка SMS разрешает отправлять все виды сообщений (тестовые, при смене статуса, при создании отгрузки и т.д.). Если администратору не разрешена отправка SMS, то сообщение не отправится ни при каких действиях и настройках сайта.
linkIntegrations
- Extended SMS notifications (for Ukraine only)Максимальная версия: 1.10.2
- Hide real order id
Добавлен новый плейсхолдер в шаблоне SMS уведомлений [ab__hoi_mask_id], который выступает в роли подстановочного номера заказа и, в тоже время, скрывает номер заказа.
- Extended SMS notifications (for Ukraine only)Минимальная версия: 2.0.0
- Hide real order id
Добавлена новая переменная в шаблоне SMS уведомлений ab__hoi_mask_id
, которая выступает в роли подстановочного номера заказа и, в тоже время, скрывает номер заказа. Чтобы заменить номер заказа на подстановочный, перейдите в шаблон соответствующего SMS уведомления и замените order_info.order_id
на переменную order_info.ab__hoi_mask_id
.
Дополнительные настройки модуля позволяют заблокировать отправку на момент создания отгрузки (так как пока не создана электронная накладная нет и номера ТТН для отправки) и отправить сообщение пользователю непосредственно после создания ЭН и получения номера отслеживания.
- Extended SMS notifications (for Ukraine only)Максимальная версия: 1.10.2
- Nova Poshta PRO
Дополнительные настройки модуля позволяют заблокировать отправку на момент создания отгрузки (так как пока не создана электронная накладная нет и номера ТТН для отправки) и отправить сообщение пользователю непосредственно после создания ЭН и получения номера отслеживания.
- Extended SMS notifications (for Ukraine only)Минимальная версия: 2.0.0
- CS-Cart and Checkbox.ua integrationМинимальная версия: 1.1.0
Интеграция с модулем Extended SMS notifications (for Ukraine only) предоставляет возможность отправлять SMS уведомления покупателям при отправке чека. При этом Вы можете изменять шаблон SMS уведомления и, при необходимости, выключить его отправку.
Чтобы перейти к управлению шаблоном SMS уведомления, перейдите на страницу Панель администратора → Администрирование → Уведомления → Уведомления для покупателей и выберите шаблон AB: Отправка чека. Перейдите во вкладку По SMS и внесите желаемые изменения.
- Extended SMS notifications (for Ukraine only)Максимальная версия: 1.10.2
- Ukrposhta
Дополнительные настройки модуля позволяют заблокировать отправку на момент создания отгрузки (так как пока не создана электронная накладная нет и номера ТТН для отправки) и отправить сообщение пользователю непосредственно после создания ЭН и получения номера отслеживания.
linkHow to update
AB: Add-ons Manager will notify you about available updates (you will see an indicator of new alerts). The recommended way is to update via the CS-Cart Upgrade center (a regular procedure of the platform). This method will allow lossless configuration of the transition to the new add-on version, that is guaranteed to be compatible with your CS-Cart platform version.
To make updates procedure:
- Go to the Administration panel → Administration → Upgrade center;
- Find the appropriate update among the available updates and click the Update button;
- Follow all the instructions, that will be shown during the upgrade procedure;
- Clear CS-Cart cache and start using new add-on version.
linkFAQ
linkList of releases
Subscribe to our Telegram-channel to get info about new releases.
v2.0.2 from 13 January 2022
Bug fixes:
[!] On the editing template page of SMS notification about change of order status, there was a wrong variable {{ order_info.tracking_number }} in the variable list. It has been changed on {{ tracking_numbers }}.
v2.0.1 from 20 December 2021
Bug fixes:
[!] On SMS send or balance check an error has been occurred. Fixed.
v2.0.0 from 20 December 2021
New features and improvements:
[+] Added transport for SMS sending that gives an opportunity to manage SMS patterns (edit, export, import, recover), as well as switch on/off message sending covering specific events. Setting is located on the page “Administration → Notifications → Notifications for administrator/user/vendor”.
[+] Added add-on page "SMS templates" that allows to get to notification templates rapidly, as well as export and import SMS notifications.
Functionality changes:
[*] Removed add-on settings “New order” and “Request call” from section “Admin notifications”, section “User notifications” and section “Vendor notifications”.
[*] Removed settings from editing page of order statuses and shipping methods. Parameters management of notifications were removed to User notifications (Administration - Notifications).
[*] Removed checkbox of sending prohibition. Now sending is managed with standard notification checkboxes when changing order status.
[*] "AB: Hide real order ID" add-on. Changed variable [ab__hoi_mask_id] on order_info.ab__hoi_mask_id
that allows to change order number on permutational one.
v1.10.2 from 29 April 2021
Tables with SMS settings of order statuses were changed. Check corresponding data after the update, please.
Bug fixes:
[!] After updating the add-on from version 1.9.0, SMS patterns for order statuses could save not always properly. Fixed.
v1.10.1 from 17 April 2021
New features and improvements:
[+] Added Ukrainian language support.
Bug fixes:
[!] The [tracking_number] wasn't substituting on change status message send. Fixed.
[!] Ultimate edition. On shipment create SMS sending, the sending was by settings from default storefront. Fixed.
v1.10.0 from 12 January 2021
New features and improvements:
[+] Added compatibility with CS-Cart 4.12.1.
[+] Added placeholder of tracking number of shipment [tracking_number] for SMS templates of order's status change.
Functionality changes:
[*] Updated users’ privileges.
[*] From the editing status window removed deprecated button of applying changes of SMS settings for all storefronts.
[*] Removed links of sending test SMS on changing order status and shipment creating.
v1.9.0 from 18 November 2019
New features and improvements:
[+] Added placeholders substitution with demo-data for sending test SMS for order statuses or shipping methods.
[+] Added setting Test mode
.
Functionality changes:
[*] For Multivendor edition. Addon setting Vendor phone
was removed. Instead will be used vendor's profile field Phone
v1.8.0 from 29 October 2019
New features and improvements:
[+] For message templates added placeholders: [currency]
, [converted_sum]
, [converted_currency]
.
Functionality changes:
[*] Value of [sum]
placeholder was converted to customer currency.
Исправления ошибок:
[!] For Multivendor edition, administrator couldn't send test SMS for order status without vendor choose. Fixed.
v1.7.1 from 27 May 2019
Feature additions:
[+] Added hooks for extending placeholders for sms patterns;
[+] Added UpgradeCenter/Connector for the next updates;
Bug fixes:
[!] Fixed multivendor status saving;
v1.6 from 23 Jule 2018
https://cs-cart.alexbranding.com/en/ab__extended_sms_notifications.doc
v1.5 from 16 February 2018
https://cs-cart.alexbranding.com/en/ab__extended_sms_notifications.doc
v1.4 from 29 December 2017
https://cs-cart.alexbranding.com/en/ab__extended_sms_notifications.doc
v1.3 from 30 September 2017
https://cs-cart.alexbranding.com/ru/ab__extended_sms_notifications.doc
v1.2 from 26 September 2017
https://cs-cart.alexbranding.com/ru/ab__extended_sms_notifications.doc
v1.2 от 26 сентября 2017
- добавлены права пользователей;
v1.1 от 10 марта 2017
- добавлен хук-валидатор в функцию отправки SMS присоздании отгрузки;
~ исправление работы шлюза TurboSMS;
~ убрана настройка модуля уведомления пользователя о создании отрузки. Теперь уведомления регулируются исключительно настройками способа доставки;v1.1 from 12 March 2017
v1.1 March 10, 2017
- added hook-validator to the send SMS on shipment create
~ fixed TurboSMS gateway
~ removed addon setting for customer notification on shipment create. Now only shipping settings controls itv1.0 from 11 February 2017