docs.modx.pro
ms3FirstTimeBuyerDiscount
ms3FirstTimeBuyerDiscount
Скидка на первый заказ для MiniShop3 — автоматическое применение при 0 оплаченных заказов (процент или фикс)
  • MODX 3
  • PHP 8.1
  • miniShop3
Зависимости
  • miniShop3
  1. Компоненты
  2. ms3FirstTimeBuyerDiscount

ms3FirstTimeBuyerDiscount ​

Компонент для MiniShop3 автоматически применяет скидку на первый заказ. Если у покупателя нет оплаченных заказов, к стоимости корзины применяется скидка — процент или фиксированная сумма. Для авторизованных пользователей компонент проверяет user_id, для гостей — email/phone из Address черновика заказа. Статусы оплаченных заказов берутся из ms3_status_for_stat с учётом ms3_status_new.

Возможности ​

  • Скидка на первый заказ — применяется при расчёте корзины (событие msOnGetCartCost), без правки шаблонов
  • Тип скидки — процент от суммы или фиксированная сумма в валюте магазина
  • Определение первого покупателя — для пользователя по user_id, для гостя по email/phone, с учётом статусов из ms3_status_for_stat
  • Контроль комбинации скидок — настройка ftb_allow_combination запрещает применение FTB, если в корзине уже есть скидка
  • События — ftbOnBeforeApply (отмена или подмена суммы), ftbOnApply (логирование, аналитика)
  • Плашка на странице заказа — сниппет ms3ftbDiscountBanner + frontend-логика проверки eligibility по email/phone
  • Расширяемость — подмена сервиса в контейнере ms3ftb_discount, наследование FtbDiscountService

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

ТребованиеВерсия
MODX Revolution3.x
PHP8.1+

Информация

Требования к БД (MySQL 5.7+ / MariaDB 10.3+) определяются MiniShop3, от которого зависит компонент.

Зависимости ​

  • MiniShop3 — корзина, заказы, событие msOnGetCartCost, настройка ms3_status_for_stat

Внимание

Пакет зашифрован (transport encrypted). Для установки подключите провайдер modstore.pro, иначе установка завершится ошибкой Package provider not found.

Установка ​

Через ModStore ​

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

После установки ​

Задайте настройки скидки в Настройки → ms3firsttimebuyerdiscount.

Подробнее: Быстрый старт.

Термины ​

ТерминОписание
First-Time BuyerАвторизованный пользователь или гость без заказов в статусах из ms3_status_for_stat (с учётом ms3_status_new)
Оплаченный заказЗаказ в одном из статусов ms3_status_for_stat (например, «Оплачен», «Доставлен»)
СкидкаСумма или процент, вычитаемые из стоимости корзины при расчёте в msOnGetCartCost