Option Specials для OpenCart — акційна ціна на окреме значення опції

Option Specials для OpenCart — модуль, який ставить акцію на окреме значення опції. Смартфон «128 ГБ» продається за звичайною ціною, а «256 ГБ» — зі знижкою; футболка в червоному кольорі дешевша, ніж у решті; подарункове пакування цього тижня безкоштовне. Штатно OpenCart так не вміє: його акція (Special) змінює ціну всього товару, а доплата за опцію в картці товару завжди одна.

Акція задається на значення опції двома способами: нова доплата (зі знаком + або −) або знижка у відсотках від звичайної доплати. На сторінці товару покупець бачить нову ціну, закреслену стару й мітку -N%, а в кошику й замовленні акційна ціна стоїть прямо в рядку товару — без окремого рядка «знижка», тож податки, «Разом», рахунок і сума до оплати збігаються з тим, що покупець бачив. Файли ядра OpenCart модуль не змінює і ціни опцій у каталозі не переписує. Одна ліцензія — три збірки: OpenCart 4.x, 3.x і 2.3.

Як це виглядає для покупця

• Нова ціна там, де покупець її шукає. Тема друкує в дужках біля значення вже акційну доплату, модуль додає поруч закреслену стару і червону мітку -N%. У випадному списку (select) — текстом: «Назва (+нова) — було +стара, -N%».
• Чесна мітка. Відсоток рахується з двох видимих цін, а не з «сирих» цифр у базі, тож -51% на сторінці — це справді -51% від того, що показано.
• Кошик без сюрпризів. Ціна за одиницю в кошику вже акційна, підсумок і податки — від неї. Покупець не бачить, як ціна «повертається», коли він переходить до оформлення.
• Скільки зекономив. За бажанням над товарами в кошику з’являється рядок «Акції на опції в цьому кошику: мінус X».

Що отримує адмін

Розширення → Модулі → Option Specials, три вкладки: «Акції на опції», «Налаштування» і «Ліцензія».

• Пошук товару за назвою або моделлю — у списку лише товари, в яких є опції.
• Грід значень. Обрали товар — бачите всі його значення опцій (select, radio, checkbox) зі звичайною доплатою, і біля кожного — «Додати правило». Правило: тип («Нова ціна» або «Знижка, %»), сума чи відсоток, а в Pro — група покупців, пріоритет і дати.
• Перевірка перед збереженням. Нечислова чи від’ємна ціна, знижка понад 100%, дата завершення раніша за початок — модуль називає значення з помилкою й нічого не зберігає.
• Захист від застарілої сторінки. Якщо правила товару змінили в іншій вкладці, збереження зі старої сторінки не пройде — модуль попросить відкрити товар ще раз, замість того щоб тихо перезаписати чужі зміни.
• Список товарів з акціями з лічильниками «значень з правилами» і «увімкнено правил», масове видалення і кнопка «Прибрати зайве» — прибирає правила значень, які ви видалили з картки товару.
• Налаштування вигляду: показувати стару ціну, мітку -N%, економію в кошику; підключати стилі модуля чи оформити все у своїй темі.

Pro: групи покупців, дати, пріоритет

• Група покупців. Окрема акційна ціна для роздрібу, опту чи будь-якої іншої групи — або одна для всіх.
• Розклад. Дата початку й завершення, обидві включно: акцію «на вихідні» можна завести заздалегідь, і вона сама ввімкнеться й вимкнеться.
• Кілька правил на значення. Наприклад, −20% для всіх і −35% для оптовиків. Діє правило з меншим пріоритетом, а при рівному — з нижчою ціною, як в акціях товару OpenCart.
• Без ліміту на кількість значень з акцією.

Як це працює — крок за кроком

1. Ви обираєте товар і ставите правило на значення опції: нову доплату або знижку у відсотках.
2. На сторінці товару модуль підставляє акційну доплату в дані опцій, які тема отримує від OpenCart, — тож тема друкує нову ціну сама, а модуль лише додає стару й мітку.
3. На початку кожного запиту до вітрини модуль перевіряє, чи є в магазині бодай одне ввімкнене правило. Немає — нічого не відбувається.
4. Якщо є, модуль будує штатний кошик OpenCart ще раз, але для значень опцій з акцією кошик отримує акційну доплату замість звичайної. Усе інше — товар, кількість, знижки, податки — рахує сам OpenCart.
5. Далі кошиком користуються всі: сторінка кошика, міні-кошик, оформлення замовлення, One Page Checkout, модулі підсумків. Замовлення зберігається з акційною ціною в рядку товару.
6. Правило, яке зробило б опцію дорожчою за звичайну, модуль ігнорує — акція не може підняти ціну.

Що під капотом

• Без правок ядра. Модуль працює через події й startup-дію OpenCart. Файли ядра не змінюються, product_option_value.price не переписується, тож видалення модуля повертає магазин до звичайних цін без жодного прибирання в каталозі.
• Штатний кошик, акційна доплата. Кошик будується ядровим класом OpenCart удруге, з підміною лише відповідей на запити значень опцій. Тому податки (зокрема фіксовані), знижки товару від кількості, валюти й модулі підсумків працюють як завжди.
• Навантаження. Без жодного ввімкненого правила модуль робить один легкий запит на сторінку. З правилами кошик рахується двічі за запит — на звичайному кошику це непомітно, на дуже великих кошиках це подвоєння запитів до бази.
• Власна таблиця правил (товар, значення опції, група покупців, тип, ціна, пріоритет, дати, статус) — кілька правил на значення, як у штатних акціях товару.
• Інтерфейс для фідів. system/library/cc_optspecial/feed.php повертає для списку значень опцій ту саму акційну ціну, яку рахує кошик. Наш Market Feeds його поки не використовує — підключення в планах.
• Мультимагазин: правила спільні для всіх магазинів установки.
• Видалення. Деінсталяція знімає події й startup-запис — вітрина одразу рахує звичайні ціни. Таблиця з правилами лишається навмисно, щоб перевстановлення не стерло ваші акції. На OpenCart 2.3 деінсталяція видаляє й налаштування разом із ключем ліцензії — після перевстановлення ключ треба активувати знову.

Як встановити

1. OpenCart 4: Extensions → Installer → завантажте cc_optspecial.ocmod.zip (ім’я архіву не змінюйте) і натисніть «Install». OpenCart 3: Extensions → Installer → cc_optspecial-oc3.ocmod.zip, потім Extensions → Modifications → Refresh. OpenCart 2.3: інсталятор 2.3 без налаштованого FTP файли не копіює, тож залийте вміст папки upload/ з cc_optspecial-oc2.ocmod.zip у корінь магазину через файловий менеджер хостингу — FTP в OpenCart налаштовувати не треба.
2. Extensions → Extensions → Modules → Option Specials → «Install», потім «Edit».
3. Вкладка «Налаштування»: «Статус» — увімкнено, за бажанням — стара ціна, мітка -N% і економія в кошику. Збережіть.
4. Вкладка «Акції на опції»: почніть вводити назву товару, оберіть його, біля потрібного значення натисніть «Додати правило», задайте нову ціну або знижку й натисніть «Зберегти акції».
5. Відкрийте товар на вітрині й додайте його в кошик — акційна ціна вже в рядку.
6. Для Pro: вставте ліцензійний ключ із листа після оплати або запустіть 7-денний тріал на вкладці «Ліцензія».