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

Пошаговое подключение блоков рекомендаций (подборок товаров) к сайту с MiniShop3.

Имена сниппетов: ms3ProductSets, mspsLexiconScript.

Примеры на Fenom требуют pdoTools 3.x.

Установка

Требования

Требование	Версия
MODX Revolution	3.0+
PHP	8.1+
MiniShop3	установлен
pdoTools	3.0.0+
VueTools	установлен (страница админки «Подборки товаров»)

Через ModStore

1. Подключите репозиторий ModStore
2. Перейдите в Extras → Installer и нажмите Download Extras
3. Убедитесь, что установлены MiniShop3, pdoTools и VueTools
4. Найдите ms3ProductSets в списке и нажмите Download, затем Install
5. Настройки → Очистить кэш

Пакет доступен в каталоге modstore.pro.

После установки

Подключите лексикон, CSS и JS на сайте, разместите блок подборки в шаблоне карточки товара (сниппет ms3ProductSets). Подробнее — ниже.

---

Шаг 1: Лексикон, стили и скрипт

В шаблоне (или общем head/footer) подключите сначала лексикон, затем CSS и JS.

fenom

{'mspsLexiconScript' | snippet}
<link rel="stylesheet" href="{'assets_url' | option}components/ms3productsets/css/productsets.css">
<script src="{'assets_url' | option}components/ms3productsets/js/productsets.js" defer></script>

modx

[[!mspsLexiconScript]]
<link rel="stylesheet" href="[[++assets_url]]components/ms3productsets/css/productsets.css">
<script src="[[++assets_url]]components/ms3productsets/js/productsets.js" defer></script>

Шаг 2: Блок в карточке товара

В шаблоне страницы товара (или в чанке карточки в списке) вызовите сниппет ms3ProductSets.

Параметр type

type задаёт сценарий подборки: от него зависит, какие ручные связи читаются из таблицы ms3_product_sets и какая авто-логика включается, если ручных связей нет. Общая схема для всех значений — в Типах подборок (раздел «Общие правила (для всех типов)»).

type	Назначение (кратко)
buy_together	Блок «с этим товаром покупают» на карточке; авто — по категории товара.
similar	Похожие товары из той же категории.
popcorn	Компактные импульсные допродажи; свой fallback, если по категории пусто.
cart_suggestion	Рекомендации в корзине / перед оформлением; удобно с category_id.
auto_sales	Подборка по статистике заказов; при нехватке данных — уход в логику similar.
vip	Фиксированные промо-наборы из настроек vip_set_*; нужен set_id.
auto	Универсальный блок (главная, лендинг): часто category_id и/или resource_id.

Для типичной карточки товара в quick-start ниже используется buy_together.

Остальные параметры вызова:

• resource_id — ID товара, для которого строится подборка (на странице товара это текущий ресурс).
• max_items — максимум позиций в блоке (допустимый диапазон 1…100).
• tpl — чанк одной строки товара; в поставке по умолчанию подходит tplSetItem.

Если подборка пустая, сниппет по умолчанию возвращает пустую строку (hideIfEmpty=true) — обёртку с заголовком и разметкой удобно вешать через условный вывод или placeholder; пример с секцией и лексиконом — в Интеграции на сайт. Детали по каждому значению type — в Типах подборок.

fenom

{'ms3ProductSets' | snippet : [
  'type' => 'buy_together',
  'resource_id' => $_modx->resource.id,
  'max_items' => 6,
  'tpl' => 'tplSetItem'
]}

modx

[[!ms3ProductSets?
  &type=`buy_together`
  &resource_id=`[[*id]]`
  &max_items=`6`
  &tpl=`tplSetItem`
]]

Шаг 3: Проверьте результат

• Откройте страницу товара.
• Если для товара есть ручные связи, блок покажет их.
• Если ручных связей нет, сработает авто-логика выбранного типа.
• Если подборка пустая, блок не выводится (по умолчанию hideIfEmpty=true).

Шаг 4: VIP-набор (опционально)

1. Заполните настройку ms3productsets.vip_set_1 (пример: 12,34,56).
2. Выведите блок:

fenom

{'ms3ProductSets' | snippet : [
  'type' => 'vip',
  'set_id' => 1,
  'tpl' => 'tplSetVIP'
]}

modx

[[!ms3ProductSets?
  &type=`vip`
  &set_id=`1`
  &tpl=`tplSetVIP`
]]

Что дальше

• Типы подборок
• Интеграция на сайт
• API и интерфейсы
• Руководство по админке