Extended conditions and bonuses of promotion

Расширенные условия и бонусы промоакций

Расширенные условия и бонусы промоакций

Модуль добавляет в штатные промоакции CS-Cart новые условия и бонусы. Он не заменяет механизм промоакций и не создаёт своих: всё настраивается там же, где обычно, — в Маркетинг → Промоакции, в тех же формах условий и бонусов. Пункты модуля отмечены в списках префиксом [+], поэтому их легко отличить от штатных.

Условия позволяют привязать акцию к истории покупателя (количество и сумма его заказов в выбранном статусе, дни до и после дня рождения), к городу доставки, к количеству товаров в корзине и к остаткам на складе — по товару, по категории или по любому товару каталога. С модулем Поставщики добавляется условие по поставщику товара.

Бонусы начисляют бонусные баллы в процентах от заказа — покупателю или третьему лицу, ограничивают долю заказа, которую можно оплатить баллами, дают скидку только на товары выбранного поставщика, привязывают к заказу менеджера и делают доставку бесплатной для части корзины: для выбранных категорий, товаров, значений характеристики или товаров дороже заданной цены, при этом стоимость доставки считается по остальным позициям.

Глобальных настроек у модуля нет. Страница Модули → Модули CS-Commerce → Расширенные условия и бонусы промоакций показывает только служебный блок: установленную версию, наличие обновлений и срок подписки.

Условия и бонусы модуля подчиняются общим правилам промоакций CS-Cart: зона акции (каталог или корзина), приоритет, ограничение «применять один раз», совмещение с купонами. В документации описано только то, что добавляет модуль.
Совместимость

Модуль совместим со всей веткой CS-Cart 4.x и поддерживает редакции CS-Cart, CS-Cart Ultimate, Multi-Vendor, Multi-Vendor Plus и Multi-Vendor Ultimate. Модуль работает на стороне сервера, в формах промоакций панели администратора и при расчёте корзины, поэтому от темы витрины не зависит.

Часть возможностей появляется только вместе со штатными модулями CS-Cart:

  • бонусы Начислить бонусные баллы третьему лицу и Макс. % оплаты бонусными баллами от суммы заказа — при включённом модуле Бонусные баллы; бонус Начислить бонусные баллы в % также использует его для зачисления баллов;
  • условие Поставщик товаров и бонус Скидка на товары поставщика — при включённом модуле Поставщики.

Если соответствующий модуль выключен, его пункты в списках условий и бонусов не показываются.

На Multi-Vendor промоакции корзины общие для всех продавцов; в списке менеджеров для бонуса Привязать менеджера к заказу продавец видит только администраторов своей компании.

На данный момент нет информации о несовместимости модуля с какой-либо темой или другим модулем. В случае конфликта обращайтесь в наш центр поддержки.

Установка модуля

После оформления и оплаты, ваш заказ будет автоматически переведен в статус Оплачен в течение считанных минут. Статус заказа Оплачен означает активацию лицензии и вам на e-mail отправляется письмо с подтверждением о получении оплаты и письмо со ссылкой на скачивание модуля. Так же модуль всегда можно скачать в нашем разделе Управление лицензиями. Для установки модуля на ваш сайт, пожалуйста, выполните следующие шаги:

  1. Скачайте последнюю версию модуля на нашем сайте в разделе "Управление лицензиями" или по ссылке, отправленной по e-mail.
  2. Пройдите в раздел Модули → Управление модулями и в меню шестерёнки выберите Ручная установка.
  3. Выберите ранее скачанный файл и завершите установку модуля.

На этом установка модуля завершена. Для перехода на страницу настроек модуля выберите установленный модуль в разделе Модули → Модули CS-Commerce

Управление модулем

Всё, что добавляет модуль, находится в форме промоакции: Маркетинг → Промоакции, откройте акцию или создайте новую, затем на вкладке Условия нажмите Добавить условие, а на вкладке БонусыДобавить бонус. Пункты модуля в выпадающих списках помечены префиксом [+].

Набор доступных пунктов зависит от зоны промоакции, выбранной при её создании:

  • Каталог — условия проверяются для каждого товара отдельно, бонус применяется к товару; здесь доступны условия по остаткам, по поставщику и бонус начисления баллов за товар;
  • Корзина — условия проверяются для корзины целиком при оформлении; здесь доступны условия по покупателю, городу и корзине и все остальные бонусы.

