Работа в административной панели

Страница: «Коханенко → Настройки сайта», /bitrix/admin/kokhanenko_settings.php.

Здесь описано, как добавить раздел или настройку, изменить подпись поля, настроить список и связать поля между собой. Для изменения содержимого уже готовых полей используйте руководство менеджера.

Четыре разные характеристики

Например, в разделе contacts можно создать группу «Контактные данные» и поместить в неё телефон phone. Разработчик прочитает его через Settings::get('contacts', 'phone', 's1', ''): название группы для этого не требуется.

Включить редактирование и изменить параметры

1. Выберите сайт и раздел.
2. Нажмите «Включить редактирование».
3. Наведите указатель на нужное поле: справа появятся ключ настройки и действия «Изменить» / «Удалить».
4. Нажмите «Изменить» и поправьте, например, название, подсказку, группу или сортировку.
5. Сохраните диалог. Текущее значение этой формой не изменяется.
6. При необходимости выключите режим редактирования, чтобы вернуться к повседневной работе.

Изменение названия и подсказки

Что нельзя изменить после создания

У существующей настройки нельзя изменить сайт, раздел, ключ, тип данных и множественность. Эти ограничения не относятся к названию и подсказке — их можно редактировать, как показано выше.

Если требуется перенести настройку на другой сайт или в другой раздел, изменить её ключ, тип или множественность, создайте новую настройку. Затем разработчик должен переключить PHP-код на неё и проверить результат. Только после этого можно удалять старую настройку.

Создать настройку с начальным значением

Создадим поле подписи для кнопки из быстрого старта. Для него нужен родительский переключатель base.useButton с типом boolean.

1. Выберите сайт s1, раздел base.
2. Нажмите «Добавить новую настройку».
3. Укажите ключ buttonTitle, название «Подпись кнопки» и подсказку «Текст ссылки на страницу контактов».
4. Выберите существующую группу или «Создать новую группу…», например «Кнопка связи».
5. Выберите тип string и редактор «Поле ввода» (input).
6. Если base.useButton создан как boolean, выберите его в «Родительская настройка».
7. Укажите сортировку, например 200.
8. В «Начальное значение» введите «Связаться с нами» и сохраните диалог.

Ключи и коды разделов начинаются с латинской буквы, далее допускают латинские буквы, цифры и _. Ключ уникален в пределах сайта и раздела. Перед сохранением проверьте результат автоматической транслитерации.

Списки: код и подпись

Для воспроизводимого примера создайте в contacts на s1 настройку departments: выберите тип enum и редактор «Развёрнутый список» для множественного выбора. Нажмите «Варианты списка», затем «Добавить вариант» для каждой новой строки.

В блоке «Варианты списка» добавьте:

Код — стабильное значение для PHP. Подпись — текст для человека. Выберите начальный вариант «Поддержка» и сохраните настройку. get() вернёт ['support'], а selectedOptions() — код и подпись. Для одиночного списка get() вернул бы строку 'support'.

Безопасно заменить используемый код

1. Добавьте новый вариант, сохранив старый, и сохраните определение.
2. В основной форме замените выбранное старое значение новым; сохраните значения.
3. Проверьте PHP-интеграцию и измените проверки кода в шаблонах, если это необходимо.
4. Только после этого удалите старый вариант из определения.

Родительский переключатель

На s1 в base родитель useButton имеет тип boolean, дочернее поле buttonTitle ссылается на него. При выключении родителя дочерний редактор скрывается; при включении снова показывается. Для новых зависимостей используйте логического родителя того же сайта и раздела.

Несколько сайтов и область раздела

Перед каждым изменением проверяйте сайт в заголовке. contacts.phone на s1 и s2 — независимые значения; глобальность раздела не создаёт автоматического наследования.

При добавлении раздела заполните код contacts, название «Контакты» и выберите «Область»:

• «Глобально» — раздел доступен всем сайтам, если не скрыт для конкретного сайта;
• «Только текущий сайт» — раздел относится к выбранному сайту.

Код и область существующего раздела в диалоге изменения заблокированы. Если contacts уже существует, используйте его; другой сценарий области демонстрируйте на изолированной копии, а не создавайте конфликтующий раздел.

Чтобы вернуть скрытый глобальный раздел, нажмите «Подключить существующие группы», отметьте нужный раздел и подтвердите действие. Раздел снова станет видимым; значения с другого сайта при этом не копируются.

Удаление: проверьте последствия

Перед удалением подготовьте резервную копию и выясните, какие шаблоны используют ключи. Тренируйтесь только на изолированном стенде.

Отдельная настройка

Включите редактирование, наведите указатель на нужное поле, нажмите «Удалить» и проверьте ключ в подтверждении. Удаляется настройка по её ID, а не весь раздел. Родителя с дочерними настройками удалить нельзя: сначала нужно изменить связи или удалить дочерние настройки, предварительно проверив использование в коде.

Раздел

«Удалить текущий раздел настроек» — другая операция. На уровне контроллера предусмотрены области site и global:

Повторное подключение скрытого раздела не восстанавливает удалённые строки. Для восстановления удалённых данных нужна резервная копия. Удаление самого модуля рассматривается в отдельной статье.