Обзор менеджера

Раздел Компоненты → ms3OptionsColor открывается из меню или по ссылке manager/?a=index&namespace=ms3optionscolor. Интерфейс на Vue 3 и PrimeVue (VueTools).

Пошаговые сценарии: Сценарии.

Как работает раздел

Список словаря и вкладка Swatches сохраняют данные через connector miniShop3 (assets/components/minishop3/connector.php, action=MiniShop3\Processors\Api\Index). Прямой /api/mgr/… на части хостингов отвечает 404. Нужны miniShop3 и право msproduct_save.

Маршруты под /api/mgr/ms3optionscolor:

Метод	Путь	Назначение
GET	/product/{id}	Свотчи товара
GET	/map	Карта ключ+значение → HEX/pattern
GET	/colors	Список словаря
PUT	/colors	Создать/обновить цвет
DELETE	/colors/{id}	Удалить цвет
GET	/ral	Поиск RAL
PUT	/ral	Создать/обновить RAL
DELETE	/ral/{id}	Удалить RAL

Экран CMP

Сверху вниз:

1. Вкладки Словарь и RAL, если включён ms3optionscolor_ral_enabled.
2. Таблица с поиском, фильтром статуса и действиями.

Словарь

Действие	Как
Поиск	Поле «Поиск значения или ключа» (без учёта регистра, в т.ч. кириллица)
Фильтр статуса	API: all / не задан / active / inactive. Не disabled
Править / назначить	Иконка карандаша в строке
Удалить	В диалоге кнопка Удалить с confirm

Словарь общий: пара option_key + value одна на весь каталог.

RAL

Вкладка RAL: поиск по коду и названию, Добавить, правка строки.

Диалог цвета

В диалоге задаёте HEX (полоска + RGB/HSV), URL паттерна, RAL, title, activity. Режимы: Цвет / Паттерн.

Выбор RAL подставляет его HEX. Если вы измените HEX вручную или сохраните режим Паттерн, форма очистит связь с прежним RAL. Код и цвет не расходятся.

При сохранении пакет нормализует URL паттерна и поле «Изображение»:

Что сохранили	Что запишется
/assets/…	путь от корня сайта
полный URL этого же сайта	относительный путь
внешний HTTPS/CDN URL	как есть

Вкладка товара Swatches

На product_create / product_update плагин регистрирует вкладку Swatches среди Vue-вкладок товара.

Порядок работы:

1. На Свойства товара добавьте значения опции (color или ключи из ms3optionscolor_default_option_key).
2. Сохраните товар.
3. На Swatches назначьте HEX / pattern / RAL значениям со статусом «не задано».

Подсказки из comboColors miniShop3 подставляются в UI. Пакет не пишет цвет в msOption.properties.

На вкладке Свойства товара скрипт product-option-swatch.js рисует квадрат свотча в чипах опции. Запрос /map идёт тем же connector miniShop3.

Ограничения

• Без VueTools раздел менеджера и вкладка товара не откроются.
• Без права msproduct_save словарь не сохранится.
• Тип фильтра ms3oc появится только если установлен mFilter.