Инструкция к модулю До подарка осталось

Что делает модуль

Модуль отслеживает промо-акции корзины и показывает покупателю прогресс до следующего бонуса. Он поддерживает условия по промежуточному итогу заказа и по количеству товаров в корзине, рассчитывает остаток до бонуса и передаёт эти данные в блоки витрины, мини-корзину и окно «Добавлено в корзину».

Для каждой акции можно включить отдельное уведомление, задать название для витрины и загрузить изображение. Если в магазине уже были старые блоки типа csc_promo_progressbar, модуль при обновлении переводит их на актуальный тип MS: До подарка осталось.

Где находится модуль

• Маркетинг → Промо-акции — здесь на странице акции появляется вкладка MS До подарка осталось.
• Модули → До подарка осталось → Настройки — общие параметры показа в окне «Добавлено в корзину» и компактного progress bar в корзине.
• Дизайн → Макеты / Менеджер блоков — добавление блока MS: До подарка осталось и выбор шаблона отображения.

Как настроить промо-акцию

1. Откройте Маркетинг → Промо-акции и создайте или отредактируйте именно промо-акцию корзины.
2. Убедитесь, что акция активна и её период действия подходит для теста.
3. На вкладке Условия задайте одно из поддерживаемых условий: например, Промежуточный итог заказа >= 1000 или Количество товаров в корзине >= 3.
4. На вкладке Бонусы настройте подарок или другой бонус, который должен стать доступным после достижения порога.
5. На вкладке MS До подарка осталось включите опцию Оповещать об акции.
6. При необходимости заполните поле Название акции на витрине. Если оставить его пустым, модуль возьмёт обычное название акции.
7. При необходимости загрузите Изображение для страницы акции, которое будет использоваться в витринных шаблонах.

Как настроить модуль

1. Откройте Модули → До подарка осталось → Настройки.
2. Включите Показать в окне «Добавлено в корзину», если хотите показывать прогресс сразу после добавления товара.
3. Включите Показывать компактный прогресс-бар в корзине, если в корзине должен отображаться отдельный лаконичный индикатор ближайшей акции.
4. Сохраните настройки.

Как разместить блок на витрине

1. Откройте Дизайн → Макеты / Менеджер блоков.
2. Добавьте блок MS: До подарка осталось в нужную зону страницы, чаще всего в корзину или в область, связанную с оформлением заказа.
3. Выберите шаблон блока в зависимости от сценария показа.

• Обычный блок — показывает прогресс по нескольким акциям одной основной метрики.
• Сводный блок — выводит список уже доступных бонусов и тех, до которых ещё нужно дойти.
• Одиночный блок — показывает одну выбранную акцию.
• Круговой блок и Круговой краткий блок — компактные варианты для одной выбранной акции.
• Компактный progress bar — узкий индикатор для ближайшей акции, который может работать автоматически или для конкретной выбранной акции.

Для шаблонов, работающих с одной акцией, в настройках блока доступно поле Промо-акция. В списке отображаются только акции корзины с включенной опцией Оповещать об акции.

Ограничения и важные условия

• Модуль работает только с промо-акциями корзины. Акции каталога в расчёт не попадают.
• Автоматический расчёт прогресса поддерживается для условий по сумме заказа и по количеству товаров.
• Если у акции зона не Корзина, модуль не сможет использовать её в витринных блоках.
• Если у акции выключена опция Оповещать об акции, она не попадёт в список выбора для блока.

Как проверить работу

1. Создайте тестовую промо-акцию корзины с бонусом и условием по сумме заказа или количеству товаров.
2. Включите в ней опцию Оповещать об акции и при необходимости задайте название для витрины.
3. Разместите блок MS: До подарка осталось на странице корзины или включите показ в окне «Добавлено в корзину».
4. Добавьте в корзину товары ниже порогового значения. На витрине должен появиться текст с остатком до бонуса.
5. Увеличьте сумму заказа или количество товаров до порога. Модуль должен показать, что бонус уже доступен.
6. Если используется шаблон с одной акцией, проверьте, что в настройках блока выбрана нужная промо-акция.

Что проверить, если модуль не показывает акцию

• Акция создана именно как промо-акция корзины, а не каталога.
• У акции активный период действия.
• На вкладке MS До подарка осталось включена опция Оповещать об акции.
• В условиях акции используется поддерживаемая метрика, то есть сумма заказа или количество товаров.
• После изменения настроек очищен кэш CS-Cart, если витрина не обновляет блок сразу.