Установка и настройка модулей из маркетплейса 1С-Битрикс

Установка и настройка модулей из маркетплейса 1С-Битрикс

Модули из маркетплейса 1С-Битрикс расширяют базовую функциональность платформы: интеграции с платёжными системами, CRM-коннекторы, инструменты SEO, модули доставки, виджеты. Установка через маркетплейс — несколько кликов, но до рабочего состояния модуль часто требует дополнительной конфигурации, тестирования и проверки совместимости.

Процесс установки

Установка модуля из маркетплейса производится через административный раздел: /bitrix/admin/partner_modules.php или «Marketplace» → «Модули». После оплаты или скачивания бесплатного модуля система:

1. Загружает архив в /bitrix/modules/vendor.modulename/
2. Выполняет install.php модуля — создаёт таблицы в БД, записывает начальные настройки в b_option, регистрирует обработчики событий через RegisterModuleDependences
3. Регистрирует модуль в b_module

После установки модуль доступен в настройках: /bitrix/admin/settings.php?lang=ru&mid=vendor.modulename.

Проверка совместимости перед установкой

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

• Версия Битрикс: в описании модуля на маркетплейсе указана минимальная версия. Посмотреть текущую версию: /bitrix/admin/index.php → «Обновления»
• Версия PHP: в composer.json или документации модуля. Посмотреть текущую версию PHP: phpinfo() или через SSH php -v
• Конфликты: если два установленных модуля регистрируют обработчик на одно событие с одним приоритетом — могут конфликтовать. Проверяется в b_module_to_module таблице

Настройка после установки

Каждый модуль имеет свою страницу настроек. Общая структура: страница в /bitrix/admin/ с формой, данные сохраняются через COption::SetOptionString(). Типовые настройки:

• Модули оплаты: API-ключи платёжной системы, тестовый/боевой режим, webhook URL для колбэков (его нужно прописать в личном кабинете платёжной системы)
• Модули доставки: учётные данные в транспортной компании, список доступных способов доставки, таблицы соответствия регионов
• CRM-интеграции: OAuth-токены, маппинг полей, направление синхронизации
• SEO-модули: правила генерации мета-тегов, настройки sitemap, параметры микроразметки

Тестирование после настройки

Перед включением в production каждый функциональный модуль нужно протестировать:

• Модули оплаты — тестовый платёж через sandbox-режим, проверка обработки success/fail/cancel callback
• Модули доставки — расчёт стоимости для нескольких адресов и весовых категорий
• CRM-интеграции — создание тестовой заявки, проверка её появления в CRM, двусторонняя синхронизация статусов

Сроки

Установка и базовая настройка простого модуля (SEO, аналитика, виджет) — 2–4 часа. Настройка модуля с внешней интеграцией (оплата, доставка, CRM) — 4–8 часов. Настройка сложного модуля с маппингом данных и тестированием — 1–3 дня.