Подбор по совместимости

УСТАНОВКА И НАСТРОЙКИ

1. Проверьте требования: main 20.0.0+, установленный iblock, PHP 8.2+. Сделайте резервную копию сайта и базы. Установите ozhogov.compat через раздел установленных решений Маркетплейса.
2. Установщик создаёт таблицы, копирует компоненты, скрипты и административные страницы, регистрирует обработчики событий и агент. Публичную страницу подбора он не создаёт: добавьте её самостоятельно.
3. В настройках модуля выберите инфоблок товаров, при необходимости раздел каталога и свойство артикула (например, CML2_ARTICLE). Задайте от одного до четырёх названий уровней, включите нужные параметры выбора года, запоминания модели, журнала и срока хранения.
4. Назначьте сотрудникам права на модуль: R — чтение, W — изменение. Публичный список товаров также учитывает права чтения элементов каталога, активность и сроки показа.
5. В разделе «Магазин → Подбор по совместимости» заведите дерево и связи товаров либо загрузите CSV. При создании узла не превышайте настроенное число уровней. Скрытие родителя скрывает его ветку из публичного выбора.

КОМПОНЕНТЫ НА САЙТЕ

На отдельной публичной странице после подключения штатного header.php разместите:

<?php
$APPLICATION->IncludeComponent("ozhogov:compat.selector", "", [
   "SHOW_PRODUCTS" => "Y",
   "COUNT" => "24",
   "SHOW_RECENT" => "Y",
   "COMPACT" => "N",
   "SET_TITLE" => "Y",
]);
?>

В шаблоне детальной карточки товара используйте фактический ID элемента из результата компонента каталога:

<?php
$APPLICATION->IncludeComponent("ozhogov:compat.product", "", [
   "PRODUCT_ID" => (int)$arResult["ID"],
   "SHOW_LIST" => "Y",
   "SHOW_CHECK" => "Y",
]);
?>

Не подставляйте фиксированный демонстрационный ID для всех карточек. Если шаблон использует другое имя переменной результата, передайте из него ID текущего товара.

ЗАГРУЗКА CSV

Откройте «Загрузка файлом». Пример файла:

product_id;model;fit;years;note
123;toyota/camry/xv70;M;2017-2024;"Нужен переходник"

Вместо 123 укажите ID существующего товара вашего каталога, а в model — путь кодов узлов. Можно использовать колонку article вместо product_id. Виды: E, A, M, N. Годы: диапазон, отдельный год, «с 2019», «до 2015». Кодировка — UTF-8 или Windows-1251; предел — 8 MiB и 50 000 записей. Переносы строки в note допустимы внутри кавычек.

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

АГЕНТ И ОБНОВЛЕНИЕ

В списке агентов проверьте активный вызов \Ozhogov\Compat\Agent::cleanup(); с интервалом 86400 секунд. Он чистит журнал по сроку хранения из настроек, удаляет связи отсутствующих товаров и пересчитывает счётчики. Выполнение зависит от настройки агентов сайта на хитах или cron.

Обновляйте модуль штатным способом через Маркетплейс: updater.php переносит копии компонентов, скриптов и административных обёрток в общие каталоги сайта и регистрирует обработчик удаления товара, если его ещё нет.

При ручной замене файлов модульного каталога updater сам не выполняется. В доверенном служебном PHP-скрипте с подключённым прологом Битрикса выполните копирование файлов:

<?php
require_once $_SERVER["DOCUMENT_ROOT"] . "/bitrix/modules/ozhogov.compat/install/index.php";
(new ozhogov_compat())->InstallFiles();

$events = \Bitrix\Main\EventManager::getInstance();
$registered = false;
foreach ($events->findEventHandlers("iblock", "OnAfterIBlockElementDelete", ["ozhogov.compat"]) as $handler) {
   if (strcasecmp(ltrim((string)($handler["TO_CLASS"] ?? ""), "\\"), "Ozhogov\\Compat\\EventHandler") === 0
       && strcasecmp((string)($handler["TO_METHOD"] ?? ""), "onElementDelete") === 0) {
       $registered = true;
       break;
   }
}
if (!$registered) {
   $events->registerEventHandlerCompatible(
       "iblock", "OnAfterIBlockElementDelete", "ozhogov.compat",
       "Ozhogov\\Compat\\EventHandler", "onElementDelete"
   );
}
?>

Этот вызов перезаписывает штатные копии в /bitrix/components/ozhogov/, /bitrix/js/ozhogov.compat/ и /bitrix/admin/. Сохраните собственные изменения этих копий заранее. Отдельно проверьте через EventManager::findEventHandlers наличие обработчика iblock → OnAfterIBlockElementDelete → Ozhogov\Compat\EventHandler::onElementDelete для модуля ozhogov.compat. Если записи нет, зарегистрируйте её один раз через EventManager::registerEventHandlerCompatible; не создавайте дубли. Одна замена файлов и InstallFiles обработчик не регистрируют.

ПРОВЕРКА РЕЗУЛЬТАТА

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