# Подключение Moguta.CMS

ChatRex находит опубликованные товары Moguta.CMS, получает карточки и варианты, проверяет наличие и возвращает ссылки на витрину. Интеграция читает каталог: она не создаёт заказы, не меняет товары и не получает пароль администратора.

# Перед подключением

Используйте модуль ChatRex 1.0.7. Эта инструкция рассчитана на Moguta.CMS 13.1.1 «Гипермаркет» с PHP 8.1. Другие версии и редакции требуют отдельной проверки. Нужны действующая лицензия Moguta.CMS, доступ администратора к установке плагинов, опубликованные товары и магазин, доступный по HTTPS. На сервере должны работать PDO MySQL, OpenSSL, mbstring и cURL.

Магазин может находиться в корне сайта или в подпапке. В настройках укажите его полный адрес, например https://shop.example/store/, сохранив подпапку.

Лицензия Moguta.CMS и подписки ChatRex оформляются отдельно. Установка модуля не предоставляет бесплатную лицензию CMS или подписку сервиса.

# Установка и подключение каталога

1. В ChatRex откройте Интеграции → Подключить интеграцию, выберите Moguta.CMS и откройте Установку соединения.
2. Нажмите Скачать модуль ChatRex для Moguta. Тот же архив ChatRex 1.0.7 доступен по прямой ссылке.
3. В административной панели Moguta.CMS откройте Плагины → Загрузить плагин и загрузите ZIP целиком. Не переименовывайте папку chatrex внутри архива.
4. Включите ChatRex — AI-консультант и откройте настройки плагина.
5. Заполните HTTPS-адрес магазина, Валюту и Язык. Для валюты нужен трёхбуквенный код, например RUB; для языка — ru или en.
6. Нажмите Получить код подключения. Скопируйте показанные Адрес подключения и Одноразовый код.
7. В ChatRex заполните Адрес подключения из модуля и Одноразовый код, затем нажмите Подключить каталог.
8. Дождитесь статуса Подключено и проверьте подписку интеграции в ChatRex.

Код действует 10 минут и используется один раз. При истечении срока получите новый код в настройках плагина. Копируйте адрес подключения полностью: для магазина в подпапке он будет выглядеть как https://shop.example/store/chatrex-catalog.

Архив устанавливается из ChatRex. Наличие этой загрузки не означает публикацию модуля в магазине плагинов Moguta.CMS.

# Обновления каталога

Передайте администратору сервера команду Cron (каждые 5 минут) из настроек плагина. Её нужно добавить в обычный планировщик сайта с интервалом пять минут. Команда доставляет уведомления об изменениях каталога и проверяет состояние подключения; карточки и наличие товаров читаются непосредственно из Moguta.CMS.

Команда содержит служебный токен. Храните её вне публичных файлов сайта и не публикуйте в переписке или документации. Проверьте, что планировщик действительно запускает команду без ошибок.

# Чат на витрине

1. В ChatRex подключите Чат на сайте и добавьте HTTPS-домен магазина в разрешённые домены этого чата.
2. В редакторе бота откройте Каналы и запуск, добавьте этот чат и сохраните изменения.
3. В подключении Moguta.CMS откройте блок Чат на сайте, выберите созданный чат и нажмите Установить виджет.
4. После подтверждения установки перезагрузите витрину и отправьте тестовое сообщение.

Модуль размещает выбранный виджет без изменения шаблона. Если на сайте уже установлен другой экземпляр того же чата, сначала уберите дублирующее размещение. При использовании CSP администратор сайта должен разрешить ресурсы виджета ChatRex.

# Проверка, обновление и отключение

Настройте действия Moguta.CMS. Проверьте ответ о реальном опубликованном товаре: название, артикул, цену, валюту, наличие выбранного варианта и открытие ссылки.

Перед обновлением сохраните резервную копию файлов плагина и его данных. Загружайте новый архив штатно через Плагины → Загрузить плагин с сохранением существующей конфигурации. Не отключайте плагин только ради обновления: отключение отзывает соединение и убирает созданные страницы подключения. После обновления проверьте версию, статус подключения, виджет и работу планировщика.

Кнопка Разорвать соединение в ChatRex отзывает доступ к каталогу и виджет. Если сайт недоступен, также отключите плагин в Moguta.CMS. При окончательном удалении плагина уберите его задание cron. Товары и заказы магазина сохраняются.

Если адрес или код не принимаются, проверьте HTTPS, подпапку, активность плагина и срок кода. Для помощи обратитесь в поддержку ChatRex, не передавая пароль CMS или служебную команду cron.