Установка

Подготовка

Перед установкой проверьте:

• miniShop3 установлен и открывается без ошибок;
• PHP соответствует требованиям компонента;
• создан родительский ресурс для каталога;
• созданы шаблоны категории и товара;
• настроен Media Source для изображений miniShop3;
• создана резервная копия сайта.

Установка transport-пакета

1. Откройте в MODX раздел Пакеты → Установщик.
2. Загрузите или получите пакет commercebridge1c-1.6.0-pl.transport.zip из подключённого провайдера.
3. Запустите установку.
4. Для защищённой версии выберите провайдера modstore.pro и лицензированный домен.
5. Очистите системный кеш MODX.
6. Откройте Компоненты → CommerceBridge 1C.

После установки создаются:

• namespace commercebridge1c;
• системные настройки с префиксом commerceml_;
• пункт меню CommerceBridge 1C;
• таблицы сеансов, связей GUID и сопоставлений полей.

Первоначальная настройка

На вкладке настроек укажите:

Поле	Что выбрать
Логин обмена	Отдельный логин для 1С, например exchange
Пароль	Новый сложный пароль, отличный от пароля менеджера MODX
Родитель каталога	Ресурс, внутри которого будут создаваться категории
Шаблон категории	Шаблон для новых категорий каталога
Шаблон товара	Шаблон для новых товаров miniShop3
Контекст	Обычно web
Media Source	Источник файлов для изображений товаров

Сохраните настройки. Панель покажет URL обмена:

https://example.ru/assets/components/CommerceBridge1C/connector.php

Информация

Текущий пароль обмена повторно не отображается. Пустое поле пароля при последующем сохранении не заменяет установленный пароль.

Проверка endpoint

Если открыть URL обмена без параметров, компонент не выполняет импорт. Работу endpoint следует проверять штатной проверкой соединения из 1С.

При запросе без правильной авторизации сервер должен вернуть HTTP 401 и заголовок Basic Auth. Если 1С не передаёт заголовок Authorization, проверьте конфигурацию FastCGI, nginx или Apache.

Обновление

1. Создайте резервную копию сайта.
2. Установите новый transport поверх текущей версии.
3. Очистите кеш MODX.
4. Откройте компонент и проверьте настройки.
5. Выполните тестовый обмен небольшой группой товаров.

GUID-связи, настройки и история обменов при обычном обновлении сохраняются.

Установка через CLI

Для автоматизированного развёртывания доступен установщик:

php core/components/CommerceBridge1C/setup/install.php exchange 'сложный-пароль' 12

Аргументы команды:

1. логин обмена;
2. пароль обмена;
3. ID родительского ресурса каталога.

После выполнения откройте панель компонента и задайте шаблоны и Media Source.