Произвольные свойства

Что умеет решение

Модуль «Произвольные свойства» обеспечивает централизованное хранилище типизированных данных для сайтов на 1С-Битрикс. Контактные данные в шапке, адреса офисов, подписи в подвале, ссылки на документы, изображения и рекламные тексты часто используются в нескольких шаблонах и компонентах одновременно. Хранить такие значения в коде неудобно, а создание отдельного инфоблока для небольшого набора настроек избыточно.

Модуль добавляет раздел административной панели «Контент → Произвольные свойства». В нём можно создавать поля нужного типа и изменять их значения через стандартный интерфейс 1С-Битрикс. Разработчику достаточно один раз внедрить компонент или вызвать PHP API, после чего контент обновляется без редактирования файлов сайта.

Возможности решения:

Единое хранилище общих данных и настроек сайта.

Стандартные типы пользовательских полей 1С-Битрикс: строка, число, дата, список, файл и другие.

Поддержка одиночных и множественных значений.

Визуальный HTML-редактор.

Выбор языка из зарегистрированных в системе.

Вывод значения компонентом tidx:customprops.value.

PHP API для использования значений в шаблонах и бизнес-логике.

Настройка значений по умолчанию.

Модуль обеспечивает автоматическое, текстовое и необработанное форматирование, а также вывод изображений и ссылок на файлы. Редактирование доступно из публичной части с использованием штатной проверки прав на пользовательские поля. Поддерживаются дополнительные типы свойств инфоблоков «Да/Нет» и «Язык». Возможна интеграция со sprint.migration для переноса структуры полей, значений и файлов.

Решение подходит для хранения телефонов, адресов и режима работы, заголовков и поясняющих текстов, лимитов и числовых параметров, юридических текстов и ссылок на документы, изображений, баннеров и файлов, а также HTML-блоков для шаблонов сайта. Модуль позволяет хранить другие значения, используемые одновременно в интерфейсе и программной логике.

Ключевые преимущества: не требуется создавать отдельный инфоблок или highload-блок, структура свойств определяется под конкретный проект, значения редактируются штатными средствами 1С-Битрикс, компонент размещается через визуальный редактор. Предоставляется простой PHP API, поддерживается разграничение прав. Модуль не изменяет шаблон сайта и не создаёт демонстрационные данные.

Пример вывода значения компонентом:

$APPLICATION->IncludeComponent(

'tidx:customprops.value',

'',

[

'CODE' => 'UF_PHONE',

Пример получения значения свойства через PHP API:

Используйте класс Values из пространства имен Tidx\CustomProps. Сначала подключите модуль через Loader::includeModule('tidx.customprops'), затем вызовите метод getString с идентификатором свойства, например UF_PHONE.

Системные требования:

Требуется PHP версии 8.1 или новее.

Модуль fileman необходим для работы визуального HTML-редактора.

Модуль iblock требуется для использования дополнительных типов свойств инфоблоков.

Модули fileman, iblock и sprint.migration не являются обязательными для базовой работы хранилища данных.

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