Системные настройки

Откройте Система → Системные настройки, в фильтре пространства имён выберите ms3optionscolor.

После смены значений очистите кэш MODX. Если правили менеджер (RAL, ключ опции), перезагрузите страницу менеджера: конфиг Vue читается при открытии.

Ключ в БД всегда с подчёркиванием: ms3optionscolor_<имя>.

Сводная таблица

Ключ	Тип	По умолчанию	Кратко
ms3optionscolor_default_option_key	textfield	color	Какие опции товара считаются «цветом»
ms3optionscolor_ral_enabled	combo-boolean	Да	Вкладка и поиск RAL в менеджере
ms3optionscolor_frontend_css	combo-boolean	Да	Стили свотчей на сайте сами
ms3optionscolor_variants_decorate	combo-boolean	Да	Цвета у вариантов ms3variants в каталоге

ms3optionscolor_default_option_key

Какая опция (или несколько) участвует во вкладке Swatches, в запросе цветов для чипов на «Свойства товара» и в сниппете, если вы не передали &options.

Значение	Когда ставить
color	Один ключ опции «Цвет» (типичный магазин)
color,material	Нужны свотчи и для цвета, и для материала

Несколько ключей пишите через запятую, без пробелов или с пробелами после запятой: пакет обрежет пробелы. Не оставляйте поле пустым: укажите реальный ключ опции.

Пример: опция в miniShop3 называется color. Оставьте значение по умолчанию. На вкладке Swatches увидите все значения этой опции у товара. Сниппет без &options тоже возьмёт color.

Если ключ опции другой (например obivka), поставьте его сюда. Иначе вкладка Swatches будет пустой, хотя значения на «Свойства товара» есть.

ms3optionscolor_ral_enabled

Значение	Что происходит
Да	В CMP есть вкладка RAL, в диалоге цвета можно искать код RAL
Нет	Вкладка RAL скрыта, поиск RAL в форме недоступен. Уже сохранённые коды в словаре не удаляются

Выключайте, если RAL магазину не нужен и мешает менеджерам. HEX и паттерны работают независимо от этой настройки.

ms3optionscolor_frontend_css

Значение	Что происходит
Да	Стили css/web/main.css подключаются на страницах сайта и при вызове сниппета
Нет	Стили не грузятся. Квадраты [data-ms3oc-swatch] часто без размера, особенно в корзине

Оставляйте Да, если пользуетесь штатными чанками. Ставьте Нет, только когда сами подключаете CSS темы и не хотите дублировать файл пакета.

Ручное подключение:

fenom

<link rel="stylesheet" href="{'assets_url' | option}components/ms3optionscolor/css/web/main.css">

modx

<link rel="stylesheet" href="[[++assets_url]]components/ms3optionscolor/css/web/main.css">

ms3optionscolor_variants_decorate

Работает только вместе с ms3variants и вызовом листинга с usePackages=ms3Variants.

Значение	Что происходит
Да	К каждому варианту в каталоге добавляются цвета из словаря (variants[].swatches)
Нет	Варианты как у ms3variants, без цветов из словаря

На корзину, цену и выбор варианта настройка не влияет. Подробнее и примеры разметки: ms3variants.

Права доступа

Отдельных прав пакет не создаёт.

Что делаете	Какое право нужно
Открыть раздел, править словарь и RAL	msproduct_save (как у сохранения товара miniShop3)
Вкладка Swatches на товаре	то же msproduct_save

Без права сохранение в менеджере не пройдёт. Проверьте политику роли менеджера и очистите кэш.

Связанные страницы

• Первый запуск: Быстрый старт
• Параметры сниппета: ms3OptionsColor
• Типовые ошибки: FAQ