ms3OptionsColor
Свотчи для опций miniShop3: HEX, паттерны, изображения и RAL Classic
- MODX 3
- PHP 8.2
- miniShop3
- Vue 3
ms3OptionsColor
С ms3OptionsColor вы назначаете цвет, паттерн или RAL значениям опций miniShop3 и показываете свотчи на витрине, в select, в фильтре и в корзине. Словарь общий: пара option_key + value одна на весь каталог. Назначили color=Синий один раз, и тот же свотч появится на всех товарах с этим значением.
С чего начать: Быстрый старт.
Возможности
Менеджер
CMP на Vue 3 и PrimeVue (через VueTools): вкладки Словарь и RAL. Поиск по ключу и значению, фильтр статуса, диалог HEX / паттерн / RAL.
На карточке товара вкладка Swatches рядом со «Свойства товара». Сначала задаёте значения опции, потом назначаете свотч. В чипах опции скрипт рисует квадрат цвета.
Витрина
Сниппет ms3OptionsColor и Fenom-чанки. CSS витрины подключается сам, если включена настройка ms3optionscolor_frontend_css. Select со swatch работает через Select2 или обычный <select>.
mFilter и ms3variants
Тип фильтра ms3oc рисует свотчи из словаря и не подменяет встроенный тип colors. Если стоит ms3variants, в каталоге у вариантов можно показать цвета из словаря. Подробнее: mFilter, ms3variants.
Требования
| Компонент | Версия |
|---|---|
| MODX Revolution | ≥ 3.0.3 |
| miniShop3 | корзина, опции товара, API менеджера |
| VueTools | ≥ 1.1.2-pl |
| pdoTools | 3.x |
| PHP | ≥ 8.2 |
| mFilter | опционально, для типа ms3oc |
| ms3variants | опционально: цвета вариантов в каталоге |
Установка
- Установите ms3OptionsColor через Система → Управление пакетами.
- Очистите кэш MODX.
- Убедитесь, что у роли менеджера есть право
msproduct_save(как у сохранения товара miniShop3). Отдельных ACL-ключей пакет не создаёт. - Откройте Компоненты → ms3OptionsColor. Словарь должен открыться без белого экрана и ошибок VueTools.
При установке пакет сам готовит базу под словарь цветов и справочник RAL Classic, подключает раздел в менеджере и плагин для вкладки товара, витрины и фильтра. Пошагово с первым swatch: Быстрый старт.
Элементы пакета
| Тип | Имя | Назначение |
|---|---|---|
| Сниппет | ms3OptionsColor | Свотчи, option для select, return=data |
| Плагин | ms3OptionsColor | Вкладка товара, CSS витрины, фильтр mFilter, цвета в вариантах каталога |
| Чанки | tplMs3OptionsColor* | Витрина, select, корзина, mFilter |
| Меню | ms3OptionsColor | CMP словаря и RAL |
Куда дальше
| Задача | Раздел |
|---|---|
| Первый swatch за 15 минут | Быстрый старт |
Ключи ms3optionscolor_* | Системные настройки |
| Select, корзина, CSS/JS | Вывод на сайте |
| Параметры сниппета и чанки | Сниппеты |
Фильтр каталога ms3oc | mFilter |
| Цвета вариантов в каталоге | ms3variants |
| CMP и вкладка товара | Обзор менеджера |
| Flow A–I со скриншотами | Сценарии |
| События словаря и плагина | События |
| Типовые ошибки | FAQ |