Kokhanenko: HL-блоки

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

Модуль «Kokhanenko: HL-блоки» предназначен для вывода данных Highload-блоков на страницах сайта и редактирования записей непосредственно в месте их отображения. Разработчик подключает компоненты и настраивает шаблоны, а контент-менеджер изменяет текст, изображения и другие поля через публичный редактор.

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

Модуль решает следующие задачи:

- Формирование списков новостей, услуг, сотрудников и партнеров на основе HL-блоков.

- Создание детальных страниц записей с изображениями и связями.

- Редактирование вступительных текстов, подписей и других фрагментов шаблона.

- Предоставление разных текстов для одной области на русской и английской версиях сайта.

- Настройка общих SEO-правил для HL-блока и индивидуальных параметров для каждой записи.

Основные возможности включают два независимых компонента: список и детальную запись. Оба компонента поддерживают выбор полей, фильтрацию, сортировку и кеширование. Поиск детальной записи осуществляется по ID или полю UF_UNIC_CODE.

Редактирование на странице. Просмотр, создание, изменение и удаление записей с учётом штатных прав HL-блока. Форма открывается по запросу пользователя.

Области контента. Поддерживаются обычный текст, многострочный текст и доверенный HTML. Для каждой пары «язык + сайт» хранится отдельное значение.

Работа с файлами и связями. Файловые поля и HL-связи раскрываются пакетно. Доступен выбор конкретных полей связанной записи.

Системные поля. К выбранным HL-блокам подключаются поля активности, сортировки, дат создания и изменения, а также генерация уникального кода.

Удобные поля. Используются штатные типы данных Битрикс, визуальный HTML-редактор, числовой ввод и автоматическая генерация уникального кода.

SEO и OpenGraph. Реализованы общие правила HL-блока, наследование и переопределение значений у элементов, шаблоны значений и предпросмотр.

Одна область — несколько языковых версий

Например, область home.intro выводит русский текст на одном сайте и английский на другом. Редактор открывает нужную версию страницы и изменяет её содержимое. Если перевод ещё не заполнен, текст другого языка не подставляется автоматически.

Для разработчика

Доступны компоненты kokhanenko:hlblock.list, kokhanenko:hlblock.detail и шаблонный блок kokhanenko:content.block. PHP API позволяет формировать неизменяемые запросы через метод Kokhanenko\Hlblocks\Facade\HlBlock::query(), а метод ContentItemWrapper::showBlock() подключает редактируемую область. В компонентах HL-блок определяется по техническому имени. Исходные идентификаторы файлов и связей сохраняются, дополнительные данные размещаются в полях с суффиксом _DATA. Общий кеш не включает пользовательские права и токены форм.

Для начала работы требуется установленный модуль highloadblock и версия PHP 8.2 или новее. Структуру HL-блоков, расположение компонентов и оформление настраивает разработчик. Представленные скриншоты новостей демонстрируют пример шаблона проекта: готовый новостной раздел не создается установщиком автоматически. Модуль не заменяет торговый каталог, конструктор страниц или систему проверки доступа к закрытым данным.

Внедрение «Kokhanenko: HL-блоки» можно поручить General iT — от установки до настройки и проверки совместимости с сайтом.