Установка и быстрый старт

Перед установкой

Проверьте сайт на тестовой копии и сохраните согласованную резервную копию файлов и базы данных.

Минимальная версия main — проверка установщика, а не обещание совместимости со всеми сочетаниями старого ядра и нового PHP. Интерфейсы в этой документации сняты на Битрикс 26.250.100. Комплект исходников модуля не требует установки Composer-зависимостей на рабочем сайте.

Установка через Marketplace

1. Войдите в административную часть.
2. Откройте Marketplace → Установленные решения (/bitrix/admin/partner_modules.php?lang=ru).
3. Загрузите доступное вашей лицензии решение kokhanenko.hlblocks из Marketplace. Если файлы уже загружены, этот шаг пропустите.
4. У строки «Kokhanenko: HL-блоки» откройте меню действий и выберите «Установить».
5. Дождитесь сообщения об успешной установке и обновите административное меню.
6. Откройте Kokhanenko → HL-блоки. Должны быть доступны «Управляемые HL-блоки» и «Области».

Инструкция Marketplace применима после публикации решения и выдачи лицензии. Для переданного установочного пакета разработчик размещает каталог kokhanenko.hlblocks в /local/modules/, затем выполняет шаги установки из списка решений. Не вкладывайте в /local/modules/ весь source-архив репозитория.

Что создаёт установщик

Создаются хранилища областей ContentItems и ContentValues, таблица SEO/OpenGraph, административные страницы, компоненты, JavaScript-ресурсы и обработчики событий. Собственные HL-блоки сайта автоматически не превращаются в управляемые: их выбирают отдельно.

Числовые ID хранилищ зависят от сайта. Не копируйте ID со скриншотов в свой код.

Первый результат: редактируемый текст

Разработчик добавляет после подключения ядра Битрикса в нужное место страницы или шаблона:

use Bitrix\Main\Loader;
use Kokhanenko\Hlblocks\Template\ContentItemWrapper;

if (Loader::includeModule('kokhanenko.hlblocks')) {
    ContentItemWrapper::showBlock('home.intro', 'div', 'intro');
}

Затем:

1. Откройте страницу под администратором или редактором с правами на области.
2. Наведите указатель на текст home.intro и нажмите значок карандаша.
3. Введите вступительный текст и нажмите «Сохранить».
4. Проверьте результат на странице и под посетителем без административных прав.

При первом обращении редактора с правом записи отсутствующее определение создаётся с типом text. Обычный посетитель не создаёт данные. До настройки область может показывать свой код — заполните её до открытия страницы посетителям.

Для второго сайта или языка заполните значение отдельно. Существующая область без перевода не копирует текст из другого контекста. Подробнее: области контента.

Для списка записей перейдите к компонентам. Если установка завершилась ошибкой, не удаляйте таблицы вручную: сохраните сообщение и воспользуйтесь диагностикой.