# Подключение Joomla Commerce

Интеграция предоставляет боту доступ только для чтения к опубликованному каталогу Joomla: товарам, вариантам, категориям, ценам, остаткам и публичным ссылкам.

ChatRex не получает заказы, покупателей, адреса или платёжные данные и не изменяет каталог магазина.

# Совместимость

• системный плагин System - ChatRex: Joomla 5.4 и 6.x, PHP 8.1 или новее;
• HikaShop: Joomla 5.4 и 6.x;
• VirtueMart 4.8.2: только Joomla 5.x.

VirtueMart 4.8.2 не устанавливается на Joomla 6.x. Для Joomla 6 используйте HikaShop.

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

1. Установите и настройте HikaShop или VirtueMart.
2. Опубликуйте хотя бы один товар и витрину на рабочем домене.
3. Проверьте, что сайт открывается по HTTPS.
4. Подготовьте пользователя Joomla с правом установки и настройки плагинов.

# Подключение

1. В ChatRex откройте Интеграции → Joomla Commerce и скачайте ZIP-пакет.
2. В Joomla откройте Система → Установка → Расширения и загрузите ZIP.
3. Включите плагин System - ChatRex.
4. В ChatRex нажмите Сгенерировать код.
5. В настройках плагина выберите HikaShop или VirtueMart, укажите язык витрины и трёхбуквенный код валюты, подтвердите передачу опубликованного каталога и вставьте одноразовый код.
6. Сохраните плагин. Код удаляется из настроек после успешного подключения.
7. Вернитесь в ChatRex и дождитесь статуса Подключено.

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

# Синхронизация каталога

Плагин передаёт опубликованные позиции пакетами и продолжает незавершённую синхронизацию при следующем запуске. Период задаётся в настройках плагина; минимальное значение — 5 минут.

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

# Действия бота

После подключения добавьте нужные операции во вкладке бота Интеграции и действия:

• поиск товаров;
• получение карточки товара и вариантов;
• проверка цены и остатка товара или выбранного варианта;
• получение публичной ссылки на товар.

Параметры и безопасный сценарий работы описаны в статье Действия Joomla Commerce.

# Проверка

1. Найдите опубликованный товар с несколькими вариантами.
2. Сверьте название, SKU, цену и валюту с витриной.
3. Выберите точный вариант и проверьте его остаток.
4. Откройте возвращённую ботом ссылку в отдельной вкладке.

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

# Обновление и отключение

Обновления плагина устанавливаются стандартным средством Joomla Система → Обновление → Расширения.

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

Для работы интеграции требуется отдельная подписка ChatRex на Joomla Commerce.