Документация для разработчиков
Темная тема

Основные понятия

Введение

Цель динамических блоков - отказ от компонентов Битрикс в обычном их понимании. Содержимое блока в базе (html) остается неизменным, а контент меняется динамически при формировании страницы. Разработчики, как и раньше, могут размещать компоненты внутри блоков. Однако тут возникают проблемы:
- кастомизации дизайна блоков в редакторе,
- допуск верстальщика к исполняемым PHP-файлам, что не всегда допускается безопасностью проекта.

В остальном цель динамических блоков одна - выводить динамический контент на страницах Сайтов24.

Источник

Источник - механизм, реализующий получение данных из внешней сущности (модуль продукта, БД, сторонний сайт и так далее).

Источник состоит из двух частей:

  • настраиваемого фильтра/готового пресета для отбора данных и загрузчика данных
  • загрузчика данных.

Создание источника возможно только в рамках модуля (не в init.php), т.к. идентификатор модуля (непустой) требуется при построении списка источников и получения ограничений.

Настраиваемый фильтр для отбора данных

Форма (компонент), в которой задаются условия отбора с возможностью просмотра результатов, подпадающих под условия. Форма должна вернуть условия отбора в определенном формате - фильтр блока.

Готовый пресет для отбора данных

Ненастраиваемый (жестко заданный) фильтр блока.

Загрузчик данных

Унифицированный интерфейс для получения данных из источника. Загрузчик любого источника должен быть наследником базового класса получения данных и реализовывать одинаковый набор публичных методов (см. описание класса \Bitrix\Landing\Source\DataLoader).


Регистрация источника

Для использования произвольного источника его необходимо зарегистрировать. Регистрация - передача описания источника в определенном формате через обработчик события регистрации. После успешной проверки (валидации) описания (см. Формат данных) источник считается зарегистрированным и может быть выбран для динамического блока.


Динамический блок

Содержимое такого блока не наполняется администратором, а берется из источника. Изменение содержимого происходит автоматически при изменении данных, возвращаемых источником.

Варианты динамических блоков

Существует 2 варианта: список элементов и детальная страница элемента.

Настройки списка элементов :

  • Источник
  • Фильтр блока
  • Сортировка данных
  • Элементы блока (ноды) с перечнем полей и свойств источника, подходящих для ноды

Настройки детальной страницы:

  • Привязка к списку элементов (выбор источника и фильтр блока берутся оттуда)
  • Элементы блока (ноды) с перечнем полей и свойств источника, подходящих для ноды


Пользовательские комментарии

Мы будем рады, если разработчики добавят свои комментарии по практическому использованию методов системы.

Для этого нужно всего лишь авторизоваться на сайте

Но помните, что Пользовательские комментарии, несмотря на модерацию, не являются официальной документацией. Ответственность за их использование несет сам пользователь.

Также Пользовательские комментарии не являются местом для обсуждения функционала. По подобным вопросам обращайтесь на форумы.
© «Битрикс», 2001-2021, «1С-Битрикс», 2021
Наверх