IMDiscount - Стратегія знижок для OpenCart

Модуль IMDiscount (OC 3) Стратегія знижок – це потужний інструмент для організації гнучкої системи знижок OpenCart. Він дозволяє створювати накопичувальні знижки та знижки на поточне замовлення, а також підтримує масову генерацію стандартних знижок та акцій. Цей модуль підійде інтернет-магазинам, які хочуть стимулювати повторні покупки та гнучко керувати цінами.

Основні можливості

• Накопичувальні знижки та знижки у поточному замовленні
• Гнучкі модулі для відображення інформації про знижки
• Масова генерація знижок та акцій OpenCart
• Налаштування умов за кількістю та сумою товарів
• Три режими акумуляції (велика, менша знижка та сума)
• Можливість використовувати відсотки та фіксовані суми одночасно
• Фільтри по клієнтам, періодам, статусам замовлень та товарам
• Різні варіанти підрахунку сум та кількості товарів
• Фільтрування за групами користувачів
• Три варіанти підрахунку відсотків: за модулями обліку, за товарами без знижок, за всіма товарами
• Гнучкі налаштування застосування знижок та їх округлення
• Підтримка багатозадачності завдяки використанню AJAX
• Повна сумісність із OpenCart без перезапису ядра

Порядок створення стратегій

Загалом, порядок створення стратегій схожий на звичайне уявлення OpenCart, але з урахуванням того, що в модулі практично все зроблено з використання ajax (без необхідності перевантажувати сторінку).

1. Відкриваєте вкладку «Всі стратегії» та створюєте стратегію потрібного типу та назви (з іншими полями).
2. Знаходьте у списку потрібну стратегію та натискаєте кнопку зліва (редагувати). Або ж відкриваєте вкладку з відповідним типом стратегій, знаходите потрібну у верхньому списку, після чого натискаєте поруч кнопку «Завантажити».
3. Заповнюєте додаткові параметри підрахунку та обліку, а також таблицю знижок і натискаєте кнопку «Зберегти».

ВАЖЛИВО! - Усі коригування застосовуються відразу!

З версії 1.4.0 можна створювати стратегії або їх копії у відповідних вкладках без обов'язкового створення через вкладку «Всі стратегії». Для цього потрібно натискати кнопку "Додати" замість "Зберегти".

Як здійснюється підрахунок

Підрахунок здійснюється у два етапи, що дозволяє будувати дуже гнучкі стратегії знижок (приклад розрахунку трохи нижче).

Перший етап

Спочатку завантажуються всі стратегії знижок (критерій - включені і підходять за датою, а так само специфічні параметри в ході розрахунків). Виглядає таблиця знижок кожної стратегії. І для кожного рядка обчислюється відсоток та фіксована сума. З цих двох чисел вибирається максимальне.

Потім усередині кожної стратегії визначено, яким чином вибирати «Тип формування відсотка» (більше значення, менше або сумарне за всіма значеннями таблиці знижок з першого етапу). Відповідно, з раніше обчислених знижок у таблиці формується результуюча знижка стратегії (відповідно до обраного налаштування).

Другий етап

Коли отримані всі знижки за діючими стратегіями, виглядає глобальний параметр у налаштуваннях - Тип акумуляції (Глобально). І, відповідно, обчислюється підсумкова знижка (більша, менша або сума знижок).

ВАЖЛИВО! Знижка не може бути більшою, ніж значення ДО застосування модуля IMDiscount. Зроблено для того, щоб не виникало замовлень із від'ємною вартістю.

Приклад розрахунку

Допустимо, вам потрібно враховувати два варіанти знижок. Перший, ті знижки, що формуються за накопиченими замовленнями і використовуються для суми всіх продуктів замовлення (за кожні 1000 рублів 1%, до 10%). Другий, додаткова знижка в рамках поточного замовлення тільки для товарів без акцій та знижок (з кожною 1000 так само по 1%, до 10%). При цьому потрібно, щоб знижки підсумовувалися.

