ms3ProductSets — динамические подборки товаров для MODX Revolution 3 и MiniShop3

На карточке товара, в корзине и на главной выводятся блоки вроде «С этим покупают», «Похожие», дополнение к корзине, наборы по статистике заказов, VIP-промо и др. Сначала используются ручные связи и именованные шаблоны; если подборки нет — срабатывают авто-рекомендации по категории и статистике заказов. Рост среднего чека и кросс-продаж без ручной привязки каждого SKU.

Это дополнение для тех, кому нужно:

• единый сниппет ms3ProductSets с типами: buy_together, similar, cart_suggestion, auto_sales, popcorn, vip и др.;
• хранение связей в БД (ms3_product_sets) и шаблонов подборок (ms3_product_set_templates) без ручного SQL;
• массовое применение шаблона к категории и отвязка шаблона от категории из менеджера MODX;
• точечная настройка через TV на карточке товара (VIP, акции) с синхронизацией в таблицу;
• скрытие пустого блока (hideIfEmpty), кеширование по TTL, Fenom-чанки и BEM-префикс msps.

✨ Ключевые возможности

• вывод через MiniShop3 (msProducts) и pdoTools; на фронте — [[!mspsLexiconScript]], productsets.css, productsets.js из assets/components/ms3productsets/;
• коннектор: get_set (HTML блока), add_to_cart; для админки — шаблоны, дерево ресурсов, сохранение и применение к категории;
• кнопка «Добавить весь набор» в обёртке tplSetWrapper; уведомления на фронте через iziToast (пути настраиваются; по умолчанию — из поставки MiniShop3);
• страница «Компоненты → Подборки товаров»: Vue 3 + PrimeVue 4 через VueTools — таблица шаблонов, диалог создания/редактирования, MultiSelect с поиском по товарам, TreeSelect категории, опция «Заменить существующие», отвязка от категории; панель выбора в контексте модального окна для удобства на узких экранах;
• плагины: ms3ProductSets SyncTV (OnDocFormSave) — синхронизация TV в таблицу; ms3ProductSets Cleanup (OnResourceDelete) — удаление «битых» связей при удалении товара;
• чанки tplSetItem, tplSetEmpty, tplSetWrapper, tplSetVIP, tplPopcorn и свой чанк лексикона; namespace ms3productsets;
• лексикон RU / EN / UK, CSS-переменные для оформления блока, mobile-first (в т.ч. горизонтальный скролл карточек на мобильных).

🛒 MiniShop3

• интеграция с типичной витриной: свои чанки товара, без навязывания разметки магазина;
• системные настройки: лимит позиций (ms3productsets.max_items), TTL кеша (cache_lifetime), вкл/выкл авто-рекомендаций (auto_recommendation), VIP-наборы (vip_set_*), пути к iziToast (ms3productsets.izitoast_*).

🚀 Быстрый старт

1. Установите пакет через Extras → Installer (репозиторий ModStore или транспортный пакет).
2. Убедитесь, что установлены MiniShop3, pdoTools 3.x и для страницы админки подборок — VueTools.
3. На сайте подключите [[!mspsLexiconScript]], затем CSS и JS из assets/components/ms3productsets/.
4. Вызовите [[!ms3ProductSets? &type=`buy_together` &tpl=`tplSetItem`]] (или другой type) на шаблоне товара, корзины или главной.
5. Шаблоны подборок и применение к категории настройте в менеджере: Компоненты → Подборки товаров.
6. Настройки → Очистить кэш.

📋 Требования

• MODX Revolution 3.0+
• PHP >=8.2
• MiniShop3
• pdoTools 3.x (рекомендуется для вывода и Fenom)
• VueTools — для UI «Подборки товаров» в менеджере

Документация ms3ProductSets

Дополнение в магазине Modstore