Инструкция по интеграции и использованию модуля ePochta SMS для Prestashop

Интеграция модуля с PrestaShop v 1.4

Интеграция модуля с PrestaShop v 1.5.х

Интеграция модуля с PrestaShop v 1.7

Модуль ePochta SMS для Prestashop отправляет грузополучателю номер для отслеживания груза по SMS. Протестирован на версии PrestaShop v.1.4. Установка модуля проста:

  1. Регистрация в сервисе ePochtaSMS и настройка аккаунта

Если Вы зарегистрированы в сервисе ePochta SMS - войдите в свой аккаунт и укажите в настройках:

"Активировать API 3.0" – ВКЛ


Рис.1

Если у вас еще нет аккаунта ePochta SMS, зарегистрируйте его.

  1. Загрузка, установка и настройка модуля

Скачайте файл модуля ePochta SMS и сохраните в любой папке на вашем компьютере. Закачайте zip-файл в Prestashop по стандартной процедуре установки модулей. Активируйте модуль и перейдите к настройкам.


Рис.2

В настройках введите и сохраните логин и пароль вашего аккаунта сервиса ePochta SMS.


Рис.3

Нужно открыть и отредактировать файл /admin/tabs/AdminOrders.php

Ищем текст :
$templateVars = array(
'{followup}' => str_replace('@', $order->shipping_number, $carrier->url),
'{firstname}' => $customer->firstname,
'{lastname}' => $customer->lastname,
'{id_order}' => (int)($order->id)
);
@Mail::Send((int)($order->id_lang), 'in_transit', Mail::l('Package in transit'), $templateVars,
$customer->email, $customer->firstname.' '.$customer->lastname, NULL, NULL, NULL, NULL,
_PS_MAIL_DIR_, true);

Ниже добавляем наш код :
###2w
$addressInvoice = new Address($order->id_address_delivery, (int)($cookie->id_lang));
$moduleInstance = Module::getInstanceByName('epochta2w');
if (is_callable(array($moduleInstance, 'hookSendSms'))) call_user_func(array($moduleInstance, 'hookSendSms'), array($addressInvoice->phone_mobile, $customer->firstname.' '.$customer->lastname,$order));

(Опционально) Чтобы показать поле код отслеживания при любом статусе заказа, комментируем строку:
// if ($carrier->url && $order->hasBeenShipped())
(Опционально) Чтобы разрешить обновление поля код отслеживания на любой стадии, комментируем строку:
// if (!$order->hasBeenShipped())
// die(Tools::displayError('The shipping number can only be set once the order has been shipped!'));

У вас должно быть настроено отслеживание доставки (введен адрес сайта для отслеживания).


Рис.4

Теперь при вводе номера отправления будет не только отсылаться email, но и отправляться смс на номер мобильника грузополучателя.

  1. Отправка уведомления

Открыв заказ, введите номер для отслеживания отправки (shipping number) и через несколько секунд получатель заказа получит смс (при условии, что он ввел номер мобильного при оформлении заказа).


Рис.5



Модуль ePochta SMS для Prestashop версии 1.5.x.

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

  1. Загрузка, установка и настройка модуля

Скачайте файл модуля ePochta SMS и сохраните в любой папке на вашем компьютере. Закачайте zip-файл в Prestashop по стандартной процедуре установки модулей. Активируйте модуль и перейдите к настройкам.


Рис.1

В настройках введите и сохраните логин и пароль вашего аккаунта сервиса ePochta SMS.


Рис.2

Нужно открыть и отредактировать файл /controllers/admin/AdminOrdersController.php

