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 со свотчем работает через Select2 или обычный <select>.
mFilter и ms3variants
Тип фильтра ms3oc рисует свотчи из словаря. Встроенный тип colors пакет не меняет. Если стоит ms3variants, в каталоге у вариантов можно показать цвета из словаря.
Требования
| Компонент | Версия |
|---|---|
| MODX Revolution | ≥ 3.0.3 |
| miniShop3 | ≥ 1.0.0 |
| VueTools | ≥ 1.1.2-pl |
| pdoTools | 3.x |
| PHP | ≥ 8.2 |
| mFilter | опционально, для типа ms3oc |
| ms3variants | опционально: цвета вариантов в каталоге |
Установка
- Установите ms3OptionsColor через Система → Управление пакетами.
- Очистите кэш MODX.
- Проверьте у роли менеджера право
msproduct_save(как у сохранения товара miniShop3). Отдельных ACL-ключей пакет не создаёт. - Откройте Компоненты → ms3OptionsColor. Словарь должен открыться без белого экрана и ошибок VueTools.
Пакет готовит базу словаря и RAL Classic, раздел в менеджере и плагин: вкладка товара, витрина, фильтр.
Элементы пакета
| Тип | Имя | Назначение |
|---|---|---|
| Сниппет | 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 |