Подробно по разделам:

  • Условия для промоакций корзины — город доставки, дни рождения, заказы покупателя, количество товаров, остатки;
  • Условия для промоакций каталога — остатки по товару, категории и любому товару, поставщик;
  • Бонусы — бонусные баллы, менеджер, скидка на товары поставщика;
  • Бонус «Бесплатная доставка для части корзины» — отдельный раздел, поскольку у бонуса своя форма из нескольких полей.

Страница модуля Модули → Модули CS-Commerce → Расширенные условия и бонусы промоакций настроек не содержит: на ней показываются установленная версия, наличие обновлений и срок подписки, а также ссылки на документацию и центр поддержки. Та же страница открывается по кнопке настроек модуля в списке Модули → Управление модулями.

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

Условия для промоакций корзины

Условия ниже доступны в промоакциях с зоной Корзина. Каждое условие настраивается как штатное: выбирается оператор сравнения и значение.

Город доставки

Сравнивает город из адреса доставки, который покупатель указал при оформлении, с введённым текстом. Операторы: равно, не равно, входит в список, не входит в список — для списка города перечисляются через запятую. Сравнение идёт по тексту поля, поэтому название должно совпадать с тем, как его вводят покупатели.

Дней до дня Рождения и Дней после дня Рождения

Оба условия работают в паре с полем профиля типа Дата: в условии выбирается поле (например, «Дата рождения» из раздела «Контактная информация»), оператор и число дней. Модуль берёт из даты только день и месяц и считает, сколько дней осталось до ближайшего дня рождения или прошло после последнего. Так можно, например, дать скидку за неделю до праздника (Дней до дня Рождения меньше или равно 7) и в течение недели после него.

Условия рассчитаны на авторизованных покупателей с заполненным полем даты. Для гостя и для покупателя без даты модуль возвращает 2000 дней — такое значение не проходит ни одну разумную проверку «меньше или равно», и акция не срабатывает.

Кол-во заказов в статусе

Считает заказы покупателя в выбранном статусе — например, число выполненных заказов — и сравнивает с введённым значением. Статус выбирается из списка статусов заказов магазина. Условие позволяет строить акции для постоянных покупателей: «третий заказ — бесплатная доставка» или скидка после пяти выполненных заказов.

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

Сумма всех заказов в статусе

Суммирует итоговые суммы заказов покупателя в выбранном статусе и сравнивает с введённым значением. Для гостя условие не выполняется никогда.

Кол-во товаров в корзине

Общее количество единиц товара в корзине — сумма количеств по всем позициям, а не число строк. Пять штук одного товара дают значение 5.

Кол-во товара на складе

Выбирается конкретный товар. Условие проверяет, есть ли этот товар в корзине, и если есть — сравнивает его текущий остаток на складе с введённым значением. Если товара в корзине нет, условие не выполняется. Так можно, например, включать акцию на товар, пока его остаток превышает заданный порог.

Количество товара на складе по категории

Выбирается категория; подкатегории учитываются автоматически. Условие находит в корзине первый товар из этой категории и сравнивает его остаток на складе с введённым значением. Проверяется только один товар — первый подходящий по порядку в корзине, остальные товары той же категории не рассматриваются.

Условия для промоакций каталога

Условия ниже доступны в промоакциях с зоной Каталог. Они проверяются для каждого товара отдельно, поэтому акция срабатывает на одних товарах и не срабатывает на других.

Кол-во товара на складе

Выбирается конкретный товар. Для него условие сравнивает остаток на складе с введённым значением; для всех остальных товаров условие не выполняется. Подходит для акции на один товар, которая должна действовать только при определённом остатке.

Количество товара на складе по категории

Выбирается категория; подкатегории учитываются автоматически. Для товаров из этой категории условие сравнивает их собственный остаток с введённым значением, для остальных товаров не выполняется.

Количество на складе

Условие без выбора товара: сравнивает остаток каждого товара каталога с введённым значением. Так одной акцией можно, например, дать скидку на все товары, которых на складе больше 100 штук, или, наоборот, отметить последние экземпляры.

Поставщик товаров

Показывается при включённом модуле Поставщики. Выбирается поставщик из списка активных; операторы — равно и не равно. Условие выполняется для товаров, привязанных к этому поставщику.