Відповідно, у модулі виставляються такі налаштування. Тип акумуляції (Глобально) – підсумовування. Щоб знижки стратегій підсумовувалися. Створюються та заповнюються дві стратегії – одна в «Накопичувальна знижка», друга в «Поточне замовлення». Для кожної стратегії також заповнюється таблиця знижок із зазначенням відсотка та фіксованої суми (у прикладі останнє дорівнює 0, оскільки завдання цього не вимагає).

Покупець робить замовлення на 3456 рублів, у тому числі 1000 рублів це товари зі знижкою. Також покупець вже здійснив кілька замовлень на загальну суму 7000 рублів.

Відбувається наступний розрахунок:

Перший етап. Так як застосовуються лише відсотки, то завжди буде вибиратися відсоток для кожного рядка таблиці стратегії знижок.

Виходячи з даних, у таблиці першої стратегії підходять усі пункти від 1% до 7%. Вибирається максимум тобто. 7%. У другій стратегії знижок враховуються лише звичайні товари (2456 крб), тобто. підходять лише знижки з таблиці 1% та 2%. Відповідно, вибирається максимум 2%.

Другий етап. Виглядає глобальний параметр, а там підсумовування. Виходить 7% від 3456 + 2% від 2456 = 241,92 + 49,12 = 291,04.

Як бачите, складна схема розрахунків легко реалізується модулем.

Як формується відсоток

Існує три типи сум, в загальному випадку (для N-товар див. нижче):

1. Проміжна сума з урахуванням порядку застосування модуля. Таким чином, якщо у відсоток потрібно включати доставку, бонуси та інше, то варто використовувати цей тип знижки та вказувати потрібний порядок проходження модуля (після доставки, бонусів та іншого).
2. Відсоток суми товарів без знижок. Якщо у вас існують спеціальні пропозиції (стандартні знижки) або акції для товару, що діють, то цей варіант дозволяє не враховувати такі товари при розрахунку знижки.
3. Відсоток від усіх товарів. Якщо вам потрібно враховувати лише весь товар, без методів доставки та іншого.

Відповідно, залежно від вибраного варіанта, обчислюється відсоток.

Поточне замовлення - розрахунок відсотка - Кожен N-товар (знижка від найдорожчих або найдешевших)

Якщо вам необхідно організувати знижки для кожного N-товару у сортуванні від найдорожчих до дешевших або навпаки від найдешевших, то це можливо зробити.

Наприклад, для кожної другої пари рукавичок надавати знижку 50% у порядку від дорогих до дешевих. У такому випадку, якщо клієнт додав до кошика 20 простих рукавичок і 8 рукавичок з яким-небудь дорогим візерунком (тобто знижка для 14 товарів = 28/2), то знижка буде обчислюватися наступним чином: 0,5* вартість 8 дорогих рукавичок з візерунком + 0,5*.

У межах цього розрахунку, також враховується тип підрахунку кількості товарів, щоб можна було виключити товари, які вже існують знижки (від кількості; акції). Плюс зберігається весь алгоритм розрахунку таблиці знижок та інших механізмів.

Фільтрування товарів (включення, виключення) у стратегії знижок Поточне замовлення

Як відбувається фільтрація Насамперед перевіряються фільтри включення, потім фільтри виключення. Пріоритет за фільтрами виключення

Тобто. якщо товар підходить за фільтрами включення та фільтрами виключення, то такий товар не враховується, оскільки він також у групі винятків. Скажімо, товар X у двох категоріях А і Б. У включеннях вказали категорію А, у винятках категорію Б. Товар підходить за фільтрами включень, оскільки він у категорії А, але виключається, тому що у фільтрах виключення зазначена категорія Б.

Фільтрація включення здійснюється за таким правилом (той самий підхід і при виключенні). Товар підходить у тих випадках:

1. Якщо товар є у вказаних категоріях І вказаних виробниках І в діапазоні цін
2. АБО - Якщо товар вказано окремо

