- Ответ от администратора
- "Здравствуйте! Этот модуль позволяет настроить сроки действия бонусных баллов и автоматизировать отправку уведомлений об их изменениях. Для настройки стоимости товаров в баллах, пожалуйста, воспользуйтесь возможностями модуля 'Бонусные баллы'."
Расширенные бонусные баллы
Этот модуль входит в нашу Подписку.
Оформите подписку — и пользуйтесь всеми модулями без ограничений.
Модуль «Расширенные бонусные баллы» расширяет стандартные бонусы CS-Cart и делает работу с ними более гибкой. Он помогает точнее управлять списанием, начислением и сроком жизни бонусов, а также показывает покупателю полезную информацию о баллах прямо на витрине.
Для чего нужен
- чтобы ограничивать оплату бонусами по более точным правилам;
- чтобы начислять бонусы за регистрацию и выбранные способы оплаты;
- чтобы показывать цену в бонусах и подсказки на витрине;
- чтобы автоматически списывать просроченные баллы по сроку жизни.
Основные возможности
- задаёт лимиты списания бонусов по товарам, категориям и всему заказу;
- показывает покупателю доступный максимум бонусов к списанию;
- начисляет бонусы за регистрацию;
- поддерживает дополнительные правила начисления при оплате;
- отображает цену в баллах и подсказки для гостей и авторизованных покупателей;
- списывает просроченные баллы по сроку жизни и позволяет запускать процесс вручную.
Как работает
После настройки модуль дополняет стандартные бонусные баллы CS-Cart. Он помогает применять ограничения на списание, начислять бонусы по выбранным сценариям и отображать на витрине полезные подсказки о бонусах. Если включено сгорание, модуль отслеживает срок жизни начислений и списывает просроченные баллы по заданным правилам.
Остались вопросы по работе модуля?
- Store Builder
- Store Builder Ultimate
- Multi-Vendor
- Multi-Vendor Plus
- Multi-Vendor Ultimate
- Вендорам
- Владельцам
- Покупателям
- English
- Русский
- 4.21.X
- 4.20.X
- 4.19.X
- 4.18.X
- 4.17.X
- 4.16.X
- 4.15.X
- 4.14.X
- 4.13.X
- 4.12.X
Инструкция к модулю Расширенные бонусные баллы
Модуль «Расширенные бонусные баллы» расширяет стандартный аддон CS-Cart «Бонусные баллы» и делает работу с бонусами более гибкой. Он позволяет точнее ограничивать списание, начислять баллы по дополнительным правилам, показывать бонусную информацию на витрине и автоматически списывать просроченные баллы.
Что делает модуль
- ограничивает оплату бонусами по товарам, категориям и всему заказу;
- показывает покупателю доступный максимум баллов к списанию;
- начисляет бонусы за регистрацию;
- может начислять бонусы при оплате выбранным способом;
- показывает цену в баллах и подсказки на витрине;
- списывает просроченные баллы по сроку жизни и позволяет запускать это вручную.
Где находится модуль
Модуль использует стандартный аддон CS-Cart Бонусные баллы, он должен быть установлен и включён.
Основные настройки находятся в карточке модуля Расширенные бонусные баллы. Отдельная страница Сгорание бонусов доступна в административной панели и показывает статистику по баллам, которые уже подходят к списанию.
Как настроить
Начисление бонусов
- Бонусы за регистрацию — количество баллов, которое получает новый пользователь.
- Заголовок уведомления и текст уведомления — сообщение, которое увидит покупатель после начисления.
Ограничения списания
- Базовый лимит оплаты бонусами для товаров — процентный предел, который применяется по умолчанию, если для товара или категории не задано более точное ограничение.
- Основа общего лимита по заказу — по какой сумме считать общий лимит: по итогу заказа или по подытогу.
- Формат общего лимита по заказу — лимит в процентах или в фиксированной сумме.
- Значение общего лимита по заказу — само значение ограничения.
Если для товара или категории задано собственное ограничение, модуль учитывает его и показывает покупателю максимально доступное количество баллов к списанию.
Параметры витрины
- Показывать цену в бонусах — выводит стоимость товаров в баллах.
- Показывать бонусы гостю — показывает бонусную информацию неавторизованным покупателям.
- Ссылка с информацией о бонусах — ссылка, по которой можно вести на страницу с условиями программы.
- Подсказка о бонусах — текст пояснения, который видит покупатель на витрине.
Сгорание бонусов
- Срок жизни бонусов, дней — через сколько дней начисления считаются просроченными.
- Secret key для сгорания — ключ защиты для cron-запуска.
- Шаблон cron — готовая команда для автоматического списания просроченных баллов.
Как проверить работу
- Создайте тестового покупателя и начислите ему бонусы за регистрацию или через заказ.
- Проверьте, что на витрине показывается цена в баллах и подсказка о бонусах, если эти параметры включены.
- Добавьте товар с ограничением по бонусам в корзину и убедитесь, что модуль не даёт списать больше разрешённого.
- Если включено сгорание, откройте страницу Сгорание бонусов и проверьте статистику по просроченным начислениям.
- Запустите сгорание вручную или по cron и убедитесь, что просроченные баллы списываются по заданному сроку жизни.
Значения по умолчанию и приоритет лимитов
Бонус за регистрацию — 0 (дополнительного начисления нет), базовый товарный лимит — 100%. Общий лимит заказа: база «Итог», формат «Процент», значение 0 (общее ограничение отключено). Цена в бонусах включена, показ гостям выключен. Срок жизни — 90 дней; 0 отключает сгорание.
Лимит товара задаётся в карточке товара, лимит категории — в карточке категории. Сначала используется непустое значение товара. Если его нет, выбирается минимальное непустое ограничение его категорий. При отсутствии этих значений возможен поиск в родительских категориях, если включено наследование в стандартном модуле бонусов; затем применяется базовый лимит.
Ноль у товара или категории трактуется как отсутствие собственного ограничения, а не запрет оплаты баллами. При объединении общего и товарного лимитов нулевые значения также исключаются из сравнения. Поэтому не используйте ноль для полного запрета списания.
Товарный предел рассчитывается от базовой цены и количества. Общий предел «Подытог» использует подытог корзины, «Итог» — итог с добавлением скидки на подытог, а при пустом итоге — подытог. В процентном режиме база перед вычислением приводится к целому числу; рассчитанные пределы округляются вверх. Применяется меньший положительный предел. Результат сравнивается непосредственно с количеством списываемых баллов, поэтому при нестандартном курсе обмена обязательно проверьте расчёт на контрольной корзине.
Бонус за способ оплаты
В карточке способа оплаты есть дополнительное поле количества бонусов. Ненулевое значение начисляется авторизованному пользователю при открытии страницы завершения заказа. Этот обработчик не проверяет оплаченный статус. Защита от повторного начисления хранится только в текущей сессии; не считайте её гарантией однократного начисления при повторном открытии заказа из другой сессии.
Запуск и проверка сгорания
Одного срока жизни недостаточно для периодического запуска: расписание должен настроить администратор сервера. Ключ запуска храните в защищённой настройке; передайте настройку автоматизации ответственному за сервер, не публикуя ключ или защищённый адрес запуска в переписке.
Сначала просмотрите страницу «Сгорание бонусов»: это предварительный расчёт по журналу начислений и списаний. Ручной запуск реально изменяет балансы, а не имитирует списание. Для проверки используйте тестовую учётную запись с известными начислениями и расходами, сравните журнал и баланс до и после запуска.
Просроченными считаются начисления старше указанного числа дней. Расчёт учитывает списания после раннего просроченного начисления и отметки уже обработанных записей. При сроке 0 обработка не выполняется. Не запускайте ручную и автоматическую обработку одновременно; после запуска проверьте итоговые счётчики и журнал изменения баллов.
История изменений
v1.6.1 от 17.09.2026
[*] Обновлены код, шаблоны и интеграционные файлы модуля.
[*] Обновлены описание, инструкция и changelog модуля.
v1.6.0 от 2026-04-16
[+] Добавлено:.
[+] Добавлен общий лимит оплаты бонусами по заказу с выбором базы расчёта и формата ограничения.
[+] Добавлено сгорание просроченных бонусных баллов по сроку жизни, cron-команда и отдельная страница в панели администратора со статистикой и ручным запуском.
[*] Ограничения оплаты бонусами теперь рассчитываются совместно по товарам, категориям и всему заказу, с применением самого строгого ограничения.
[*] Обновлены тексты настроек и уведомлений, чтобы понятнее разделять товарные лимиты, общий лимит по заказу и сгорание баллов.
[!] Исправлено:.
[!] Исправлена работа миграций модуля и шаблона cron-команды в текущем шаблоне модуля.
v1.5.4 от 2026-04-08
[*] Модуль приведён к текущему шаблону make shop.
[*] Изменения схемы базы данных перенесены в миграции.
[*] Обновлены админская документация и иконка модуля.
v1.5.3 от 2023-10-21
[+] Добавлено:.
[+] Добавлена поддержка UniTheme2 на страницах корзины и оформления заказа.
[*] Модуль стандартизирован и переведён на обычные PHP-теги.
v1.5.2 от 2022-12-26
[*] Продолжена стандартизация модуля.
v1.5.1 от 2022-10-09
[*] Продолжена стандартизация модуля.
v1.5.0 от 2022-01-27
[+] Добавлено:.
[+] Добавлено начисление бонусов для способов оплаты через отдельное поле в настройках способа оплаты.
v1.4.3 от 2021-09-08
[*] Обновлено название модуля.
v1.4.2 от 2021-09-07
[*] Обновлена иконка make shop.
v1.4.1 от 2021-07-05
[!] Исправлено:.
[!] Исправлена ошибка при установке шаблонов модуля.
v1.4.0 от 2021-07-05
[+] Добавлено:.
[+] Добавлен показ бонусов в карточке товара для гостей, которые смогут получить их после авторизации.
v1.3.2 от 2021-07-05
[*] Изменён внешний вид уведомления при регистрации.
v1.3.1 от 2021-06-26
[+] Добавлено:.
[*] Если ограничения не заданы у товара или категории, модуль может использовать настройки родительской категории с учётом параметров основного модуля бонусных баллов.
v1.3.0 от 2021-06-18
[+] Добавлено:.
[+] Добавлены ограничения оплаты бонусами для товаров и категорий.
v1.2.1 от 2021-06-17
[*] Доработано глобальное ограничение оплаты бонусами от суммы заказа.
v1.2.0 от 2021-06-07
[+] Добавлено:.
[+] Добавлено глобальное ограничение оплаты бонусами от суммы заказа.
[+] Добавлены бонусы за регистрацию.
v1.1.0 от 2021-05-31
[*] Проведён рефакторинг кода.
v1.0.0 от 2021-05-27
[+] Добавлено:.
[+] Первое издание модуля.
Обозначения:
[+] Добавлено
[-] Удалено
[*] Изменено
[!] Исправлена ошибка