msPriceTiers

msPriceTiers — дополнение для MODX Revolution 3 и MiniShop3: разные цены в зависимости от количества (оптовые пороги), с учётом корзины, вариантов ms3Variants и наследования от категории.

С чего начать: Быстрый старт.

Минимальный путь на витрине

1. Установить пакет через ModStore и убедиться, что работают MiniShop3 и VueTools (вкладка в админке).
2. В Системные настройки (область mspricetiers) включить компонент и при необходимости интеграцию с ms3Variants.
3. На карточке товара создать пороги во вкладке «Оптовые цены» (Мини-магазин → Товары).
4. На шаблоне msProduct вывести [[!msPriceTiers.initialize]] и [[!msPriceTiers]].
5. Очистить кэш и проверить: смена количества → пересчёт цены, в корзине — tier-цена.

Быстрые ссылки

Нужно	Документ
Установить и вывести таблицу порогов	Быстрый старт
Все ключи mspricetiers_*	Системные настройки
Сниппеты и параметры	Сниппеты
CSS-классы, JS API, темы	Подключение на сайте
Шаблон товара, корзина, категории	Интеграция
Вкладка в MS3, шаблоны порогов	Управление порогами
connector, сервис PHP	AJAX API и PHP
mspricetiersOn*	События MODX
Диагностика	FAQ

Возможности

• Пороги по количеству — цена и зачёркнутая «старая» цена от count_from
• Корзина MS3 — пересчёт при добавлении и изменении количества
• Категорийные пороги — наследование товарами без своих активных порогов
• Шаблоны порогов — сохранение сетки и применение к товару/категории (merge / replace)
• Группы пользователей — ограничение порогов по группам MODX
• Временные акции — valid_from / valid_until на пороге
• Прогресс-бар — «до следующей скидки» на товаре и в корзине
• ms3Variants — базовая цена от выбранного варианта
• Админка — вкладка «Оптовые цены» на товаре и категории (Vue + PrimeVue, как в MS3)

Системные требования

Требование	Версия
MODX Revolution	3.0+
PHP	8.2+
MiniShop3	1.0+
pdoTools	3.0+ (рекомендуется для Fenom)
VueTools	для вкладки в админке MiniShop3

Зависимости

• MiniShop3 — товары, корзина, цены

Опционально

• ms3Variants — варианты товара и цена варианта как база для порогов
• VueTools — без него Vue-вкладки MS3 не загрузятся

Установка

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

Каталог: modstore.pro/packages/ecommerce/mspricetiers.

После установки: namespace mspricetiers, сниппеты msPriceTiers, msPriceTiers.initialize, msPriceTiersProgress, чанки mspricetiers_*, плагин mspricetiers_events, таблицы порогов и шаблонов.

Термины

Термин	Описание
Порог (tier)	Правило: от N штук — цена X
Каскад	Сначала пороги товара → пороги категории → базовая цена MS3 / варианта
Шаблон	Сохранённая сетка порогов. При применении копируется в товар/категорию
merge / replace	Добавить пороги из шаблона или полностью заменить текущие

Архитектура (кратко)

Подробнее: Подключение на сайте, AJAX API, Управление порогами.