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