Option Combinations для OpenCart — комбінації опцій: залишок, ціна й артикул кожного варіанта

Option Combinations для OpenCart — модуль, який рахує не окремі значення опцій, а їхні поєднання. Футболка «червона × M» має власний залишок, «синя × L» — свій, а «зелена × S» не продається зовсім. Штатний OpenCart так не вміє: залишок і доплата в нього є лише в кожного значення окремо, тож магазин продає «червону M», навіть коли червоних M уже немає, аби лишались і червоні, і M.

Модуль додає товару сітку комбінацій з опцій типу «список» і «перемикач». У кожної комбінації — наявність і залишок, а в Pro ще доплата, вага, власний артикул і фото. На сторінці товару недоступні поєднання сірі, умовні опції з’являються лише тоді, коли потрібні («текст гравіювання» — тільки якщо вибрано «Гравіювання: так»), а замість випадних списків — кольорові кружки й кнопки. Файли ядра OpenCart модуль не змінює. Одна ліцензія — три збірки: OpenCart 4.x, 3.x і 2.3.

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

• Видно, що є. Значення, з яким не продається жодна комбінація, сіре й не натискається. Значення, яке конфліктує лише з уже вибраним (синій є, але не в розмірі S), приглушене — клік по ньому скидає конфліктний вибір, а не лякає помилкою.
• Ціна варіанта одразу. Сторінка питає в магазину ціну вибраної комбінації — ту саму, що порахує кошик, з акціями, знижками й податком — і підставляє її в ціну теми разом із рядком «Без ПДВ».
• Артикул, наявність, фото. Під опціями — артикул і наявність комбінації (або точна кількість, якщо ви так вирішили), а фото комбінації замінює головне.
• Нічого зайвого. Умовна опція схована, доки не потрібна, і не обов’язкова, поки схована.

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

Розширення → Модулі → Option Combinations, чотири вкладки: «Товари», «Зразки», «Налаштування» і «Ліцензія».

• Сітка за хвилину. Оберіть товар, позначте опції, з яких складаються варіанти, і натисніть «Додати відсутні комбінації» — модуль створить усі поєднання, наявні рядки лишаться як є. Масові зміни для всіх рядків — одним рядком над сіткою.
• Політика товару: що робити з комбінацією, якої немає в сітці (не продавати або продавати як звичайний товар), і з розпроданою (показувати сірою, ховати або приймати під замовлення).
• Умовні опції: «показати опцію B, коли A має одне з вибраних значень», ланцюжки умов; умову, що замикається в коло, модуль не збереже.
• Перевірка перед збереженням: нечисловий залишок, від’ємна доплата без знака, фото поза теками магазину — модуль називає комбінацію з помилкою й нічого не зберігає.
• Залишок значень опцій сітки модуль вимикає сам і пише, скільки значень вимкнено.

Pro: доплата, вага, артикул і фото кожної комбінації

• Доплата зі знаком + або − до ціни товару й інших опцій; акції й податки рахуються як завжди.
• Вага комбінації — для доставки, що рахує вагу.
• Артикул комбінації стає моделлю рядка замовлення: його видно в кошику, замовленні, рахунку й ТТН.
• Фото — одне з фото товару, замінює головне на сторінці й у кошику.
• Без ліміту товарів.

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

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

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

• Без правок ядра. Події й startup-дія OpenCart (на 3.x і 2.3 — подія перед першим контролером). Файли ядра й ціни опцій у каталозі не змінюються.
• Власні таблиці: налаштування товару, комбінації, умови, вигляд зразків, кольори значень і журнал списань по рядках замовлення (щоб скасування повертало рівно те, що списали).
• Сумісність. Option Specials будує свій кошик під нашим, тож акція на значення й доплата комбінації діють разом; Size Price Calculator обгортає наш кошик, у якому б порядку не запустились модулі.
• Навантаження. Товари без сітки не зачіпаються; з сіткою кошик рахується штатним класом ще раз — на звичайному кошику це непомітно.
• Фіди бачать товар як раніше — окремої інтеграції з комбінаціями немає.
• Мультимагазин: сітки й зразки спільні для всіх магазинів установки.
• Видалення. Деінсталяція знімає події й startup-запис і видаляє таблиці модуля, якщо в налаштуваннях не ввімкнено «Зберегти дані при деінсталяції модуля». На OpenCart 2.3 разом із налаштуваннями видаляється й ключ ліцензії — після перевстановлення його треба активувати знову.

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

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