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-дневный триал на вкладке «Лицензия».