Руководство по админке

Страница Подборки товаров хранит шаблоны (тип + набор ID) и позволяет массово скопировать их в связи ms3_product_sets для всех товаров категории. Точечные правки — через TV на карточке товара.

Экран и поля API: Подборки товаров (интерфейс). Пошаговые сценарии: Сценарии (flows).

Как открыть

• Компоненты → Подборки товаров
• URL: ?a=index&namespace=ms3productsets
• Нужны VueTools и право MODX view

Две вкладки

Страница разделена на вкладки Список подборок и Применение. Справочник типов — на первой вкладке, в боковой колонке.

Вкладка «Список подборок»

1. Toolbar — описание, счётчик шаблонов, кнопка Новая подборка.
2. Таблица — ID, название, тип (цветной tag), ID товаров, Изменить / Удалить. Пустой список — EmptyState с CTA.
3. Типы подборок — свёрнутая панель справа. Tag типа и описание из лексикона.

Вкладка «Применение»

Выбор шаблона (Select), категории (TreeSelect, дерево без товаров), чекбокс Заменить существующие подборки этого типа, кнопки Применить и Отвязать.

При replace=true удаляются только связи с тем же template_name и type, что у выбранного шаблона. TV-связи и записи других шаблонов не затрагиваются.

Категория разворачивается рекурсивно до товаров (msProduct, глубина до 10). Ответ applied — число реально вставленных строк (INSERT IGNORE, без дублей).

Создание шаблона

1. Новая подборка.
2. Заполните поля:

Поле	Назначение
Название	Имя для менеджеров. Попадает в template_name связей.
Тип подборки	Один из пяти типов шаблонов.
ID товаров	MultiSelect или строка через запятую. Минимум один ID.
Описание	Внутренний комментарий.
Порядок	Сортировка в списке админки.

3. Сохранить → connector save_template.

Редактирование и удаление

• Изменить — те же поля, connector save_template с id. При переименовании шаблона обновляется template_name в уже применённых связях.
• Удалить — ConfirmDialog, connector delete_template. Удаляются шаблон и все связи с его template_name и type.

Применение и отвязка

Применить (apply_template):

• Собирает все msProduct в выбранной категории и подкатегориях.
• Для каждого товара создаёт строки в ms3_product_sets с template_name = имя шаблона.
• С replace=true сначала удаляет связи с тем же template_name и type у товаров категории.

Отвязать (unbind_template):

• Удаляет связи с совпадающими type + template_name в выбранной ветке.
• TV и другие шаблоны не трогает.

TV на карточке товара

TV	Тип
ms3productsets_buy_together	buy_together
ms3productsets_similar	similar
ms3productsets_popcorn	popcorn
ms3productsets_cart_suggestion	cart_suggestion
ms3productsets_vip	vip

При сохранении товара плагин ms3ProductSets SyncTV (OnDocFormSave):

• срабатывает только для ресурсов класса msProduct;
• при пустом TV удаляет записи с пустым template_name (созданные из TV);
• при заполненном TV перезаписывает связи типа без template_name;
• связи из шаблонов (template_name задан) не трогает.

Типовый процесс

1. Массово: шаблон → Применить к категории.
2. Точечно: TV на одном товаре.
3. Проверка: ms3ProductSets с тем же type на витрине.

См. также

• Сценарии (flows)
• Системные настройки
• Права доступа