Ищем текст (строка 307):
if (@Mail::Send((int)$order->id_lang, 'in_transit',(
Mail::l('Package in transit', (int)$order->id_lang),
$templateVars,
$customer->email,
$customer->firstname.' '.$customer->lastname,
null, null, null, null,
_PS_MAIL_DIR_, true, (int)$order->id_shop))
{
###################сюда нужно вставить код###########################

Hook::exec('actionAdminOrdersTrackingNumberUpdate', array('order' => $order));
Tools::redirectAdmin(self::$currentIndex.'&id_order='.$order->id.'&vieworder&conf=4&token='.$this->token);
}

Вставляем наш код в указанную позицию:
###epochta2w
$addressInvoice = new Address($order->id_address_delivery);;
$customer = new Customer((int)$order->id_customer);
$sms_module = Module::getInstanceByName('epochta2w');
$sms_module->hookSendSms(array($addressInvoice->phone_mobile, $customer->firstname.' '.$customer->lastname, $order));

У вас должно быть настроено отслеживание доставки (введен адрес сайта для отслеживания).


Рис.3

Теперь при вводе номера отправления будет не только отсылаться email, но и отправляться смс на номер мобильника грузополучателя.

  1. Отправка уведомления

Открыв заказ, введите номер для отслеживания отправки (shipping number) и через несколько секунд получатель заказа получит смс (при условии, что он ввел номер мобильного при оформлении заказа).

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


Рис.4

Модуль ePochta SMS для Prestashop версии 1.7

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

  1. Загрузка, установка и настройка модуля

Скачайте файл для версии 1.7 или Скачайте файл для версии 1.7.4 модуля ePochta SMS и сохраните в любой папке на вашем компьютере. Закачайте zip-файл в Prestashop по стандартной процедуре установки модулей. Активируйте модуль и перейдите к настройкам.

управление модулем

Рис.5

В настройках введите и сохраните приватный и публичный ключи аккаунта сервиса ePochta SMS.

ключи аккаунта

Рис.6

  1. Отправка уведомления

Далее в разделе  "Отправить СМС" вы сможете создать рассылку и указать нужные параметры отправки, в том числе запланировать уведомления клиентам на нужное время. 

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

Рис.7

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

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

Рис.8

После добавления событий все правила будут доступны к просмотру и дальнейшей настройке.

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

Рис.9

  1. Личный кабинет ePochta SMS

В личном кабинете вы сможете увидеть список отправленных сообщений, пополнить баланс и воспользоваться другими услугами и программами ePochta.


Рис.10

  1. Правила задания имени отправителя, телефонных номеров, длина текста сообщения

Имя отправителя не должно быть длиннее 11 латинских букв или 11 цифр, его можно задать, отредактировав файл epochta2w.php. Обратите внимание, что для Украины, Казахстана и некоторых других стран могут действовать ограничения, подробнее о которых можно прочитать в личном кабинете.

Телефонные номера должны быть заданы в международном формате:
иметь федеральную запись вида, например, для России: 7xxxyyyyyyy, где 7 – международный код России, xxx - код оператора, yyyyyyy – номер абонента в сети соответствующего оператора; прямые мобильные номера должны быть представлены в федеральном виде; не должно присутствовать номеров городских телефонных сетей; в телефонном номере не должно быть лишних символов, например, букв.

Длина 1 смс: 70 символов в кириллице и 160 - в латинице. При превышении указанных объемов формируется несколько смс, которые автоматически склеиваются в одно сообщение. При склеивании сообщений, каждое из них становится меньше на три символа для кириллицы (67 символов вместо 70) и семь символов для латиницы (153 символа вместо 160).

Подробнее о правилах задания имени отправителя читайте в разделе Вопрос-Ответы своего аккаунта ePochta SMS.

Стоимость отправки смс сообщения через шлюз аналогична цене отправки смс из панели ePochta SMS (либо иной цене о которой была достигнута договоренность).

По запросу предоставляется необходимое количество дополнительных смс для тестирования сервиса массовых смс-уведомлений ePochta SMS.

Есть вопрос?

  • 8 (800) 555-09-63
  • Бесплатно по России

Александр



skype: alexandr.romanow26
sales@epochta.ru

Алексей



skype: aleksey.klochko1
sales@epochta.ru