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

«Произвольные свойства» — универсальное хранилище типизированных данных для сайтов на 1С-Битрикс.

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

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

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

• единое хранилище общих данных и настроек сайта;
  
• стандартные типы пользовательских полей 1С-Битрикс: строка, число, дата, список, файл и другие;
  
• одиночные и множественные значения;
  
• визуальный HTML-редактор;
  
• выбор языка из зарегистрированных в системе;
  
• вывод значения компонентом tidx:customprops.value;
  
• PHP API для использования значений в шаблонах и бизнес-логике;
  
• значения по умолчанию;
  
• автоматическое, текстовое и необработанное форматирование;
  
• вывод изображений и ссылок на файлы;
  
• быстрое редактирование из публичной части;
  
• штатная проверка прав на пользовательские поля;
  
• дополнительные типы свойств инфоблоков «Да/Нет» и «Язык»;
  
• перенос структуры полей, значений и файлов через опциональную интеграцию со sprint.migration.
  

Модуль подойдёт для хранения:

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

Преимущества решения:

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

Пример вывода значения компонентом:
<?php
$APPLICATION->IncludeComponent(
   'tidx:customprops.value',
   '',
   [
       'CODE' => 'UF_PHONE',
       'DEFAULT' => '+7 (000) 000-00-00',
   ],
   false,
   ['HIDE_ICONS' => 'Y'],
);
?>

Пример получения значения через PHP API:
<?php

use Bitrix\Main\Loader;
use Tidx\CustomProps\Values;

if (Loader::includeModule('tidx.customprops')) {
   $phone = Values::getString('UF_PHONE');
}

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

• PHP 8.1 или новее;
  
• модуль fileman — для визуального HTML-редактора;
  
• модуль iblock — для дополнительных типов свойств инфоблоков.
  

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