MaxNotify

**MaxNotify** — компонент для MODX Revolution 2, который отправляет сведения
о заказах miniShop2 в мессенджер MAX через официальный MAX Business API или через сервис (https://rumaxbot.ru).

Компонент помогает владельцу и менеджерам интернет-магазина быстро узнавать
о новых заказах и изменениях их статуса без постоянной проверки панели MODX.


## Возможности

— уведомление сразу после создания заказа miniShop2;
— уведомление при изменении статуса заказа;
— фильтрация уведомлений по ID статусов;
— номер, сумма и состав заказа;
— имя, телефон и email покупателя;
— адрес доставки и комментарий клиента;
— название способа доставки и оплаты;
— ссылка на конкретный заказ в панели MODX;
— официальный MAX Business API и сервис rumaxbot.ru на выбор;
— отправка одному или нескольким чатам, каналам или пользователям;
— сообщения в формате Markdown или HTML;
— редактируемые чанки сообщений;
— запись ошибок API и соединения в журнал MODX.

## Требования

— MODX Revolution 2.8+;
— miniShop2 2.x+;
— PHP 7.2+;
— PHP cURL или включённый `allow_url_fopen`;
— токен официального MAX-бота или канал и API-ключ rumaxbot.ru.

Компонент проверен с MODX Revolution 2.8.8-pl и miniShop2 4.4.2-pl.

## Установка

1. Откройте в MODX раздел **Пакеты → Установщик**.
2. Найдите компонент **MaxNotify** в репозитории.
3. Нажмите **Скачать**, затем **Установить**.
4. После установки очистите кэш MODX.

## Настройка

Откройте **Системные настройки** и выберите пространство имён `maxnotify`.

Основные параметры:

Основные параметры:

— maxnotify.enabled — включает или отключает компонент;
— maxnotify.provider — rumaxbot или maxbusiness;
— maxnotify.format — формат markdown или html;
— maxnotify.timeout — таймаут API-запроса в секундах;
— maxnotify.notify_new_order — уведомления о новых заказах;
— maxnotify.notify_status_change — уведомления о смене статуса;
— maxnotify.statuses — ID статусов через запятую, пустое поле разрешает все.

## Подключение официального MAX Business API

Официальное подключение доступно верифицированным организациям и ИП, которые являются резидентами РФ.

Создайте и верифицируйте профиль на платформе MAX для партнёров.
Создайте чат-бота и дождитесь прохождения модерации.
Получите токен в разделе Чат-боты → Перейти → Расширенные настройки → Настроить.
Добавьте бота в нужный чат или канал либо запустите личный диалог с ботом.
Получите chat_id или user_id черезWebhook/Long Polling API MAX.
Установите maxnotify.provider в значение maxbusiness.

Заполните настройки:

— maxnotify.max_token — токен бота;
— maxnotify.max_recipient_type — chat_id или user_id;
— maxnotify.max_recipient_ids — один или несколько ID через запятую;
— maxnotify.max_notify — уведомлять участников чата;
— maxnotify.max_disable_link_preview — отключить превью ссылок.

Официальный API принимает сообщения длиной до 4000 символов. Более длинные уведомления MaxNotify автоматически сокращает.

## Подключение rumaxbot.ru

1. Зарегистрируйтесь на rumaxbot.ru и подтвердите email.
2. Создайте канал.
3. Подключите MAX-бота к каналу по инструкции сервиса.
4. Создайте API-ключ канала.
5. Укажите ключ в настройке `maxnotify.api_key`.

API-ключ нельзя публиковать или добавлять в репозиторий.

## Шаблоны сообщений

После установки в категории элементов `MaxNotify` будут созданы чанки:

— `maxNotifyOrderCreated` — новый заказ в Markdown;
— `maxNotifyOrderStatus` — новый статус в Markdown;
— `maxNotifyOrderCreatedHtml` — новый заказ в HTML;
— `maxNotifyOrderStatusHtml` — новый статус в HTML.

Доступные плейсхолдеры: `num`, `cost`, `receiver`, `phone`, `email`,
`address`, `comment`, `order_comment`, `products`, `delivery_name`,
`payment_name`, `status_name`, `manager_url` и другие поля заказа.
PS… Это мой первый компонент не пинайте жестко. Есть в планах сделать и обычное подключение через business.max.ru