msLiveInform

Описание

msLiveInform - компонент отслеживания Заказов магазина MiniShop2 при помощи сервиса LiveInform.

Особенности

• работа только с новым miniShop2 (version =>2.4.0-beta2)
• отслеживание заказов при помощи сервиса LiveInform
• сниппет для вывода информации отслеживания заказа
• проверка клиента заказа по Черному списку ненадежных клиентов при помощи сервиса LiveInform

Установка

• Подключите наш репозиторий
• Установите miniShop2 - это магазин на основе которого реализован функционал заказа c оплатой
• Установите msLiveInform

Для тестирования можно использовать наш хостинг, на нём эти дополнения можно выбрать прямо при создании сайта. После установки компонента необходимо:

• прописать ключ для доступа к АПИ сервиса LiveInform

Настройка

Все сниппеты msLiveInform работают при помощи pdoTools и рассчитывают на использование Fenom в чанках. Это позволяет:

• сократить общее количество чанков
• повысить удобство работы
• ускорить работу
• делать более сложные чанки, за счёт продвинутой проверки условий через функции Fenom

Создание отслеживания

В окне редактирования заказа MiniShop2

Нажимаем + создать отслеживание. Заполняем необходимые поля:

• трек-номер отправления
• телефон клиента

Сохраняем. Отслеживание будет синхронизировано с сервисом LiveInform. Информацию об отслеживании можно обновить тут же в админке, либо настроив скрипт на cron.

Пример скрипта синхронизации в папке core/components/msliveinform/cron/.

По умолчанию активирована настройка change_order_status - разрешающая менять статус заказа по смене статуса отслеживания. Каждому статусу отслеживания можно задать соответствующий статус заказа.

На вкладке Трекинг доступна актуальная информация о перемещении отслеживания

Вывод отслеживаний на фронте

Сниппет для вывода отслеживаний msLiveInform.tracking

Параметры

Параметр	По умолчанию	Описание
order		Идентификатор заказа. Если поставить 0 - выборка не ограничивается.
tpl	msLiveInform.tracking	Чанк оформления
limit	10	Лимит выборки результатов
sortby	id	Сортировка выборки.
sortdir	ASC	Направление сортировки

Подсказка

Можно использовать и другие общие параметры pdoTools

пример вызова отслеживаний конкретного заказа:

[[!msLiveInform.tracking?
  &order=`2`
]]

Вы можете увидеть все доступные плейсхолдеры отслеживаний просто не указывая чанк оформления:

<pre>
  [[!msLiveInform.tracking?
    &order=`2`
    &tpl=``
  ]]
</pre>

Вывод отслеживаний с постраничной разбивкой:

[[!pdoPage?
  &element=`msLiveInform.tracking`
]]
[[!+page.nav]]

Проверка по базе заказов сервиса LiveInform

Доступна проверка клиента заказа на предмет количества заказов:

• Количество возвратов
• Количество врученных заказов
• Общее число заказов

Настройки msLiveInform

Настройки msLiveInform расположены в Системные настройки > msLiveInform

Содержит основные настройки:

• api_id - Идентификатор для отправки запроса к LiveInform API
• order_id_key - Идентификатор заказа MiniShop в системе LiveInform. По умолчанию "num"
• change_order_status - Флаг разрешающий менять статус заказа по смене статуса отслеживания
• order_status_2 - Идентификатор статуса заказа соответствующий статусу "Вручен" отслеживания
• order_status_3 - Идентификатор статуса заказа соответствующий статусу "Возврат" отслеживания
• delivery_service - Список служб доставки. Доступен для выбора при создании отслеживания

Для удобства введена настройка change_order_status позволяющая автоматически менять статус заказа в зависимости от статуса отслеживания. Возможны следующие статусы отслеживания:

• 0 - в пути
• 1 - в ПВЗ
• 2 - Вручен
• 3 - Возврат

Для каждого статуса отслеживания можно создать/ указать свою настройку. Например статус отслеживания - 2 - Вручен определяется соответствующей настройкой order_status_2 Если вы новый клиент LiveInform, настройте тексты сообщений для каждой из служб доставок в разделе Настройки.

Можно отключить смену заказов по всем статусам задав настройку change_order_status в нет.

Настройка Callback

LiveInform может оповещать ваш сервер при изменении статусов заказа. Для этого нужно указать адрес скрипта, на который будут отправляться оповещения.

Пример скрипта callback http://site.ru/assets/components/msliveinform/callback.php.