Best Персональные настройки
Промышленный модуль для централизованного хранения и управления настройками, константами и параметрами сайта на 1С-Битрикс или корпоративного портала Битрикс24.
Все параметры проекта — в одном месте
Best Персональные настройки — удобный инструмент централизованного хранения и управления настройками сайта на 1С-Битрикс или портала Битрикс24.
Модуль позволяет хранить название компании, логотип, номера телефонов, адреса, электронную почту, ссылки, идентификаторы элементов инфоблоков, API-ключи, флаги, режимы работы и любые другие параметры проекта. Администратор может изменять эти значения через единый понятный интерфейс, не редактируя PHP-код.
Созданные настройки можно использовать в шаблонах сайта, компонентах, агентах, обработчиках событий, функциях, интеграциях, собственных модулях и служебных скриптах.
Что можно хранить в модуле
Контактные данные
Телефоны, адреса, e-mail, реквизиты компании, режим работы и ссылки на социальные сети.
Файлы и изображения
Логотипы, документы, изображения, презентации и другие файлы из файловой системы Битрикс.
Системные параметры
Флаги, статусы, режимы работы, числовые параметры и служебные идентификаторы проекта.
Данные интеграций
API-ключи, токены, адреса внешних сервисов и параметры интеграции с другими системами.
Текст и HTML
Текстовые блоки, шаблоны сообщений и HTML-код практически любой длины.
Объекты Битрикс
Привязки к элементам и разделам инфоблоков, пользователям и другим сущностям платформы.
Основные возможности
- Единая административная страница для всех параметров проекта
- Быстрое редактирование значений непосредственно в таблице
- Добавление и удаление настроек через административную панель
- Отдельное хранилище значений на основе LONGTEXT
- Отсутствие ограничения стандартной опции в 2000 символов
- Поддержка множественных значений
- Поддержка стандартных пользовательских полей Bitrix
- Поддержка типов полей, добавленных сторонними модулями
- Уникальная привязка значения к каждой настройке
- Контроль прав доступа и защита сессии
- Транзакционное сохранение данных
- Простой статический API для использования в PHP
- Поддержка событий после изменения и удаления значений
- Совместимость с «1С-Битрикс: Управление сайтом»
- Совместимость с коробочной версией Битрикс24
- Фирменный административный интерфейс Best IT Pro
Поддерживаемые типы настроек
Модуль основан на штатном механизме пользовательских полей платформы. Благодаря этому доступны стандартные редакторы и типы данных Битрикс:
| Тип настройки | Пример использования |
|---|---|
| Строка | Название компании, телефон, адрес, e-mail, URL |
| Многострочный текст | Описание, уведомление, шаблон письма, юридический текст |
| HTML | Готовые HTML-блоки для шаблонов и компонентов |
| Число | Лимиты, коэффициенты, сроки, количество элементов |
| Список | Режим сайта, статус проекта, выбранный вариант поведения |
| Да/нет | Включение раздела, режима обслуживания или интеграции |
| Файл | Логотип, документ, изображение, инструкция |
| Дата и время | Дата запуска акции, срок действия режима или уведомления |
| Привязка к инфоблоку | Главный товар, рекомендуемая новость, раздел каталога |
| Множественное поле | Набор файлов, список элементов или несколько получателей |
Удобное управление через административную панель
После установки модуль добавляет страницу «Best Персональные настройки» в административную часть сайта. Все созданные параметры отображаются в единой таблице из двух основных колонок:
| Название настройки | Значение |
|---|---|
|
Название компании Код: COMPANY_NAME |
ООО «Моя компания» |
|
Основной телефон Код: PHONE |
+7 (495) 000-00-00 |
|
Логотип Код: LOGO |
Стандартное поле выбора файла Bitrix |
Администратор может изменить одну настройку или сохранить сразу все изменения. Для каждого значения используется редактор, соответствующий выбранному типу пользовательского поля.
Пример получения настройки в PHP
Для использования значения достаточно подключить модуль и вызвать
метод Manager::get().
<?php
use Bitrix\Main\Loader;
use Bestitpro\Settings\Manager;
if (Loader::includeModule('bestitpro.settings'))
{
$companyName = Manager::get('COMPANY_NAME', '');
$phone = Manager::get('PHONE', '');
$email = Manager::get('EMAIL', '');
$logoId = Manager::get('LOGO');
}
Вывод телефонного номера в шаблоне
<?php
use Bitrix\Main\Loader;
use Bestitpro\Settings\Manager;
if (Loader::includeModule('bestitpro.settings'))
{
$phone = (string)Manager::get('PHONE', '');
if ($phone !== '')
{
echo htmlspecialcharsbx($phone);
}
}
Изменение настройки из кода
<?php
use Bitrix\Main\Loader;
use Bestitpro\Settings\Manager;
if (Loader::includeModule('bestitpro.settings'))
{
Manager::set('SITE_MAINTENANCE', true);
}
Получение всех параметров
<?php
use Bitrix\Main\Loader;
use Bestitpro\Settings\Manager;
if (Loader::includeModule('bestitpro.settings'))
{
$settings = Manager::getAll();
}
PHONE или
UF_PHONE. Модуль нормализует символьное имя автоматически.
Где можно использовать значения
Шаблоны сайта
Вывод контактной информации, логотипов, уведомлений, реквизитов и других общих данных.
Компоненты
Передача параметров в стандартные и собственные компоненты без жёстко заданных констант.
Агенты и cron
Управление периодическими задачами, режимами запуска и параметрами фоновых обработчиков.
Интеграции
Хранение адресов API, токенов и параметров подключения к внешним сервисам.
События Битрикс
Использование параметров в обработчиках событий, почтовых уведомлениях и бизнес-логике.
Коробочный Битрикс24
Централизованная конфигурация корпоративного портала, интеграций и собственных решений.
Установка модуля
-
Загрузите модуль
Установите решение через Маркетплейс либо разместите каталог
bestitpro.settingsв директории/local/modules/. -
Запустите установку
Откройте раздел установленных решений в административной панели и нажмите кнопку установки модуля.
-
Создайте настройки
Перейдите на страницу «Best Персональные настройки», нажмите «Добавить настройку» и выберите подходящий тип поля.
-
Используйте значения в проекте
Получайте созданные параметры через
Bestitpro\Settings\Managerв любом PHP-коде проекта.
Техническая информация
| Идентификатор модуля | bestitpro.settings |
| Название | Best Персональные настройки |
| Версия | 1.0.0 |
| Хранилище | b_bestitpro_settings_value |
| API-класс | Bestitpro\Settings\Manager |
| Поддерживаемые продукты | 1С-Битрикс: Управление сайтом и коробочная версия Битрикс24 |
| Разработчик | Best IT Pro |
Частые вопросы
Чем модуль отличается от стандартных опций Битрикс?
Можно ли хранить текст объёмом более 2000 символов?
Поддерживает ли модуль файлы и изображения?
Можно ли использовать сторонние типы пользовательских полей?
Подходит ли решение для коробочного Битрикс24?
Нужны ли навыки программирования для изменения значений?
Управляйте настройками проекта централизованно
Перенесите общие параметры сайта или портала в единое управляемое хранилище. Сократите количество жёстко заданных значений в коде и упростите дальнейшее сопровождение проекта.
