Интеграция и сценарии

Сценарии подключения msPriceTiers на витрине MiniShop3.

Тема	Раздел
Карточка товара	Шаблон msProduct
ms3Variants	Интеграция с ms3Variants
Корзина	Корзина
Каталог	Страница категории
Каскад цен	Наследование от категории

Шаблон товара (msProduct)

fenom

{'!msPriceTiers.initialize' | snippet}

<article class="product" data-product-id="{$_modx->resource.id}">
  <h1>{$_modx->resource.pagetitle}</h1>

  <div class="product-price">
    <span class="mspricetiers-cost">{$price} ₽</span>
    {if $old_price > 0}
      <span class="mspricetiers-old-cost">{$old_price} ₽</span>
    {/if}
  </div>

  <form method="post" class="ms3_form mspricetiers-form">
    <input type="hidden" name="id" value="{$_modx->resource.id}">
    <input type="number" name="count" class="mspricetiers-quantity" value="1" min="1">
    <button type="submit" name="ms3_action" value="cart/add">В корзину</button>
  </form>

  <section>
    <h3>{'mspricetiers_price_tiers' | lexicon}</h3>
    {'!msPriceTiers' | snippet : ['product' => $_modx->resource.id]}
  </section>

  {'!msPriceTiersProgress' | snippet : ['product' => $_modx->resource.id]}
</article>

modx

[[!msPriceTiers.initialize]]

<article class="product" data-product-id="[[*id]]">
  <h1>[[*pagetitle]]</h1>

  <div class="product-price">
    <span class="mspricetiers-cost">[[+price]] ₽</span>
    [[+old_price:notempty=`<span class="mspricetiers-old-cost">[[+old_price]] ₽</span>`]]
  </div>

  <form method="post" class="ms3_form mspricetiers-form">
    <input type="hidden" name="id" value="[[*id]]">
    <input type="number" name="count" class="mspricetiers-quantity" value="1" min="1">
    <button type="submit" name="ms3_action" value="cart/add">В корзину</button>
  </form>

  <section>
    <h3>[[%mspricetiers_price_tiers]]</h3>
    [[!msPriceTiers? &product=`[[*id]]`]]
  </section>

  [[!msPriceTiersProgress? &product=`[[*id]]`]]
</article>

При смене количества JS обновляет .mspricetiers-cost через action=price. Таблица порогов после SSR не перерисовывается сама; для таблицы или бейджа без перезагрузки используйте action=sections или data-mspt-live (см. Подключение на сайте).

ms3Variants

При mspricetiers_integrate_ms3variants = Да:

1. Покупатель выбирает вариант (цвет, размер).
2. Базовая цена = цена варианта из ms3_product_variants.
3. Пороги применяются к этой базе.
4. Смена варианта → событие ms3variants:selected → пересчёт в mspricetiers.js.

На странице — разметка ms3Variants: форма .ms3variants-product-{id}, поле _variant_id в options при добавлении в корзину.

В AJAX price передайте variant_id — см. AJAX API.

Корзина

Цены в корзине обновляет плагин mspricetiers_events при mspricetiers_apply_in_cart = Да. Сначала пороги по количеству на каждой позиции, затем скидка по сумме корзины (если mspricetiers_cart_tiers_enabled = Да).

На странице корзины вызовите msPriceTiers.initialize.

Прогресс по количеству в корзине

fenom

<div data-mspt-live="progress-cart">
  {'!msPriceTiersProgress' | snippet : ['cart' => 1, 'tpl' => 'mspricetiers.progress_cart']}
</div>

modx

<div data-mspt-live="progress-cart">
  [[!msPriceTiersProgress?
    &cart=`1`
    &tpl=`mspricetiers.progress_cart`
  ]]
</div>

Прогресс по сумме корзины

fenom

<div data-mspt-live="progress-cart-sum">
  {'!msPriceTiersProgress' | snippet : ['cartSum' => 1, 'tpl' => 'mspricetiers.progress_cart_sum']}
</div>

modx

<div data-mspt-live="progress-cart-sum">
  [[!msPriceTiersProgress?
    &cartSum=`1`
    &tpl=`mspricetiers.progress_cart_sum`
  ]]
</div>

После cart/add, cart/change, cart/remove MiniShop3 шлёт ms3:cart:updated. mspricetiers.js обновляет блоки [data-mspt-live="progress-cart"] (по количеству) и progress-cart-sum (по сумме корзины) через connector action=sections.

Пороги по сумме корзины настраиваются в Extras → msPriceTiers — см. Управление порогами.

Страница категории

В начале шаблона категории:

fenom

{'!msPriceTiers.initialize' | snippet}
{'!msProducts' | snippet : ['parents' => $_modx->resource.id, 'tpl' => 'tpl.Product.row']}

modx

[[!msPriceTiers.initialize]]
[[!msProducts?
  &parents=`[[*id]]`
  &tpl=`tpl.Product.row`
]]

В чанке строки каталога — компактная таблица или бейдж (mspricetiers.badge).

Наследование от категории

1. Задайте процентные пороги на категории (Управление порогами).
2. Товары без своих порогов получат эту сетку.
3. Для отдельного товара — свои пороги на вкладке товара (% или фикс. ₽); они перекрывают категорию.

Условный вывод по группам

fenom

{set $userGroups = $_pls['user_groups'] ?: []}
{if 2 in $userGroups}
  {'!msPriceTiers' | snippet : ['product' => $_modx->resource.id]}
{else}
  <p>Розничная цена: {$price} ₽</p>
{/if}

modx

[[!+user_groups:contains=`2`:then=`
  [[!msPriceTiers? &product=`[[*id]]`]]
`:else=`
  <p>Розничная цена: [[+price]] ₽</p>
`]]

Группы в плейсхолдере зависят от настройки MODX / дополнений.

Проверка интеграции

Действие	Ожидание
Товар, количество ниже первого порога	Базовая цена или цена варианта
Количество ≥ порога	Цена порога, подсветка строки в таблице
Корзина, 10+ шт.	Позиция с ценой по порогу
Сумма корзины ≥ порога по сумме	Доп. скидка на весь заказ
Смена варианта	Пересчёт без перезагрузки

См. также

• Быстрый старт
• Подключение на сайте
• Управление порогами