Опишите доработку или сценарий — обсудим вместе с другими клиентами.
Kokhanenko: HL-блоки
Скриншоты
Технические данные
Совместимые редакции
- Программа для ЭВМ "1С-Битрикс: Управление сайтом". Лицензия Старт
- Программа для ЭВМ "1С-Битрикс: Управление сайтом". Лицензия Стандарт
- Программа для ЭВМ "1С-Битрикс: Управление сайтом". Лицензия Малый бизнес
- Программа для ЭВМ "1С-Битрикс: Управление сайтом". Лицензия Бизнес
Описание
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-блок выбирается по техническому имени. Исходные ID файлов и связей сохраняются; дополнительные данные находятся в полях с суффиксом _DATA. Общий кеш не содержит пользовательские права и токены форм.
Что учитывать
Для начала работы нужны установленный модуль highloadblock и PHP 8.2 или новее. Структуру HL-блоков, размещение компонентов и оформление настраивает разработчик. Скриншоты новостей показывают пример шаблона проекта: готовый новостной раздел не создаётся установщиком. Модуль не заменяет торговый каталог, конструктор страниц или проверку доступа к закрытым данным.
Модуль устанавливается стандартными средствами Marketplace 1С-Битрикс.
Подробнее о модуле · Подробная инструкция
Требования
- «1С-Битрикс: Управление сайтом», установленный модуль highloadblock.
- PHP 8.2 или новее.
- Модуль main не ниже 20.5.400 и доступный ServiceLocator.
- Доступ администратора и права окружения на установку файлов и создание таблиц.
Схема ключей областей проверена на MySQL 8. Совместимость с другими СУБД требует отдельной проверки. Минимальная версия main — проверка установщика, а не перечень всех проверенных сочетаний PHP и ядра. Перед установкой на рабочий сайт проверьте модуль на его копии и создайте резервную копию файлов и базы данных.
Установка
- Откройте «Marketplace → Установленные решения».
- Загрузите решение kokhanenko.hlblocks, если его файлы ещё не загружены.
- У строки «Kokhanenko: HL-блоки» выберите действие «Установить».
- Дождитесь сообщения об успешной установке и обновите административное меню.
- Откройте «Kokhanenko → HL-блоки». Проверьте разделы «Управляемые HL-блоки» и «Области».
Установщик создаёт хранилища областей ContentItems и ContentValues, таблицу SEO/OpenGraph, устанавливает компоненты и ресурсы редакторов. Пример новостей со скриншотов и его оформление не создаются автоматически.
Первичная настройка
- Для данных проекта создайте или выберите HL-блок штатными средствами Битрикса.
- При необходимости добавьте системные поля через «Управляемые HL-блоки → Подключить выбранные».
- Разместите компонент списка или детальной записи, выберите HL-блок по техническому имени и укажите поля.
- Назначьте редакторам необходимые штатные права HL. Параметр ENABLE_PUBLIC_EDIT включает интерфейс, но не выдаёт разрешения.
- Для областей контента назначьте права через «Области → Права доступа» и подключите область в шаблоне.
Первая область контента
Разработчик подключает модуль через Bitrix\Main\Loader::includeModule('kokhanenko.hlblocks') и вызывает Kokhanenko\Hlblocks\Template\ContentItemWrapper::showBlock('home.intro') в нужном месте страницы.
Редактор открывает страницу, наводит указатель на область, нажимает карандаш, вводит текст и сохраняет его. Значения для другого языка или сайта заполняются отдельно. До публикации страницы замените исходный код области её содержимым.
Проверка результата
- Компоненты показывают нужные записи и поля.
- У редактора доступны только разрешённые действия, у посетителя нет кнопок изменения.
- Области показывают правильные значения для каждого сайта и языка.
- После сохранения изменения видны на публичной странице; при композитном режиме проверена и HTML-копия.
Удаление
По умолчанию удаление сохраняет данные областей и SEO/OpenGraph для повторной установки. Снятие флага сохранения удаляет принадлежащие модулю хранилища. Собственные HL-блоки сайта и добавленные системные поля не удаляются. Перед удалением отключите вызовы модуля в шаблонах и сделайте резервную копию.
❓ Обратная связь и поддержка
По вопросам работы модуля, а также предложениям по добавлению новой функциональности, вы можете обращаться по электронной почте с 09-18 (Москва): info@kokhanenko.pro
Установите этот модуль прямо сейчас!
Для этого укажите адрес сайта:
Подтвердите что сама лицензия у вас куплена
