WT Max bot - JoomShopping

Описание

WT Max bot - JoomShopping отправляет данные заказов интернет-магазина JoomShopping в мессенджер Max. Отправка выполняется через библиотеку и системный плагин WT Max, поэтому в самом плагине JoomShopping настраивается только момент отправки, шаблон сообщения и чат получателя.

Что нужно перед настройкой

• Интернет-магазин на JoomShopping 5+.
• Установленная библиотека WT Max и настроенный системный плагин WT Max с токеном бота.
• Чат или канал Max, доступный боту. Его можно выбрать прямо в параметре Max chat ID для заказов. Если в плагине чат или канал не выбран - будет использоваться чат или канал по умолчанию из настроек плагина библиотеки WT Max.

Как настроить

1. Установите пакет плагина через менеджер расширений Joomla.
2. Откройте Плагины и включите JoomShopping - WT Max bot.
3. Выберите момент отправки уведомления в параметре Отправлять информацию о новых заказах.
4. Если выбран режим Смена статуса заказа, обязательно выберите целевой статус заказа. Без выбранного статуса уведомление не будет отправлено.
5. Выберите чат Max для заказов. Поле берется из WT Max и показывает чаты, которые доступны боту.
6. При необходимости измените Markdown-шаблон (подробнее о формате markdown) сообщения и шаблон одной позиции заказа.
7. Для диагностики временно включите Отладка: плагин пишет отдельный лог plg_jshopping_wtmaxbotjshopping.log.

Параметры плагина

Отправлять информацию о новых заказах

Значение: Всегда, Успешная оплата или Смена статуса заказа. Что делает: определяет событие JoomShopping, после которого будет создано сообщение в Max. Зачем: позволяет отправлять уведомления сразу после оформления заказа, только после оплаты или только на нужном этапе обработки заказа.

Статус заказа

Значение: один из статусов заказов JoomShopping. Поле показывается только при выборе режима Смена статуса заказа. Что делает: ограничивает отправку уведомления конкретным переходом заказа в выбранный статус. Зачем: удобно отправлять сообщение менеджеру только когда заказ подтвержден, оплачен, готов к отгрузке или переведен в другой рабочий статус.

Шаблон сообщения

Значение: Markdown-текст с переменными вида {{order_number}}, {{order_total_formatted}}, {{order_items}}, {{order_address}}. Что делает: собирает итоговый текст уведомления. Зачем: позволяет без правки кода изменить состав и порядок данных, которые получает менеджер в Max.

Справка по шаблону сообщения

Значение: раскрываемый HTML-блок со списком поддерживаемых свойств объекта заказа JoomShopping и вычисляемых значений плагина. Что делает: показывает доступные переменные прямо в настройках. Зачем: помогает собрать шаблон без поиска полей в базе данных или коде JoomShopping.

Шаблон позиции заказа

Значение: Markdown-текст для одной строки состава заказа, например - {{product_name}} x {{product_quantity}}: {{product_item_price_formatted}}. Что делает: применяется к каждому товару заказа, а результат подставляется в {{order_items}} основного шаблона. Зачем: состав заказа можно оформить отдельно от общего сообщения.

Справка по шаблону позиции заказа

Значение: раскрываемый HTML-блок со списком поддерживаемых свойств позиции заказа JoomShopping. Что делает: показывает переменные товара, количества, цены, атрибутов, веса, продавца и служебных полей. Зачем: упрощает настройку состава заказа в сообщении.

Max chat ID для заказов

Значение: чат Max, выбранный через поле WT Max. Что делает: задает получателя уведомлений о заказах. После сохранения WT Max показывает карточку выбранного чата, а в параметрах хранится его chat_id. Зачем: можно отправлять заказы в отдельный рабочий чат менеджеров, не меняя глобальные настройки WT Max.

Отладка

Значение: Да или Нет. Что делает: при включении пишет успешные отправки и диагностические сообщения в plg_jshopping_wtmaxbotjshopping.log; ошибки логируются отдельно для разборов проблем. Зачем: помогает быстро проверить, почему уведомление не ушло или какие данные вернул Max.

Шаблоны и данные заказа

Шорткоды называются по свойствам объекта заказа JoomShopping. Поддерживаются скалярные поля заказа и позиции заказа, а также вычисляемые значения плагина: {{order_items}}, {{order_items_count}}, {{order_address}}, {{order_billing_address}}, {{order_delivery_address}}, {{order_total_formatted}}, {{order_shipping_formatted}}, {{order_payment_name}}, {{order_shipping_name}}, {{order_status_name}} и {{product_item_price_formatted}} для строки товара.

Контроль отправки

Плагин хранит служебную запись по заказу в собственной таблице: order_id, статус отправки в Max, chat_id и message_id. Это позволяет разработчикам проверять результат отправки по базе данных и быстрее диагностировать интеграцию.