Якщо для якогось із пунктів не вказано налаштування (наприклад, не задані продукти), то критерієм відбору стає лише один пункт (у якому задані налаштування). Якщо ж налаштувань взагалі не задано, то фільтрація не здійснюється - інакше кажучи, вважається, що всі товари підходять (у разі виключення при порожньому фільтрі, фільтрація не застосовується).

цін. Якщо значення фільтра вартості дорівнює або менше нуля, то вважається, що обмежень щодо цього фільтра ціни немає. Наприклад, вартість ВІД дорівнює 10 і вартість ДО дорівнює 0 означає, що вартість товару повинна бути більшою або дорівнює 10. Врахуйте, що ціни задаються в базовій валюті.

Ефективна ціна означає, що для перевірки використовується ціна, яка відображається в кошику. Наприклад, якщо товар із ціною 100 після стандартних знижок та застосування опцій став коштувати 120, то при фільтрації буде використано значення 120.

Варто враховувати, що фільтрація застосовується для всіх опцій, які залежать від продуктів. Це означає, що при підрахунку сум та кількості (як для оцінки у таблиці рядків, так і для формування відсотка) єдиним, що не перераховується, є опція «Отримана сума до застосування IMDiscount».

Наприклад, у кошику було два товари А за 500 та Б за 200. Після фільтру залишився тільки товар Б за 200. У налаштуваннях виставлено, що відсоток застосовується до всіх товарів. Це означає, що при підрахунку сум з таблиці знижок буде враховуватися тільки товар Б. Припустимо, якщо в таблиці знижок задано 10%, то не (500 + 200) * 0,1 = 70, а (200 * 0,1) = 20.

Фільтри товарів (включення, виключення) у стратегії Накопичувальна знижка

ВАЖЛИВО! Фільтри застосовуються не до замовлень, там загальний підрахунок сум, а до конкретних товарів, які розміщені в кошику

Скажімо, якщо ви виключили якийсь товар у фільтрах, то, підраховуючи суми вже здійснених замовлень, цей товар не буде відніматися із загальної суми замовлень. Але й відсоток знижки не застосовуватиметься до цього товару (якщо знижка застосовується до товарів, а не до суми до модуля).

Наприклад, виключили товар Х і знижка застосовується до товарів. При підрахунку вчинених замовлень не здійснюватиметься жодна фільтрація. А ось у кошику товар Х фільтруватиметься (до нього не застосовуватиметься знижка).

В іншому логіка схожа на те, як відбувається розрахунок у стратегії Поточне замовлення.

Як відбувається фільтрація Насамперед перевіряються фільтри включення, потім фільтри виключення. Пріоритет за фільтрами виключення

Тобто. якщо товар підходить за фільтрами включення та фільтрами виключення, то такий товар не враховується, оскільки він також у групі винятків. Скажімо, товар X у двох категоріях А і Б. У включеннях вказали категорію А, у винятках категорію Б. Товар підходить за фільтрами включень, оскільки він у категорії А, але виключається, тому що у фільтрах виключення зазначена категорія Б.

Фільтрація включення здійснюється за таким правилом (той самий підхід і при виключенні). Товар підходить у тих випадках:

1. Якщо товар є у вказаних категоріях І вказаних виробниках І в діапазоні цін
2. АБО - Якщо товар вказано окремо

Якщо для якогось із пунктів не вказано налаштування (наприклад, не задані продукти), то критерієм відбору стає лише один пункт (у якому задані налаштування). Якщо ж налаштувань взагалі не задано, то фільтрація не здійснюється - інакше кажучи, вважається, що всі товари підходять (у разі виключення при порожньому фільтрі, фільтрація не застосовується).

цін. Якщо значення фільтра вартості дорівнює або менше нуля, то вважається, що обмежень щодо цього фільтра ціни немає. Наприклад, вартість ВІД дорівнює 10 і вартість ДО дорівнює 0 означає, що вартість товару повинна бути більшою або дорівнює 10. Врахуйте, що ціни задаються в базовій валюті.

Ефективна ціна означає, що для перевірки використовується ціна, яка відображається в кошику. Наприклад, якщо товар із ціною 100 після стандартних знижок та застосування опцій став коштувати 120, то при фільтрації буде використано значення 120.

