[Discontrol] - Контроль скидок магазина

Система скидок для магазинов* на MODX Revolution


* Система скидок позволяет работать с любым магазином на MODX Revolution. Действующая версия содержит обработчики только для магазина [miniShop2]

Скидки на продукт
Приложения >> Контроль скидок >> Вкладка «Скидки на Продукт».
Панель управления скидками на продукт.
Доступно:

• сортировка по группе пользователя
• сортировка по классу опций продукта
• поиск по описанию, классу, ключу, значению

Окно редактирования скидки на продукт.

• группа пользователя
• класс опции продукта
• ключ опции продукта
• значение опции продукта
• сравнение
• скидка продукта
• условие
• описание

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

[msProductData] = array(
	0 => 10,
	1 => 35,
	2 => 20
	)
	[msVendor] = array(
	0 => 16
	)
	[msProductOption] = array(
	0 => 50,
	1 => 10
	)

Где ключ массива — класс опции продукта, а значения — возможные скидки на продукт.
Для расчета скидки используется настройка product_option_expression вида:

max~$msProductOption + max~$msProductData + max~$msVendor

в данном случае рузультат общей скидки по группе пользователя на продукт представляет из себя сумму максимальных
скидок. Записывается в переменную groups и для расчета итоговой скидки используется настройка
product_group_expression вида:

max~$groups

Итоговая скидка на продукт равна максимальной скидке на продукт по группам пользователя.
Пример задания скидки на продукт.
Постановка на скидку оптовикам:

• дать скидку на продукты бренда «adidas» 10%
  Создаем скидку с параметрами:
  [x] группа Оптовики
  [x] класс msVendor
  [x] ключ name
  [x] значение adidas
  [x] скидка 10%
  [x] сравнение (string) — Равно
  
• дать скидку на все продукты нового поступления скидку 5%
  Создаем скидку с параметрами:
  [x] группа Оптовики
  [x] класс msProductData
  [x] ключ new
  [x] значение 1
  [x] скидка 5%
  [x] сравнение (integer) — Равно
  
• дать скидку на все продукты стоимостью более «3 000 руб.» 10%
  Создаем скидку с параметрами:
  [x] группа Оптовики
  [x] класс msProductData
  [x] ключ price
  [x] значение 3000
  [x] скидка 10%
  [x] сравнение (float) — Больше
  
• дать скидку на все продукты c цветом «белый» 5%
  Создаем скидку с параметрами:
  [x] группа Оптовики
  [x] класс msProductOption
  [x] ключ value
  [x] значение белый
  [x] скидка 5%
  [x] сравнение (string) — Равно
  [x] условие {«key»:«color»}
  
• дать скидку на продукты категории «ботинки», «штиблеты» 100 у.е.
  Создаем скидку с параметрами:
  [x] группа Оптовики
  [x] класс modResource
  [x] ключ parent
  [x] значение [11,12] — где 11,12 id нужных нам категорий
  [x] скидка 100
  [x] сравнение (mixed) — Присутствует
  

Скидки на заказ
Приложения >> Контроль скидок >> Вкладка «Скидки на Заказ».
Панель управления скидками на заказ.
Доступно:

• сортировка по группе пользователя
• сортировка по классу опций заказа
• поиск по описанию, классу, ключу, значению

Окно редактирования скидки на заказ.

• группа пользователя
• класс опции заказа
• ключ опции заказа
• значение опции заказа
• сравнение
• скидка заказа
• условие
• описание

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

[msSessionCart] = array(
	0 => 100,
	1 => 350,
	2 => 200
	)
	[msCustomerProfile] = array(
	0 => 160
	)
	[msOrder] = array(
	0 => 500,
	1 => 100
	)

Где ключ массива — класс опции заказа, а значения — возможные скидки на заказ.
Для расчета скидки используется настройка order_option_expression вида:

max~$msSessionCart + max~$msCustomerProfile + max~$msOrder