Остаток берётся из поля «Количество» товара в момент проверки. Для товаров с отслеживанием остатка по опциям (вариациям) сравнивается общее количество товара, а не количество конкретной комбинации.

Бонусы

Бонусы модуля добавляются на вкладке Бонусы промоакции. Кроме бонуса начисления баллов за товар, все они относятся к зоне Корзина.

Начислить бонусные баллы в %

Начисляет покупателю дополнительные бонусные баллы за заказ. Размер задаётся как у штатной скидки: в процентах или фиксированным числом, от суммы товаров в корзине; дробная часть отбрасывается. Баллы добавляются к тем, что покупатель получает по правилам модуля Бонусные баллы, и зачисляются вместе с ними при переходе заказа в статус, начисляющий баллы.

В промоакциях каталога есть одноимённый бонус: он считает баллы от стоимости конкретного товара (цена, умноженная на количество в корзине) и начисляет их за этот товар.

Привязать менеджера к заказу

Выбирается администратор из списка. Заказ, оформленный по такой акции, записывается как выписанный этим менеджером — так же, как если бы он создал заказ из панели администратора. Это удобно для учёта заказов по каналам: например, акция с промокодом от конкретного менеджера или партнёра. На Multi-Vendor продавец видит в списке только администраторов своей компании.

Скидка на товары поставщика

Показывается при включённом модуле Поставщики. Выбирается поставщик и размер скидки — в процентах или фиксированный. Скидка применяется только к тем позициям корзины, товары которых привязаны к этому поставщику; остальные позиции не меняются. Позиции, исключённые из расчёта (например, подарки других акций), пропускаются.

Начислить бонусные баллы третьему лицу

Показывается при включённом модуле Бонусные баллы. Выбирается пользователь, которому начисляются баллы, и размер — в процентах от суммы заказа или фиксированный. Баллы начисляются не покупателю, а выбранному пользователю, и не сразу: при переходе заказа в статус, у которого включено начисление бонусных баллов. Если заказ потом переводится в статус без начисления (отмена, возврат), те же баллы списываются. В истории баллов пользователя операции подписаны как «Пополнение за счет бонусов промоакции» и «Уменьшение бонусов промоакции: заказ отменен» с номером заказа.

Так строятся реферальные и партнёрские схемы: покупатель оформляет заказ с промокодом партнёра, а партнёр получает процент от суммы заказа баллами.

Макс. % оплаты бонусными баллами от суммы заказа

Показывается при включённом модуле Бонусные баллы. Вводится процент от 1 до 99. Пока действует промоакция, покупатель не может оплатить баллами больше указанной доли заказа: если он применил больше, количество баллов уменьшается до допустимого, а на странице показывается предупреждение По условиям промоакции бонусными баллами можно оплатить не более … % от суммы заказа. Количество применённых баллов уменьшено до …. Если под корзину подошло несколько акций с таким бонусом, действует наименьший процент.

Бесплатная доставка для части корзины

Описан в отдельном разделе Бонус «Бесплатная доставка для части корзины».

Бонус «Бесплатная доставка для части корзины»

Штатный бонус CS-Cart Бесплатная доставка делает бесплатной доставку всего заказа. Бонус модуля работает точечно: он помечает подходящие позиции корзины как бесплатные для доставки, а стоимость доставки считается только по остальным позициям. Если под бонус попали все позиции, доставка бесплатна целиком. Бонус доступен в промоакциях с зоной Корзина, появился в версии 1.6.0.

Поля бонуса

  • Категории — одна или несколько категорий; подкатегории учитываются автоматически.
  • Товары — отдельные товары.
  • Характеристика товара и Варианты характеристики — характеристика с выбираемыми значениями (например, «Бренд») и нужные варианты. Если варианты не выбраны, подходит любой товар, у которого эта характеристика заполнена.
  • Цена товара от — нижний порог цены позиции.
  • Способы доставки — способы, для которых действует бонус. Если ничего не выбрано, бонус действует для способов с включённым параметром Использовать для бесплатной доставки; выбранные способы на время действия промоакции считаются такими автоматически.

Как определяется подходящая позиция

Позиция корзины подходит, если она входит хотя бы в один из заполненных списков — категории, товары или характеристика — и её цена не ниже значения Цена товара от. Если ни один список не заполнен, подходят все позиции с такой ценой; если не заполнен и порог цены — все позиции корзины. Проверяется цена позиции в корзине — с учётом выбранных опций.

