Работа с настройками в админке
Страница модуля находится в разделе Kokhanenko → Настройки сайта. Меню сначала группирует пункты по сайтам, затем показывает доступные для сайта типы настроек.
Права доступа
- право
Rразрешает открыть страницу и читать значения; - право
Wразрешает создавать, изменять и удалять типы и настройки.
Изменяющие запросы дополнительно проверяют идентификатор сессии Битрикса.
Типы настроек
Тип объединяет связанные поля, например base, contacts или footer.
- Глобальный тип доступен на всех сайтах, если его не скрыли для конкретного сайта.
- Локальный тип относится только к выбранному сайту и имеет приоритет над одноимённым глобальным типом.
Чтобы создать тип, выберите сайт и нажмите Добавить новый тип настроек.
Код должен начинаться с латинской буквы и содержать только латинские буквы,
цифры и _.
При удалении глобального типа из области текущего сайта модуль скрывает его для этого сайта. Кнопка Подключить существующие группы возвращает скрытый тип. Глобальное удаление удаляет тип для всех сайтов.
Настройки внутри типа
Нажмите Добавить новую настройку и заполните:
- ключ — стабильный идентификатор для PHP-кода;
- группу — визуальный раздел на странице;
- название и подсказку;
- вид поля;
- значение по умолчанию;
- при необходимости родительскую настройку и CSS-модификаторы Bitrix UI.
После создания ключ изменить нельзя. Это защищает уже написанный код от случайной поломки.
Поддерживаемые поля
| Вид | Значение в хранилище | Результат чтения |
|---|---|---|
| Поле ввода | строка | строка |
| Многострочное поле | строка | строка |
| Чекбокс | 1 или 0 |
строка |
| Список | ключ выбранного пункта | строка |
| Множественный список | ключи через запятую | массив ключей |
| Время | HH:MM |
строка |
| Календарь | дата | строка |
Для списка задайте варианты как пары ключ-значение. CSS-модификаторы
используют классы Bitrix UI, например ui-ctl-w100 ui-ctl-sm.
Родительские поля
Родительская настройка может управлять показом дочерних полей. Сначала создайте родителя с флагом Сделать настройку родительской, затем выберите его ключ у дочерней настройки. При удалении родителя связанные дочерние поля также удаляются.