Документация

Начало

Первый результат за три шага

Модуль объединяет характеристики элементов инфоблока в группы и добавляет ссылки к значениям свойств. Для каждого раздела можно задать свой набор групп.

1. Откройте Группировки. В блоке «Создать новую группировку» выберите инфоблок, затем область применения.
2. Добавьте группу, задайте название, сортировку и выберите свойства. Нажмите «Применить» и проверьте сообщение об успешном сохранении.
3. Подключите вывод в шаблоне сайта по разделу «Подключение к сайту» и откройте карточку элемента.

Настройка групп сама по себе не заменяет разметку сайта. Разработчик один раз подключает API модуля; затем группы настраиваются через админку.

Открыть группировкиНастроить права

Группы и наследование

Группы и наследование

На стартовой странице показаны все доступные группировки без отдельного фильтра. Выбор инфоблока и раздела расположен в компактной панели. В редакторе поиск по коду или названию помогает выбрать свойства группы.

1. Выберите инфоблок и «Для всех разделов» либо конкретный раздел.
2. Добавьте группы: например, «Основные характеристики» и «Размеры». Меньшая сортировка выводится раньше.
3. Выберите свойства для каждой группы и сохраните. Свойства связываются по символьному коду: после переименования кода обновите настройку.

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

Ссылки значений

Сделать значение ссылкой

1. Откройте группировку и добавьте правило ссылок.
2. Выберите свойство и режим, включите правило. При необходимости задайте открытие в новой вкладке.
3. Нажмите «Применить», затем проверьте переход на сайте.

Хлопок=/materials/cotton/
Лён=/materials/linen/

Замените адреса примера существующими страницами. Разрешены локальные пути, якоря и HTTP/HTTPS; небезопасный адрес не выводится.

Справа от поля «Шаблон URL» нажмите «Переменные»: откроется список поддерживаемых макросов с пояснениями. Нажатие вставляет макрос в позицию курсора или вместо выделения. Окно закрывается крестиком или Escape. Поле используется в режиме «Элемент инфоблока», в том числе для свойств с привязкой к разделам; в ручном режиме и режиме фильтра оно не применяется. После вставки сохраните правило.

Подключение к сайту

Подключить API к шаблону

Раздел для разработчика. Модуль использует штатный Битрикс и собственные ресурсы; установка не изменяет шаблоны клиента.

1. Скопируйте шаблон catalog.element в шаблон сайта штатным способом. Сохраните исходную копию.
2. В result_modifier.php после подготовки DISPLAY_PROPERTIES добавьте код подготовки групп.
3. В template.php замените существующий блок характеристик примером вывода. Передавайте только разрешённые посетителю свойства.

if (\Bitrix\Main\Loader::includeModule('qwelp.propgroups'))
{
    $service = new \Qwelp\PropGroups\Service\PropertyGroupService(
        new \Qwelp\PropGroups\Repository\PropertyGroupRepository()
    );
    $arResult['PROPERTY_GROUPS'] = $service->groupProperties(
        $arResult['DISPLAY_PROPERTIES'] ?? [],
        $service->getGroupsForProduct(
            (int)$arResult['IBLOCK_ID'], (int)$arResult['IBLOCK_SECTION_ID']
        )
    );
    $arResult['PROPERTY_GROUPS'] = (new \Qwelp\PropGroups\Service\PropertyLinkResolver())
        ->enrichPropertyGroups($arResult['PROPERTY_GROUPS'], [
            'iblockId' => (int)$arResult['IBLOCK_ID'],
            'sectionId' => (int)$arResult['IBLOCK_SECTION_ID'],
            'siteId' => SITE_ID,
        ]);
}

<?php
if (\Bitrix\Main\Loader::includeModule('qwelp.propgroups'))
{
    echo \Qwelp\PropGroups\Service\PropertyValueRenderer::renderGroups(
        $arResult['PROPERTY_GROUPS'] ?? []
    );
}

Оформление и кеш

Добавьте оформление property-group и qwelp-propgroups__value-link в style.css клиентской копии шаблона. Штатный компонент подключает его и при попадании в кеш.

Регистрируйте тег iblock_id_ с ID исходного инфоблока в активном tagged cache компонента. API ссылок добавляет теги целевых инфоблоков. Собственный кеш должен учитывать сайт и группы доступа. Сохранение групп сбрасывает связанный кеш и Композит; произвольные сохранённые HTML-фрагменты должны иметь тот же тег.

Публичные ключи значений: VALUE_ITEMS и HAS_VALUE_LINKS. Интеграции с другими решениями выполняются только на стороне шаблона сайта через публичный API.

Проверка

Проверка после настройки

1. На своём тестовом инфоблоке проверьте текущий, дочерний и соседний разделы.
2. Сверьте порядок, свойства без группы, пустые и множественные значения.
3. Перейдите по ручной ссылке, ссылке элемента и фильтра, если они используются.
4. Повторите открытие с прогретым кешем и Композитом. Переименуйте группу: новое имя должно появиться без ручной очистки всего кеша.
5. Проверьте второй сайт, узкое окно и обычного посетителя.

Справка

Установка и справка

Время кеширования: Qwelp → Группировка свойств → Настройки. Права: Настройки → Настройки модулей → Группировка свойств → Доступ. Документация — последний пункт меню модуля.

Поддержка: qwelp.ru (https://qwelp.ru). Укажите версию модуля и Битрикса, действие и ошибку. Не передавайте пароли, sessid и лицензионный ключ.