Варто враховувати, що фільтрація застосовується для всіх опцій, які залежать від продуктів. Це означає, що при підрахунку сум та кількості (як для оцінки у таблиці рядків, так і для формування відсотка) єдиним, що не перераховується, є опція «Отримана сума до застосування IMDiscount».

Наприклад, у кошику було два товари А за 500 та Б за 200. Після фільтру залишився тільки товар Б за 200. У налаштуваннях виставлено, що відсоток застосовується до всіх товарів. Це означає, що при підрахунку сум з таблиці знижок буде враховуватися тільки товар Б. Припустимо, якщо в таблиці знижок задано 10%, то не (500 + 200) * 0,1 = 70, а (200 * 0,1) = 20.

Модулі для відображення знижок (стратегій)

Модуль може відображатися у двох варіантах:

1. Повний - відображаються всі параметри
2. Короткий - в даному випадку не відображаються подробиці знижок, а також суми та кількості, що враховуються.

У модулях багато різних параметрів для налаштування того, як і чого модуль повинен відображати

(Тексти ДО і ПІСЛЯ, самі знижки, відображення сум і кількості, що враховуються, та інше).

Також враховуються налаштування відображення в частині користувача, які ви задали в самих стратегіях Накопичувальна знижка та Поточне замовлення. Наприклад, знижка може не відображатися (оскільки відключили відображення), але при цьому застосовуватися.

Якщо знижка не проходить перевірку приналежності до поточного користувача (те, що така знижка взагалі може застосовуватися), то знижка не відображається, незалежно від налаштувань

Це дозволяє користувачам бачити тільки знижки, які потенційно можуть ставитися до них. Наприклад, користувачі роздрібу не побачать знижки групи опту (про відповідні фільтри користувачів).

Існує можливість увімкнути автоматичне відстеження кошика (з певними обмеженнями)

У більшості шаблонів автоматичне відстеження змін кошика коректно виконуватиметься. Технічно це відстеження тексту всередині "#cart-total" із певною періодичністю.

Також ви можете прямо в модулі додати свої CSS та JS.

Масова генерація стандартних знижок та акцій OpenCart для товарів

Модуль підтримує можливість масової генерації стандартних знижок та акцій для OpenCart – це вкладки «Знижки (опенкарт)» та «Акції (опенкарт)».

Зверніть увагу, що масова генерація це не стратегія, тому вони створюються прямо у вкладці і не відображаються в загальному списку (як і в модулях відображення IMDiscount і т.д.).

Фільтрування здійснюється за таким правилом. Товар підходить у тих випадках:

1. Якщо товар є у вказаних категоріях І вказаних виробниках І в діапазоні цін І з відповідним статусом
2. АБО - Якщо товар вказано окремо

Врахуйте, що якщо потрібна генерація ТІЛЬКИ для окремих товарів, необхідно переконатися, що фільтри для першого пункту порожні (не виставлені ціни у фільтрах, не задані виробники та категорії, а також не заданий статус).

цін. Якщо значення фільтра вартості дорівнює або менше нуля, то вважається, що обмежень щодо цього фільтра ціни немає. Наприклад, вартість ВІД дорівнює 10 і вартість ДО дорівнює 0 означає, що вартість товару повинна бути більшою або дорівнює 10. Врахуйте, що ціни задаються в базовій валюті.

ВАЖЛИВО! Врахуйте, якщо взагалі всі фільтри будуть порожніми, то генерація і очищення будуть застосовуватися до всіх товарів (по суті, відсутність фільтрів = не перевіряти товари)!

Іншими словами, якщо не вказали фільтри, то при очищенні за кнопкою (або як частини генерації) буде видалено стандартні знижки або акції для всіх товарів (залежно від того, для чого використовується масова генерація)! Аналогічно, при генерації знижки або акції з таблиці (залежно від того, для чого використовується масова генерація) буде додано для всіх товарів.

Масова генерація стандартних знижок та акцій - як відбувається розрахунок цін для типів та модифікаторів