Как считается доставка

Подходящие позиции получают признак бесплатной доставки — тот же, что даёт галочка «Бесплатная доставка» в карточке товара. Ядро CS-Cart исключает такие позиции из пакета: их стоимость, вес и количество не участвуют в расчёте тарифа, а для служб с расчётом в реальном времени в запрос уходят только платные позиции. Если платных позиций не осталось, стоимость доставки равна нулю; для служб реального времени модуль дополнительно следит, чтобы способ не пропал из списка из-за пустого запроса.

На Multi-Vendor корзина разбита на группы по продавцам; бонус действует внутри каждой группы отдельно, и бесплатной становится часть доставки того продавца, чьи товары подошли.

Взаимодействие со способами доставки

Признак бесплатной доставки у позиции учитывается только теми способами, у которых включён параметр Использовать для бесплатной доставки (штатная настройка способа в Администрирование → Доставка и налоги → Способы доставки). Для остальных способов доставка считается по полной корзине, как будто бонуса нет. Поэтому либо включите этот параметр у нужных способов, либо перечислите их в поле Способы доставки бонуса — тогда модуль сам считает их подходящими на время расчёта.

Пример

Задача: бесплатная доставка СДЭК по товарам бренда «Acme», остальные товары в заказе — по обычному тарифу.

  1. Создайте промоакцию с зоной Корзина. Условия можно не задавать, если акция действует для всех.
  2. Добавьте бонус [+] Бесплатная доставка для части корзины.
  3. В поле Характеристика товара выберите «Бренд», в вариантах — «Acme».
  4. В поле Способы доставки отметьте СДЭК и сохраните промоакцию.

Покупатель кладёт в корзину товары Acme и товары других брендов: тариф СДЭК рассчитывается по товарам других брендов. Если в корзине только Acme — доставка СДЭК бесплатна.

Если под корзину подошли несколько промоакций с этим бонусом, их выборы складываются: позиция считается бесплатной, если подошла хотя бы под одну, а способы доставки объединяются. Товары, у которых бесплатная доставка включена в карточке, остаются бесплатными независимо от бонуса.

Обновление модуля

Для того, чтобы иметь доступ к обновлениям модуля, у вас должен быть активный период подписки на обновления. При истекшем периоде подписки, вам будут доступны только обновления, выпущенные до даты истечения вашей подписки. Продлить подписку на обновления можно в разделе "Управление лицензиями" на нашем сайте. 

Модуль поддерживает поставку обновлений через Центр обновлений CS-Cart. О выходе новых версий модуля вас оповестит встроенный Центр уведомлений Cart (колокольчик). Обновление модуля с помощью Центра обновлений позволит без потерь настроек данных модуля произвести переход на более новую версию модуля.

Непосредственно перед обновлением, крайне рекомендуется делать полный бэкап сайта (базы данных и файлов) вашего магазина средствами сервера или хостинга.