в данном случае рузультат общей скидки по группе пользователя на заказ представляет из себя сумму максимальных
скидок. Записывается в переменную groups и для расчета итоговой скидки используется настройка
order_group_expression вида:

max~$groups

Итоговая скидка на заказ равна максимальной скидке на заказ по группам пользователя.
Пример задания скидки на заказ.
Постановка на скидку оптовикам:

• дать скидку на заказ при сумме в корзине больше «20 000 руб.» 10%
  Создаем скидку с параметрами:
  [x] группа Оптовики
  [x] класс msSessionCart
  [x] ключ total_cost
  [x] значение 20000
  [x] скидка 10%
  [x] сравнение (float) — Больше
  

• дать скидку на заказ при кол-ве в корзине товаров больше «20 шт.» 10%
  Создаем скидку с параметрами:
  [x] группа Оптовики
  [x] класс msSessionCart
  [x] ключ total_count
  [x] значение 20
  [x] скидка 10%
  [x] сравнение (float) — Больше
  

• дать скидку на заказ при наличии ранее покупок на сумму свыше «50 000 руб.» 20%
  Создаем скидку с параметрами:
  [x] группа Оптовики
  [x] класс msCustomerProfile
  [x] ключ spent
  [x] значение 50000
  [x] скидка 20%
  [x] сравнение (float) — Больше
  

• дать скидку на заказ при наличии заказов оплаченных ранее через «Яндекс Кассу» 5%
  Создаем скидку с параметрами:
  [x] группа Оптовики
  [x] класс msOrder
  [x] ключ delivery
  [x] значение 2
  [x] скидка 5%
  [x] сравнение (integer) — Равно
  [x] условие {«status»:2}
  

Сравнение
Приложения >> Контроль скидок >> Вкладка «Сравнение».
Панель управления сравнениями опций.
Доступно:

• поиск по описанию, названию

Окно редактирования сравнения опций.

• имя сравнения
• тип значений сравнения
• выражения сравнения
• переменные
• описание

Расчет сравнения опций.
Для сравнения применяется заданное выражение. Доступные переменные:

• c — значение полученной опции
• v — значение заданное для сравнения

Сравнение истинно при результате вычисления отличного от нуля — результат вычисления скидки помещается в массив
скидок или же сравнение ложно — скидка не вычисляется.
При сравнении учитывается заданный тип данных, доступны string, integer, float.
Так же вы можете составить свое собственное сравнение с использованием дополнительных переменных заданных через
параметр переменные (json строка)*.
Операторы сравнения.
Доступные операторы:

• + сложение
• - вычитание
• * умножение
• / деление
• = равно
• != не равно
• < меньше
• > больше
• in присутствует в массиве
• !in не присутствует в массиве
• min~ наименьшее значение
• max~ наибольшее значение
• sum~ сумма значений
• shift~ первое значение
• pop~ последнее значение
• rand~ рандомное значение

Настройка
Системные настройки >> discontrol
Раздел «Основные» настройки.

• product_classes классы продукта
  Список классов продукта через запятую.
  По умолчанию доступно modResource,msProductData,msVendor,msProductOption,msSessionCar
  
• order_classes классы заказа
  Список классов заказ через запятую.
  По умолчанию доступно msCustomerProfile,msOrder,msSessionCart
  

Раздел «Скидка» настройки.

• allow_zero_price разрешить нулевую стоимость продукта
  Разрешить нулевую стоимость продукта в результате скидки.
  
• allow_zero_cost разрешить нулевую стоимость заказа
  Разрешить нулевую стоимость заказа в результате скидки.
  
• product_option_expression выражение расчета скидки по опциям продукта
  Результат скидки будет помещен в массив groups.
  По умолчанию max~$msProductOption + max~$msProductData + max~$msVendor — сумма максимальных скидок.
  
  
• product_group_expression выражение расчета скидки по группе пользователя
  Результат скидки является окончательным.
  По умолчанию max~$groups — максимальное значение из возможных.
  
• order_option_expression выражение расчета скидки по опциям заказа
  Результат скидки будет помещен в массив groups.
  По умолчанию max~$msSessionCart + max~$msCustomerProfile + max~$msOrder — сумма максимальных скидок.
  
  
