IMLinker — кольца рекомендуемых товаров для OpenCart 3

IMLinker (в админке — CS50 Im Linker) автоматически заполняет блок «Рекомендуемые товары» в OpenCart 3. Модуль создан для владельцев каталогов, которым нужно связать товары внутри конечных категорий, а не сваливать в одну кучу весь раздел «Компьютеры» или «MP3 плееры».

Всё настраивается задачами в админке: кольцо товаров, связь двух групп или пары вручную выбранных товаров. Результат записывается в штатный список рекомендуемых, поэтому в теме ничего менять не нужно.

Список задач и результат запуска «Генерировать все» (Generate All)

Возможности

• Четыре способа связывания: «Кольца товаров», «Группа → Группа», «Группа → Точка» и «Точка → Точка». В кольце товары сортируются, и каждый получает соседей впереди и позади, пока круг не замкнётся.
• Готовые значения в новой задаче: 4 связи «до», 4 «после», сортировка по ID по возрастанию и тип записи «Перезапись». В длинном кольце это до 8 уникальных рекомендуемых на товар. Повторные пары и ссылки товара на самого себя не записываются.
• Четыре режима колец. Режим 1 собирает все найденные товары в одно кольцо. Режим 2 создаёт отдельное кольцо для каждой выбранной категории и по желанию добавляет товары подкатегорий. Режимы 3 и 4 работают только с категориями без собственных подкатегорий: режим 3 — с конечными категориями внутри выбранных, режим 4 — со всеми такими категориями магазина за одно нажатие «Генерировать!» (Generate!). Категория, в которой после фильтра осталось меньше двух товаров, кольцо не получает.

Новая задача «Кольца товаров»: режим 4, 4 «до», 4 «после», «Перезапись»

• Гибкий фильтр группы А (и группы Б для связывания групп): категории, подкатегории, статус категории, стандартные фильтры OpenCart и группы фильтров, язык названий, производители, магазин, статус товара, наличие, базовая цена, дата добавления, фрагмент названия или модели, лимит и сортировка. По умолчанию в выборку попадают только включённые товары.
• Предпросмотр. Кнопка «Загрузить список товаров» (Load the product list) показывает, какие товары попадают под фильтр и в каком порядке их обойдёт генератор. На экране — до 200 позиций, счётчик показывает полное количество.

Фильтр группы А: категории, подкатегории, статус категории, язык, производители, магазин, статус, наличие, цена, дата

Сортировка и предварительный список: сколько товаров найдено и в каком порядке их обойдёт генератор

• Запуск без сохранения. «Генерировать!» (Generate!) и «Очистить!» (Clear!) в форме задачи работают с текущими значениями полей ещё до сохранения. Из списка задач можно запустить одну сохранённую задачу или все включённые. «Очистить!» снимает рекомендуемые у товаров задачи и новых связей не добавляет.

«Группа → Группа»: тип действия <<<, 4 товара группы Б на каждый товар А, подбор «По близости»

«Точка → Точка»: товары слева и справа добавляются через поиск по названию

• Cron, журнал и защита от наложений. Задачи сохраняются, сортируются и отключаются. Cron-ссылка с секретным ключом запускает одну, несколько или все включённые задачи. Журнал фиксирует источник запуска (админка или cron), количество обработанных товаров, добавленных и снятых связей. Пока идёт один запуск, второй не стартует, а зависшая запись running старше часа снимается автоматически.
• Произвольная таблица для записи. По умолчанию — product_related с префиксом базы. Подойдёт любая таблица этой базы с колонками product_id и related_id, так что связи можно передать другому модулю вроде «С этим также покупают». Одинаковая связь повторно не записывается.

Журнал генерации: источник запуска, обработанные товары, добавленные и снятые связи

Установка

1. Откройте Extensions → Installer, нажмите Upload и загрузите ZIP-архив модуля.
2. Перейдите в Extensions → Extensions, в типе расширений выберите Modules, найдите CS50 Im Linker и нажмите Install.
3. Нажмите Edit, на вкладке настроек установите Статус = Включено и сохраните. Секретный ключ (32 символа) модуль уже создал сам. Включённый статус нужен для cron: иначе ссылка ответит, что модуль выключен. Кнопки генерации в админке статус не проверяют.
4. В Design → Layouts модуль добавлять не нужно — собственного блока на витрине у него нет. После генерации связи лежат в таблице рекомендуемых, и их выводит штатный блок related в карточке товара.

Вкладка настроек: статус, секретный ключ, Cron URL и журнал

Результат на витрине: штатный блок «Рекомендуемые товары» в карточке товара

Настройки

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

• OpenCart 3.0.x, PHP 8.1 и новее.
• Любая тема, которая выводит штатные рекомендуемые товары из product_related.
• Без правок ядра и дополнительных модулей. Установщик создаёт только две таблицы — cs50_im_linker_task и cs50_im_linker_log (InnoDB, utf8mb4).
• При удалении модуля эти таблицы и настройки удаляются, а уже записанные рекомендуемые товары остаются.
• Интерфейс админки и ответы cron — на английском (en-gb) и русском (ru-ru).
• Для списка таблиц связей модуль читает information_schema текущей базы данных.