# MODX + miniShop2

ChatRex получает опубликованные товары miniShop2 и помогает боту отвечать на вопросы о товарах, ценах, наличии и ссылках на витрину. Подключение работает только на чтение: заказы, данные покупателей и платежи не передаются, товары в MODX не изменяются.

• Требуются MODX Revolution 2.8.9 или другая версия 2.x, miniShop2 4.4.2-pl или новее в ветке 4.x, PHP 8.1+ и расширение cURL. MODX 3 / MiniShop3 этой версией дополнения не поддерживаются. Проверьте установленную версию miniShop2 до установки ChatRex: версия 4.4.2-pl опубликована в каталоге modstore, а в MODX Extras может предлагаться более старая версия.
• Магазину нужен публичный HTTPS-адрес и исходящий HTTPS-доступ к app.chatrex.pro. В адресе не должно быть логина, параметров запроса или фрагмента.
• Дополнение в MODX Extras бесплатно. Для работы после подключения нужна отдельная подписка ChatRex на интеграцию MODX Commerce.
• Перед установкой или обновлением сохраните резервную копию сайта и базы данных MODX.

1. В панели MODX откройте Пакеты → Установщик и через Скачать дополнения найдите ChatRex Commerce Bridge. Откройте публичную карточку MODX Extras, если нужно проверить версию и совместимость.
2. Скачайте пакет из официального репозитория MODX и нажмите Установить. После установки откройте Приложения → ChatRex Commerce Bridge.
3. В полях Public storefront URL, MODX context и Currency укажите публичный HTTPS-адрес магазина, контекст MODX и трёхбуквенный код валюты, например RUB. Проверьте, что miniShop2 уже установлен и в выбранном контексте есть опубликованные товары. Поля компонента сейчас подписаны на английском языке.
4. В ChatRex откройте Интеграции → MODX + miniShop2 и нажмите Сгенерировать код. Код одноразовый и действует ограниченное время.
5. Вставьте код в One-time pairing code, отметьте I agree to send published product data to ChatRex и нажмите Connect. После успешного подключения в ChatRex появится статус Подключено.
6. В компоненте MODX нажмите Sync now. Дождитесь результата и проверьте, что количество отправленных товаров соответствует опубликованному каталогу.

Если код истёк, получите новый в ChatRex и повторите шаг подключения. Код нельзя использовать повторно.

Для автоматической отправки изменений настройте запуск обработчика дополнения каждые пять минут. Замените путь к PHP и корню MODX на пути своего сервера:

*/5 * * * * /usr/bin/php /path/to/modx/core/components/chatrexcommercebridge/cron.php

При временной сетевой ошибке задание остаётся в очереди и повторяется. Кнопка Sync now запускает полную сверку вручную.

В редакторе бота добавьте нужные действия MODX Commerce и выберите подключённый магазин:

Задайте боту вопрос о тестовом товаре и сверьте ответ с витриной. Измените цену или остаток тестового товара в MODX, дождитесь синхронизации и повторите вопрос. Если учёт остатков в магазине выключен, не обещайте покупателю точное количество.

Дополнение синхронизирует каталог; чат-виджет на сайт оно не устанавливает. Чтобы показывать чат посетителям, отдельно подключите Online Chat и добавьте домен магазина в разрешённые.

В компоненте MODX нажмите Disconnect, когда сервис ChatRex доступен. Это отзывает подключение и прекращает синхронизацию. Затем при необходимости удалите дополнение через Пакеты → Установщик. Товары и заказы miniShop2 сохраняются. Для повторного подключения получите новый одноразовый код.

Если подключение не проходит, проверьте версии MODX и miniShop2, HTTPS-адрес, выбранный контекст, валюту, cURL и исходящий доступ к ChatRex. Помощь: support@chatrex.pro.