• order_group_expression выражение расчета скидки по группе пользователя
  Результат скидки является окончательным.
  По умолчанию max~$groups — максимальное значение из возможных.
  

Проверка
Приложения >> Контроль скидок >> Вкладка «Скидки на Продукт» >> Вкладка «Проверка»
Приложения >> Контроль скидок >> Вкладка «Скидки на Продукт» >> Вкладка «Проверка»
Проверка скидок.
Для продуктов и заказав реализована панель проверки скидок.

Доступно:

• выбор пользователя
• выбор продукта
• выбор магазина
• переменные

* выражение расчета скидки по опции

	* выражение расчета скидки по группе

	* дополнительные переменные

	Можно указать в виде json строки с указанием класса скидки, ключа и значения

Пример проверки скидки на продукт.
Проверить величину скидки незарегистрированного пользователя на «продукт 1»
Задаем следующие параметры:
[x] пользователь Нет
[x] продукт «продукт 1»
В окне расчета появится лог расчета скидки на продукт.

[user:groups] [0]
	[discounts] [{"msProductData":["5"]}]
	[option:expression] max~$modResource + max~$msProductOption + max~$msProductData + max~$msVendor +
	max~$msSessionCart
	[group:discounts] [5]
	[group:expression] max~$groups
	[price:evaluate] 50
	[discount:evaluate] 5
	[newprice:evaluate] 45

Расшифровка лога расчета:

• [user:groups] группы пользователя
  

  [user:groups] [0]

  получена группа 0
  
• [discounts] скидки продукта по опциям
  

  [discounts] [{"msProductData":["5"]}]

  для данного продукта действует скидка 5 у.е. по классу msProductData
  
• [option:expression] выражение для расчета скидки по опциям
  

  [option:expression] max~$modResource + max~$msProductOption + max~$msProductData + max~$msVendor +
  			max~$msSessionCart

  дефолтное значение для расчета скидки, равно сумме всех максимальных значений по опциям продукта
  
• [group:discounts] скидки продукта по группам
  

  [group:discounts] [5]

  получена скидка 5 у.е.
  
• [group:expression] выражение для расчета скидки по группам
  

  [group:expression] max~$groups

  максимальное значение из возможных
  
• [price:evaluate] стоимость продукта
  

  price:evaluate] 50

  получена стоимость продукта 50 у.е.
  
• [discount:evaluate] скидка продукта
  

  [discount:evaluate] 5

  получена скидка продукта 5 у.е.
  
• [newprice:evaluate] новая стоимость продукта
  

  [newprice:evaluate] 45

  получена новая стоимость продукта 45 у.е.
  

Пример проверки скидки на заказ.
Проверить величину скидки незарегистрированного пользователя на «заказ» при сумме покупок 5500 у.е.

Задаем следующие параметры:
[x] пользователь Нет
[x] магазин «miniShop2»
[x] переменные

{"msSessionCart":{"total_cost":5500},"cost":5500}

В окне расчета появится лог расчета скидки на заказ.

[user:groups] [0]
	[discounts] [{"msSessionCart":["60"]}]
	[option:expression] max~$msCustomerProfile + max~$msOrder + max~$msSessionCart
	[group:discounts] [60]
	[group:expression] max~$groups
	[cost:evaluate] 5500
	[discount:evaluate] 60
	[newcost:evaluate] 5440

Расшифровка лога расчета:

• [user:groups] группы пользователя
  

  [user:groups] [0]

  получена группа 0
  
• [discounts] скидки продукта по опциям
  

  [discounts] [{"msSessionCart":["60"]}]

  для данного заказа действует скидка 60 у.е. по классу msSessionCart
  
• [option:expression] выражение для расчета скидки по опциям
  

  [option:expression] max~$msCustomerProfile + max~$msOrder + max~$msSessionCart

  дефолтное значение для расчета скидки, равно сумме всех максимальных значений по опциям заказа
  
