Bitrix произвольные поля

Bitrix произвольные поля (bitrix custom fields)
Идентификатор модуля: rozmuar.bcf

Модуль добавляет пользовательский тип свойства инфоблока —
«Произвольные поля». Это конструктор полей для карточки элемента: в настройках свойства администратор описывает произвольный набор полей, редактор элемента строит по этому описанию форму ввода, а на страницу значение отдаётся готовой структурой данных для вывода в шаблонах.

Функционально решение близко к WordPress ACF (Advanced Custom Fields): одно свойство заменяет десяток отдельных свойств инфоблока и даёт вложенные структуры, которые штатными средствами Bitrix не собрать.

• Не нужно заводить отдельное свойство инфоблока под каждое поле карточки и
  

 отдельный инфоблок под каждую повторяющуюся секцию.

• Структура карточки настраивается контент-менеджером в интерфейсе, без
  

 программиста и без правки кода шаблонов при добавлении поля.

• Значение в шаблоне доступно одним обращением — плоским массивом
  

 код => значение, вложенные группы и повторители — вложенными массивами.

1. Настройка свойства (инфоблок → «Свойства» → тип    «Произвольные поля (конструктор форм)», вкладка «Дополнительно»).    Для каждого поля задаются: код, метка, тип, инструкция для редактора, признак обязательности и настройки под конкретный тип. Порядок полей    меняется перетаскиванием за ручку ⠿.
   
2. Заполнение в карточке элемента: модуль рендерит форму по описанию — поля нужных типов, загрузка изображений и файлов штатными средствами    Bitrix, живой предпросмотр видео, поиск и выбор элементов инфоблока    перетаскиванием.
   
3. Вывод: значение свойства приходит на страницу готовым массивом прямо
   
4. Отдельной системы настроек модуль не имеет
   

  в VALUE:
  $res = CIBlockElement::GetByID($elementId);
  $element = $res->GetNextElement();
  $props = $element->GetProperties();

  $data = $props['ACF']['VALUE'];
  // [
  //   'headline'  => 'Заголовок',
  //   'gallery'   => [128, 129, 130],      // ID файлов
  //   'author'    => [45],                 // выбор элементов инфоблока — ID
  //   'features'  => [                     // повторитель
  //       ['title' => 'Быстро',  'text' => '...'],
  //       ['title' => 'Надёжно', 'text' => '...'],
  //   ],
  // ]

  Либо через CIBlockElement::GetProperty(...)->Fetch()['VALUE'].

Строка - однострочный текст
Текст (многострочный) - textarea
Число - целое/дробное, с ограничениями min / max / step
Ползунок (range) - число ползунком, min / max / step
E-mail - поле с проверкой формата
URL - поле с проверкой формата
Пароль - поле с маскировкой ввода
Визуальный редактор - WYSIWYG с переключением в HTML; HTML санитизируется
Сообщение - статичный текст-подсказка в форме, значение не хранит
Видео - ссылка на YouTube / Vimeo / видеофайл; живой предпросмотр в форме, встраивание (<iframe> / <video>) на странице
Выбор элементов инфоблока - инфоблок фиксируется в настройках поля; в карточке — две колонки «Все элементы» / «Выбранные», поиск по названию, перенос и сортировка перетаскиванием, одиночный или множественный выбор, лимит; значение — упорядоченный массив ID
Список (select) - выпадающий список; допускается множественный выбор
Флажки (checkbox) - набор флажков (множественный выбор)
Переключатель (radio) - выбор одного значения
Группа кнопок - то же, что radio, кнопками  Да / Нет  булев флаг
Ссылка - URL + текст + target; схема URL проверяется
Изображение - одно изображение через CFile, с превью
Файл - один произвольный файл через CFile
Галерея - несколько изображений, с лимитом
Дата - выбор даты
Дата и время - выбор даты и времени
Время - выбор времени
Цвет - выбор цвета
Вкладка - визуальный разделитель формы, значение не хранит
Группа полей - один вложенный набор полей (объект)
Повторитель - повторяющиеся вложенные наборы полей (массив объектов)