Перший етап

Існує два типи уявлення числа: фіксоване число (відображається як «.») та відсоток (відображається як «%»).

З цих даних формується [значення коригування]. У разі фіксованого числа – це просто число, а у разі відсотка – це ціна, помножена на відсоток та поділена на 100.

Наприклад, число 50 для "." це буде 50. А у разі «%» це буде [price]*50/100.

Другий етап

Існує 5 арифметичних модифікаторів: одно («=»), відняти («-»), додати («+»), помножити («*»), розділити («/»). Тут як у арифметиці.

Модифікатор "=". Формула [next_price] = [значення для коригування]

Модифікатор "-". Формула [next_price] = [price] - [значення для коригування]

Модифікатор "+". Формула [next_price] = [price] + [значення для коригування]

Модифікатор "*". Формула [next_price] = [price] * [значення для коригування]

Модифікатор "/". Формула [next_price] = [price] / [значення для коригування]

ВАЖЛИВО! Акуратно заповнюйте типи та модифікатори

Суть у прикладі. Скажімо, помножити на 50% це означає, що [next_price] = [price] * [значення для коригування] = [price] * ([price] * 50/100). Іншими словами, половина від ціни у квадраті!

Також цей момент стосується негативних цін. Подібне стандартний механізм опенкарт вважає цілком коректним у багатьох версіях (як мінімум, в 2.x, 3.0). Для розуміння: ви можете встановити як ціну товару, так і знижки з негативними акціями, і вони будуть використовуватися при розрахунку, включаючи кошик та оформлення замовлення.

Тому в модулі немає додаткових перевірок для цін, у плані негативного значення. Чи мало ви, як клієнт, використовуєте цю особливість. Тому будьте уважні та обережні!

Логування

Логування включається у вкладці «Параметри». Файл лога розміщується в каталозі «storage/logs» (DIR_LOGS).

Декілька істотних моментів:

• ВАЖЛИВО! Лог формує чимало даних (один клієнт за хвилину легко формує 1МБ і більше). Тому не варто постійно тримати його увімкненим. Краще підходити до ліг наступним чином: включили лог, виконали потрібні дії і відразу відключили лог.
• Зверніть увагу, що під час формування лога у файлі зберігається маса «делікатної» інформації. Тому після того, як ви завантажуєте лог, файл усередині каталогу варто видалити.

Зверніть увагу, що лог містить масу технічної інформації та призначений для складних ситуацій, при яких ви не можете самостійно знайти помилку в налаштуваннях.

Проте навіть звичайні користувачі можуть скористатися ним. У файлі лога необхідно шукати фразу "After calculateDiscounts". Трохи вище її відображається ідентифікатори користувача та його групи, а також ПІБ. Трохи нижче її відображається зведена інформація про обчислені знижки діючих стратегій для поточного кошика (до глобального налаштування підрахунку знижки).

Не застосовувати знижки у разі купона

У налаштуваннях модуля можна відключати застосування знижок IMDiscount (стратегій) для випадку, коли вказано купон. Однак для цього модуль купона повинен застосовуватись до застосування модуля IMDiscount. Іншими словами, порядок сортування модуля IMDiscount повинен бути більшим за сортування модуля купона.

Налаштування діє глобально, тобто для всіх знижок одразу.

Особливості та обмеження