Обновление модуля через Центр обновлений:

  1. В верхнем меню пройдите в раздел Администрирование → Центр обновлений;
  2. В меню шестеренки нажмите "Проверить доступные обновления"
  3. Cреди списка доступных обновлений найдите нужное и нажмите кнопку Обновить;
  4. Следуйте всем инструкциям, которые будут показаны при процедуре обновления;
  5. Рекомендуется произвести очистку кэша CS-Cart после завершения устанвоки обновлений удалением папки var/cache на вашем сервере или добавлением в адресную строку параметра ctpl (прмиер: https://domain.com/admin.php?ctpl).

Переустановка модуля удалением:

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

Для полной переустановки модуля без сохранения данных выполните следующие шаги:

  1. Пройдите в раздел Модули → Управление модулями и найдите старый установленный модуль.
  2. Нажмите в меню шестеренки модуля кнопку удалить.
  3. Скачайте последнюю версию модуля на нашем сайте в разделе "Управление лицензиями".
  4. Пройдите в раздел Модули → Управление модулями и в меню шестеренки выберите Ручная установка.
  5. Выберите ранее скачанный файл и завершите установку модуля.

Техническая поддержка

Техническая поддержка модуля уже включена в его стоимость. Прежде чем обращаться в центр поддержки, пожалуйста, убедитесь что вы используете последнюю выпущенную версию модуля. Старые версии  модуля не обслуживаются технической поддержкой.

Для того, чтобы воспользоваться нашей технической поддержкой, выполните следующие шаги:

  1. На нашем сайте центра поддержки https://helpdesk.cs-commerce.com/ авторизуйтесь под своей учетной записью;
  2. Нажмите на кнопку "Новая заявка";
  3. Заполните все необходимые поля и создайте заявку (Вы получите на e-mail письмо с подтверждением);
  4. Ожидайте ответ специалиста (на ваш e-mail придет уведомление об ответе на вашу заявку) в соответствии с регламентами работы службы техподдержки.

Если Вы не получили ответ в течении сроков, обозначенных в регламентах, напишите нам на e-mail [email protected] сообщение с темой заявки и мы постараемся решить вас вопрос в ближайшее время.

Техническая поддержка по диалогу в чате на сайте, прямым телефонным обращениям или e-mail письмам не осуществляется. Вся помощь проходит через центр поддержки. Внимательно изучайте документацию к модулю и условия технической поддержки перед созданием обращения.

Ограничения и предупреждения

Рекомендуем ознакомиться с общими ограничениями:

  1. Фрагменты кода  или некоторые файлы модуля могут иметь закрытую (закодированную) часть. Закодированная часть не создает проблемы в доработке модуля;
  2. Модуль будет работать только на тех доменах, которые указаны в лицензии пользователя. При попытке использования решения на установках CS-Cart, домены которых не включены в лицензию, модуль будет автоматически выключен;
  3. Установка локально не допускается системой лицензирования. Чтобы модуль работал на дополнительном домене (псевдониме) укажите этот псевдоним на странице управления лицензиями. На один домен допускается указать до трех псевдонимов для нужд тестирования и разработки.
  4. Главный домен лицензии вы можете менять самостоятельно на странице управления лицензиями. 
Для доступа к изменению/добавлению доменов и псевдонимов лицензии, подписка на обновления должна быть активной. Для изменения домена лицензии с истекшим периодом подписки, сначала необходимо продлить подписку на обновления. 

 

История версий

Версия 1.6.0 от 21 сентября 2026 года

  • Добавлен бонус промоакции «Бесплатная доставка для части корзины»: доставка становится бесплатной только для выбранных категорий, товаров, значений характеристики или товаров дороже заданной цены, а стоимость доставки считается по остальным позициям заказа; если под условия попали все позиции, доставка бесплатна целиком.
  • Добавлена совместимость с PHP 8.3.
  • Исправлено условие «Кол-во товара на складе» для корзины: промоакция срабатывала, даже если выбранного товара в корзине не было.
  • Обновлён служебный блок модуля: информация о версии, подписке и обновлениях в настройках модуля.

Версия 1.5.3 от 5 августа 2026 года

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

Версия 1.5.2 от 5 июня 2026 года

  • Базовые обновления стабильности и безопасности модуля.
  • Добавлена совместимость с PHP 8.3.

Версия 1.5.1 от 18 июля 2025 года

  • Исправлена несуществующая языковая переменная.

Версия 1.5.0 от 16 июля 2025 года

  • Добавлена возможность начислять бонусные баллы третьим лицам за заказ.

Версия 1.4.0 от 27 мая 2025 года

  • Базовые обновления безопасности модуля.

Версия 1.3.1 от 22 марта 2024 года

  • Добавлено условие «Количество товара на складе по категории» для корзины.

Версия 1.3.0 от 21 марта 2024 года

  • Добавлено условие «Количество товара на складе по категории».
  • Добавлено условие «Количество на складе».
  • Исправлены некоторые ошибки условий промоакций.
  • Базовые обновления безопасности модуля.

Версия 1.2.0 от 17 апреля 2023 года

  • Добавлен новый бонус: «Скидка на товары поставщика».

Версия 1.1.0 от 6 апреля 2023 года

  • Новое условие промоакции: «Поставщик товаров» (работает с модулем «Поставщики»).

Версия 1.0.1 от 3 августа 2022 года

  • Улучшен внешний вид для CS-Cart 4.11.x и выше.
  • Базовое обновление безопасности.

Версия 1.0 от 12 мая 2021 года

  • Первый релиз модуля.