• [group:discounts] скидки продукта по группам
  

  [group:discounts] [60]

  получена скидка 60 у.е.
  
• [group:expression] выражение для расчета скидки по группам
  

  [group:expression] max~$groups

  максимальное значение из возможных
  
• [cost:evaluate] 5500 стоимость заказа
  

  [cost:evaluate] 5500

  получена стоимость заказа 5500 у.е.
  
• [discount:evaluate] скидка заказа
  

  [discount:evaluate] 60

  получена скидка заказа 60 у.е.
  
• [newcost:evaluate] новая стоимость заказа
  

  [newcost:evaluate] 5440

  получена новая стоимость заказа 5440 у.е.
  

Скидки — Сниппет dcDiscounts
Сниппет dcDiscounts для информирования покупателей о полученных и возможных скидках.


Параметры сниппета:

• object — объект получения информации о скидке
  доступно msProduct и msOrder
  по умолчанию msOrder
  
• class — класс получения информации о скидке
  по умолчанию msSessionCart
  
• key — ключ получения информации о скидке
  по умолчанию total_cost
  
• comparison — сравнение
  вывод либо полученных скидок (true), либо возможных (false)
  по умолчанию true
  
• type — тип данных расчета
  доступно string, integer, float, mixed
  по умолчанию float
  
• expression — выражение подсчета
  в сниппете доступны следующие переменные:
  

  * v - значение указанное в скидке
  
  			* c - значение полученное по указанному ключу
  
  			* p - значение стоимости (продукта/ заказа)
  
  			* d - значение скидки (продукта/ заказа)

  по умолчанию $c — $v
  

• tplRow — чанк вывода информации о скидке
  по умолчанию
  

  @INLINE
  			<div class="[[+comparison]]">[[+data.discount]] - [[+data.calc]]</div>

• tplOuter — чанк обертки
  по умолчанию
  

  @INLINE
  			<div>[[%discontrol_[[+object]]]] [[%discontrol_comparison_[[+comparison]]]]:
  				<div class="discontrol-discounts [[+selector]]" data-propkey="[[+propkey]]">[[+output]]</div>
  			</div>

• tplEmpty — чанк вывода информации об отсутствии скидок
  по умолчанию
  

  @INLINE
  			<div>No discounts</div>

• frontendCss — Файл с css стилями для подключения на фронтенд
  
• frontendJs — Файл с javascript для подключения на фронтенде
  
• selector — Имя CSS класса, который будет использован как jQuery селектор для инициализации
  
  
• limit — Лимит выборки результатов
  
• showLog — Вывод информации о работе сниппета в лог MODX
  

Пример вызова сниппета.
Постановка на скидку:

• скидка на продукт 4% при общей сумме заказа более 4000 у.е
• скидка на продукт 7% при общей сумме заказа более 20000 у.е

Вывод информации о полученных скидках на странице продукта

[[!dcDiscounts?
	&object=`msProduct`
	&comparison=`1`
	&expression=`$d`
	]]

Вывод информации о возможных скидках на странице продукта

[[!dcDiscounts?
	&object=`msProduct`
	&comparison=`0`
	&expression=`$v - $c`
	]]

p.s. Всем спасибо за внимание.

— Геозависимые скидки на продукт магазина
— Скидка по времени суток

max~$modResource + max~$msProductOption + max~$msProductData + max~$msVendor + max~$msSessionCart + max~$msSessionCartEx +
max~$modUser

(($time - $c)  / 60 / 60 / 24) > $v

[[!dcDiscounts?
&object=`msProduct`
&comparison=`1`
&expression=`$d`
]]

[[!dcDiscounts?
	&object=`msProduct`
	&comparison=`1`
	&expression=`$d`
	&class=`modResource,msVendor`	
]]

[[!dcDiscounts?
		&object=`msOrder`
		&comparison=`1`
		&class=`msSessionCart,msCustomerProfile`
		&expression=`$p-$d`
]]

[[!dcDiscounts? &object=`msProduct`	&expression=`$v`]]