Модель настроек
Каждое значение определяется тройкой: сайт, тип и ключ.
siteId + type + key → value
s1 + base + buttonTitle → "Подробнее"
Область действия
Типы бывают глобальными и локальными. При построении списка для сайта модуль:
- загружает активные глобальные типы;
- исключает глобальные типы, скрытые для выбранного сайта;
- добавляет активные локальные типы;
- заменяет глобальный тип локальным, если их коды совпадают.
Значения настроек всегда хранятся с идентификатором сайта. Глобальность типа определяет доступность структуры, а не общее значение для всех сайтов.
Идентификаторы
Коды типов и ключи настроек должны начинаться с латинской буквы. Допустимы
латинские буквы, цифры и символ _.
Примеры корректных идентификаторов: base, header_v2, buttonTitle.
Порядок и активность
Поле sort определяет порядок, значение по умолчанию — 500. Неактивные
настройки не попадают в выборку типа. Неактивные типы не показываются в меню.
Опции поля
Опции хранятся в JSON. Совместимые старые вызовы могут передавать сериализованный PHP-массив: сервис безопасно преобразует его в JSON без создания объектов. Основные опции:
modifiers— классы оформления Bitrix UI;values— варианты для обычного или множественного списка.