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

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

• DIAFAN.CMS 7 с модулем Интернет-магазин, PHP 7.4 и доступом администратора.
• Опубликованную витрину с действующим HTTPS-сертификатом.
• Раздел магазина, язык и код основной валюты, например RUB.
• Доступ к настройке cron на хостинге и резервную копию сайта.

Условия лицензии CMS и подписка ChatRex оформляются отдельно. Условия размещения дополнения с внешней подпиской ChatRex уточняются у DIAFAN.

1. В административной части откройте Темы и дизайн → Добавить вручную.
2. Укажите отдельное имя темы ChatRex, загрузите полученный ZIP и включите применение темы. Сохраните изменения. Если установщик предлагает резервную копию, сохраните её.
3. Откройте Модули и БД → Установка модулей, отметьте ChatRex и нажмите Обновить. Не меняйте отметки других модулей и не включайте заполнение сайта демонстрационными примерами.
4. Откройте появившийся пункт ChatRex. Выберите Раздел магазина, заполните Основная валюта (код ISO) и проверьте Публичный адрес этой языковой версии.
5. Нажмите Получить код подключения. Скопируйте Адрес модуля и Одноразовый код.

Код действует десять минут. Для другого языка сначала переключите язык административной части CMS. Модуль ограничивает доступ выбранным разделом и языком; он не изменяет товары, заказы и платежи.

1. Откройте ChatRex → Интеграции → Подключить интеграцию → Источники данных → DIAFAN.CMS.
2. На вкладке Установка соединения заполните Адрес подключения из модуля и Одноразовый код. Пароль администратора CMS не требуется.
3. Нажмите Подключить каталог и дождитесь статуса Подключено.
4. Проверьте доступ к интеграции. Если действующей подписки или демодоступа нет, ChatRex предложит оформить подписку. При повторном подключении существующая подписка сохраняется.

При истёкшем или использованном коде получите новый в CMS. Если раздел уже связан с другой интеграцией, сначала отключите прежнее соединение.

В панели хостинга создайте задание cron раз в минуту. Команда показана в настройках модуля ChatRex в DIAFAN: используйте указанный полный путь к chatrex.cron.php и тот же PHP 7.4, который обслуживает сайт.

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

Создайте бота из шаблона DIAFAN.CMS или добавьте существующему боту четыре действия каталога. В каждой операции выберите подключение нужного магазина. Укажите правила доставки, оплаты и возврата, а также ответ при недоступности данных.

Для чата на витрине:

1. Подключите онлайн-чат, добавьте HTTPS-домен магазина в разрешённые домены и назначьте этот канал боту.
2. В настройках подключения DIAFAN.CMS найдите Чат на сайте, выберите созданный чат и нажмите Установить виджет.
3. В шаблоне сайта DIAFAN добавьте один раз перед </body> тег:

<insert name="show_widget" module="chatrex">

Используйте собственную тему Custom и сохраните существующую разметку сайта. Уберите ранее добавленный вручную код виджета ChatRex, чтобы чат не загружался дважды. Откройте публичную страницу и отправьте тестовый вопрос о товаре.

Перед обновлением сохраните вместе базу данных CMS, собственную тему и файл modules/chatrex/config/secret.php. В Темы и дизайн откройте ранее созданную тему ChatRex и загрузите новый архив. При обычном обновлении подключение и ключ сохраняются.

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

Для удаления снимите отметку ChatRex в Модули и БД и нажмите Обновить. Удаляются собственные данные и ключ модуля, виджет перестаёт загружаться, ChatRex получает уведомление об отключении. Товары, варианты и заказы CMS сохраняются. Старые диалоги ChatRex не удаляются.

После повторной установки заново задайте валюту, получите код и подключите существующую интеграцию. Ещё раз нажмите Установить виджет. Старый ключ больше не действует.

Проверьте два товара, варианты, цену с валютой, скидку, остаток и ссылку. Измените тестовую цену или наличие в CMS и повторите поиск. DIAFAN может изменить идентификаторы вариантов при сохранении товара: используйте их из свежего результата, не сохраняйте старые ID в постоянных настройках действий.

При выключенном учёте остатков точное количество неизвестно. Бот должен сообщать только подтверждённую доступность. Если данные недоступны, предложите помощь специалиста; текст ответа сам по себе не настраивает перевод к оператору.

Помощь: support@chatrex.pro.