Kokhanenko: HL-blocks

What this solution does

The Kokhanenko: HL-Blocks module is designed to display Highload-block data on website pages and edit records directly where they are shown. Developers connect components and configure templates, while content managers change text, images, and other fields via a public editor.

Content areas are provided for small page fragments as an alternative to file-based include areas. A single area code can hold distinct content for different languages and websites.

The module addresses the following tasks:

- Generating lists of news, services, employees, and partners based on Highload-blocks.

- Creating detailed record pages with images and relationships.

- Editing introductory texts, captions, and other editable template fragments.

- Providing different text for one area on Russian and English versions of the site.

- Configuring general SEO rules for a Highload-block and individual settings for its records.

Key features include two independent components: a list and a detailed record. Both components support field selection, filtering, sorting, and caching. The detailed record can be searched by ID or by the UF_UNIC_CODE field.

Inline editing. View, create, edit, and delete records according to standard HL-block permissions. The form opens upon user request.

Content areas. Supports plain text, multiline text, and trusted HTML. A separate value is stored for each language and site pair.

File and link management. Selected file fields and HL-links are expanded in batch mode. Specific fields of the linked record can be selected individually.

System fields. Activity, sorting, creation and modification dates, and unique code generation can be connected to selected HL-blocks.

Convenient fields. Uses standard Bitrix data types, a visual HTML editor, numeric input, and automatic unique code generation.

SEO and OpenGraph. Implements standard HL-block rules, inheritance and override of values at the element level, value templates, and preview functionality.

One area, multiple language versions

For example, the home.intro area displays Russian text on one site and English text on another. The editor opens the required page version and modifies its content. If a translation is not yet filled in, the text from the other language is not substituted automatically.

For developers

Components kokhanenko:hlblock.list, kokhanenko:hlblock.detail, and the template block kokhanenko:content.block are available. The PHP API allows building immutable queries via the Kokhanenko\Hlblocks\Facade\HlBlock::query() method, while the ContentItemWrapper::showBlock() method connects an editable area. In components, the HL block is selected by its technical name. Original file and relationship identifiers are preserved; additional data is stored in fields with the _DATA suffix. The general cache does not contain user permissions or form tokens.

To begin working, the highloadblock module must be installed and PHP 8.2 or newer is required. A developer configures the HL block structure, component placement, and styling. The news screenshots show an example project template: the installer does not create a ready-made news section. The module does not replace a trade catalog, page builder, or access control system for restricted data.

For the “Kokhanenko: HL-blocks” module, General iT can perform installation, configuration and a functional check in your project.