Встановлення та налаштування модулів з маркетплейсу 1С-Бітрікс

Встановлення та налаштування модулів з маркетплейса 1С-Bitrix

Модулі з маркетплейса 1С-Bitrix розширюють базову функціональність платформи: інтеграції з платіжними системами, 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=uk&mid=vendor.modulename.

Перевірка сумісності перед встановленням

Перед встановленням потрібно перевірити:

• Версія Bitrix: в описі модуля на маркетплейсі вказана мінімальна версія. Переглянути поточну версію: /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 дні.