1.0.0-beta1

Дата релиза: 21 апреля 2026

Первый публичный релиз ms3PromoCode — промо-коды для MiniShop3.

Скидки

Два типа: процент или фиксированная сумма.
Две области применения: вся корзина или только подпадающие под правила позиции.
Учёт скидки в позициях — цена со скидкой записывается в msOrderProduct.price. Чек 54-ФЗ, email-уведомления и личный кабинет покупателя показывают корректные суммы автоматически без доработок шаблонов.
Точная сумма скидки: копейки от пропорционального распределения автоматически компенсируются — итог совпадает с заявленной суммой до рубля.

Включить / исключить конкретные товары.
Категории, бренды.
Универсальный фильтр по любому полю modx_ms3_products с операторами =, !=, <, <=, >, >=, IN, NOT IN, BETWEEN, LIKE, CONTAINS.
Фильтр по опциям товара (цвет, размер, материал и т.п.).
Несколько секций объединяются по «И», значения внутри секции — по «ИЛИ».

Период действия: даты начала и окончания.
Общий лимит применений.
Минимальная сумма заказа для применения.
Включён / выключен.
Автоматические статусы: scheduled, expired, exhausted, disabled.
Маскировка disabled → not_found для покупателя — факт существования отключённого кода не раскрывается.

Список промо-кодов с серверной пагинацией, сортировкой, фильтрами, групповыми действиями.
Редактор кода с тремя вкладками: основные параметры, правила, статистика.
Раздел «Аналитика»: KPI и детальный журнал использований с фильтрами.
Вкладка «Промо-код» прямо в карточке заказа с автопересчётом при изменении состава.

Сниппет ms3PromoCodeForm с SSR-hydration — нет «мигания» формы при загрузке страницы.
Готовый чанк ms3promocode_form, переопределяемый через &tpl.
Headless JS-API window.ms3PromoCode — apply, remove, validate, current, события.
Опциональный UI-слой, монтируется по [data-ms3-promocode="form"].
Автоматический перерасчёт корзины после применения / снятия (с возможностью отключения для AJAX-карт).
Override-папка assets/components/ms3promocode-overrides/ для замены любых ассетов без правок пакета.

Подписка на msOnAddToCart / msOnChangeInCart / msOnRemoveFromCart — пересчёт скидки при любом изменении корзины.
Подписка на msOnCreateOrder — фиксация применения в ms3_promo_code_usages.
Подписка на msOnChangeOrderStatus — автоматический откат / восстановление при переходе в отменённые статусы.
Поддержка ручного редактирования заказа в Vue-админке MS3 через JS-перехватчик fetch (обходное решение для отсутствующих событий — см. MiniShop3#207).
Запись ms3promocode_auto_remove в msOrderLog при автоматическом снятии кода.

Метод	Путь	Назначение
POST	`/api/v1/promo/apply`	Применить код к корзине
POST	`/api/v1/promo/remove`	Снять применённый код
POST	`/api/v1/promo/validate`	Проверить код без записи
GET	`/api/v1/promo/current`	Получить текущий применённый код

Авторизация / CORS / rate limiting наследуются от MS3-роутера.

Собственный коннектор для админки с процессорами:

Mgr/PromoCode/{GetList,Get,Create,Update,Remove,Generate,PreviewMask}.
Mgr/Order/{ApplyPromo,RemovePromo,GetPromo,Resync}.
Helpers для конструктора правил: Mgr/Product/Search, Mgr/Category/Search, Mgr/Vendor/GetList, Mgr/ProductData/GetFields, Mgr/ProductOption/{GetKeys,GetValues}.
Mgr/Analytics/{GetKpi,GetLog}.

Phinx-миграции применяются автоматически при установке/обновлении.
При удалении пакета таблицы остаются — для сохранения истории.
Анонимные метрики установки (PHP/MODX/MS3/DB версии, OS, web-сервер) отправляются один раз на metrics.modx.pro для улучшения совместимости. Без персональных данных, домена и IP.