1. Накопичувальні знижки застосовуються лише для зареєстрованих користувачів. Ви можете вказати видимість для поточного замовлення.
2. Підрахунок суми попередніх замовлень у накопичувальній стратегії здійснюється в залежності від налаштувань: від підсумкової суми (total), проміжної суми (sub_total) або без урахування доставки (shipping).
3. Якщо статуси замовлення не вказані, сумуються всі замовлення.
4. Фільтр за групами та клієнтами здійснюється за правилом АБО. Тобто або у списку груп або у списку користувачів.
5. (з версії 1.4.0 неактуально, оскільки перенесено відповідно до стандартної схеми опенкарт) Для російської переклади перебувають у system/IMDiscount/Lang
6. За замовчуванням сума знижки модуля IMDiscount (результуюча) округляється до 2-х знаків (задається у вкладці «Налаштування»). При негативних значеннях заокруглюється ціла частина числа. Наприклад, при значенні (-2) число (127) буде (100), а за значення (-1) число (189) буде (190). Враховуйте, що при округленні до (-3) число (129) буде (0) (бо 1 менше 5).
7. Принцип дії округлення чисел при масовій генерації стандартних знижок та акцій аналогічний попередньому пункту.
8. Придбані подарункові сертифікати не є повноцінними товарами (в рамках OpenCart), тому знижка від них можлива лише в тому випадку, якщо вона обчислюється від «Суми до застосування IMDiscount», в яку входить сума сертифкатів, що купуються. Наприклад, у стратегії "поточне замовлення" знижка для "Відсоток від товарів без знижки" (або всіх товарів) обчислюватиметься лише для товарів, але не сертифікатів.
9. При розрахунку накопичувальної знижки придбані подарункові сертифікати враховуються у всіх трьох варіантах: підсумкова сума – це сума замовлення (total), сума товарів / проміжний підсумок – це товари з купленими сертифікатами (sub_total), без доставки – це сума замовлення (total) за вирахуванням доставки. У всіх випадках ці суми включають вартість сертифікатів.
10. Враховуйте, що якщо з якихось причин сума доставки вказується з відмінним кодом від «shipping», то така доставка не враховується у накопичувальних знижках.
11. За замовчуванням, у списках з ajax підвантаження клієнтів відображається 10 клієнтів, а час затримки між запитами 500 мс.
12. Врахуйте, що всі ціни задаються та враховуються у базовій валюті.
13. Потрібно, щоб у налаштуваннях сайту було виставлено mbstring.func_overload 0. Якщо ви не знаєте, як це зробити, то уточніть у вашому хостингу. У більшості випадків за промовчанням це значення 0 (вам, як клієнту, нічого не потрібно робити), але в деяких хостингах виставляють значення 2. Це актуально в тих випадках, якщо у вас виникли проблеми з ключами та активацією модуля.
14. Потрібний jQuery і bootstrap.

Встановлення та наступні версії

• Зробіть резервну копію сайту (бекап) – стандартний підхід (корисний перед будь-якими діями з сайтом).
• Якщо це наступна версія, то першим ділом відключіть попередню версію модуля IMDiscount у «Враховувати на замовлення».
• Розпакуйте архів. Скопіюйте в корінь сайту каталоги "admin", "catalog", "system". Не хвилюйтеся, жодні файли не будуть замінені, крім випадків, коли ви встановлюєте наступну версію і коли у вас вже стоять мої модулі (у них є спільні файли, які не змінюються).
• Відкрийте адмінку та активуйте модуль знижок IMDiscount у «Враховувати замовлення». Якщо ж це наступна версія, то вимкніть, а потім увімкніть модуль.
• Відкрийте адмінку та активуйте модуль для виведення знижок IMDiscount у «Модулі / Розширення» (бувають різні назви, залежить від перекладу).
• Якщо ви використовуєте шаблон UniShop2, то встановіть модифікатор imdiscount-unishop2.ocmod.zip
• Обновіть модифікатори та почистіть кеш твіга.
• Відкрийте модуль IMDiscount в адмінці в «Враховувати в замовленнях» (редагування) та для активації знижок у вкладці «Налаштування» вкажіть статус «Увімкнено», а також порядок прямування (подібно до того, як і в інших модулях обліку в замовленні, таких як доставки, оплати тощо). Якщо цього зробити, то знижки можуть застосовуватися.
• Встановіть та налаштуйте модулі відображення так, як вам потрібно. Можливо, після цього потрібно ще раз почистити кеш твіга.

ВАЖЛИВО! Якщо ви не вкажіть коректний порядок сортування в модулі IMDiscount, обчислення можуть бути некоректними! Як мінімум, обчислення знижки має відбуватися після підрахунку суми товарів (sub_total).