Потоки (технические)

Пользовательские сценарии в manager: interface/flows.

Схемы потоков

Серверный вывод сниппетом:

AJAX-отрисовка с сайта:

1. Отрисовка блока подборки на сайте

1. Шаблон вызывает сниппет: MODX [[!ms3ProductSets? ... ]], Fenom {'ms3ProductSets' | snippet : [ ... ]}.
2. Сниппет валидирует и нормализует параметры (type, max_items, resource_id, category_id, …).
3. Получает ID товаров через msps_get_products_by_type.
4. Если результат пуст, возвращает '' или emptyTpl.
5. Если ID есть:
   • при return=ids возвращает CSV ID;
   • иначе вызывает msProducts и отрисовывает карточки.
6. При tplWrapper оборачивает итоговый HTML.
7. При toPlaceholder складывает результат в placeholder.

2. AJAX-отрисовка через JS API

1. window.ms3ProductSets.render('#selector', options).
2. JS отправляет POST action=get_set в connector.php.
3. Коннектор запускает сниппет ms3ProductSets с параметрами из POST.
4. HTML вставляется в контейнер. Пустой ответ скрывает контейнер.

3. Добавление в корзину из карточки подборки / «весь набор»

1. Клик по data-add-to-cart или «Добавить весь набор» (data-add-set).
2. Если на странице есть window.ms3Config.actionUrl, запрос идёт в MiniShop3 Web API: POST на api.php?route=/api/v1/cart/add с JSON { id, count, options } и credentials: 'same-origin'.
3. Иначе запасной путь: POST в коннектор action=add_to_cart. Сервис ms3, токен из cookie ms3_token, вызов Cart::add().
4. При успехе: уведомление iziToast (success/error), msps:cart:update. При ответе API ещё ms3:cart:updated с detail.data для обновления карточек MS3.

4. Создание шаблона подборки (админка)

1. UI отправляет save_template.
2. Коннектор проверяет имя, тип (MSPS_ADMIN_TEMPLATE_TYPES), непустой список существующих msProduct.
3. msps_save_template делает INSERT/UPDATE в ms3_product_set_templates. При переименовании шаблона обновляет template_name и type в уже применённых связях.
4. msps_bump_cache_generation, UI перезагружает список.

5. Применение шаблона к категории

1. UI отправляет apply_template (template_id, parent_id/parent_ids, replace).
2. Категория рекурсивно разворачивается до всех msProduct.
3. Для каждого товара создаются связи в ms3_product_sets.
4. UI получает applied: число строк, реально добавленных через INSERT IGNORE (без учёта дублей и self-link).

6. Отвязка шаблона от категории

1. UI отправляет unbind_template.
2. Коннектор определяет type и name шаблона.
3. Удаляет только записи с совпадающими type + template_name.
4. TV-связи и связи других шаблонов не затрагиваются.

7. Добавление всего набора в корзину

1. Клик по кнопке с атрибутом data-add-set (в tplSetVIP или tplSetWrapper).
2. JS находит контейнер от кнопки (.msps__vip-set, .msps__wrapper или [data-set-type]).
3. Собирает ID: сначала data-msps-product-ids (VIP/wrapper), затем [data-product-id] / [data-add-to-cart], затем скрытые input[name="id"].
4. Последовательно вызывает addToCart(productId, 1) для каждого ID.
5. Показывает iziToast set_added / ошибку и вызывает событие msps:cart:update с product_ids.

8. Синхронизация TV при сохранении товара

1. Срабатывает плагин OnDocFormSave.
2. Если у шаблона товара есть TV подборок, запускается синхронизация.
3. Синхронизация только для msProduct.
4. При пустом TV: удаляются записи с пустым template_name для этого типа. Связи из шаблонов сохраняются.
5. При заполненном TV: удаляются TV-записи (пустой template_name), вставляются новые ID из TV (с валидацией msProduct).
6. После sync вызывается msps_bump_cache_generation.