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

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

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

Если Вы зарегистрированы в сервисе ePochtaSMS - войдите в свой аккаунт и укажите в настройках
"Включить XML интерфейс" - да
"Режим XML интерфейса" - Рабочий

Рис.1

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

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

Скачайте файл модуля 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, но и отправляться смс на номер мобильника грузополучателя.

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

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

Рис.5

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

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

Рис.6

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

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

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

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

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