Модуль "Настройки сайта"
Централизованное управление настройками сайта
Централизованное управление настройками сайта
Управляйте контентными и служебными параметрами проекта из единой административной панели. Объединяйте настройки в разделы, задавайте строгие типы данных и получайте проверенные значения в шаблонах через API. Поддерживается работа с несколькими сайтами.
Ключевые возможности
Единая панель настроек по сайтам и разделам
Настройки сгруппированы по сайтам и разделам: base, header, footer, main и другим. Управление доступно в разделе «Kokhanenko → Настройки сайта».
Строгие типы данных и удобные редакторы
Поддерживаются строки, логические значения, значения из списка, даты и время. Для редактирования используются текстовые поля, многострочный ввод, чекбоксы, списки, календарь и поле времени. Для списков доступен одиночный и множественный выбор. Значения проверяются перед сохранением.
Вложенные параметры и логические зависимости
Можно делать родительский чекбокс (isParent) и показывать дочерние поля (parentKey) только при необходимости.
Структура настройки и её значение
Редактирование определения настройки и сохранение её значения разделены на отдельные операции. Можно управлять описанием и параметрами поля отдельно от повседневного изменения его содержимого.
Быстрое подключение в шаблонах
Получайте типизированные значения через фасад Kokhanenko\Settings\Settings: Settings::get(...), Settings::all(...) и сокращённые вызовы Settings::base('key'). Метод Settings::has(...) позволяет проверить наличие активной настройки.
Производительность и многосайтовость
Кеш в рамках запроса + нативная работа с несколькими сайтами из одной установки.
Установка и быстрый старт
Установка модуля
- Установите решение
kokhanenko.settingsиз Маркетплейса в административной части 1С-Битрикс. - После установки модуль автоматически добавит пункт в меню
Kokhanenkoи подготовит базовую структуру настроек. - Для старта создаются разделы настроек по умолчанию (например:
base,header,footer,main).
Первичная настройка структуры
- Откройте раздел
Kokhanenko → Настройки сайтаи выберите нужный сайт (siteId). - Выберите нужный раздел настроек и при необходимости создайте новую группу через кнопку добавления.
- Добавьте ключевые параметры: телефоны, e-mail, подписи, тексты, ссылки и другие значения, которые часто меняются.
Добавление параметров под проект
- При создании настройки выберите тип данных:
string,boolean,enum,dateилиtime, затем — подходящий редактор. Для enum задайте допустимые варианты и при необходимости включите множественный выбор. - Группируйте поля по смыслу и задавайте подсказки для редакторов, чтобы снизить риск ошибок при заполнении.
- При необходимости используйте родительские/дочерние зависимости (например, чекбокс-включатель и связанные с ним поля).
Подключение в шаблоны и проверка
- Подключите модуль и получайте значения через Kokhanenko\Settings\Settings. Передавайте идентификатор сайта явно, если используете многосайтовость.
- Проверьте вывод в публичной части для нужного сайта и убедитесь, что данные подтягиваются корректно.
- После этого редактор может менять значения в админке без повторного привлечения разработчика.
Важно: поведение без siteId
- Если siteId не передан,
Settingsиспользует сайт по умолчанию из настроек Битрикса. Settings::base()иSettings::base('param1')возвращают данные только сайта по умолчанию.- Чтобы получить данные конкретного сайта, передавайте
siteIdявно:Settings::all('base', 's2'),Settings::base(null, 's2'),Settings::get('base', 'param3', 's2'),Settings::base('param3', 's2'). - Если параметр добавлен для
s2, но отсутствует вSettings::base(), это означает, что вызов выполнен безsiteIdи вернул значения сайта по умолчанию.
Галерея
