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

Начало

Страницы «Меню сайта» и «Ручное наполнение», формы создания и редактирования ручного меню, история версий, права доступа, перенос и настройки, боковые редакторы баннеров и брендов оформлены в едином стиле Qwelp. Поиск и действия в списке ручных меню сохраняют штатную работу Битрикс. Источник, общие изображения и пункты меню расположены в отдельных панелях; в узком окне таблица прокручивается внутри панели. Настройки разделены на вкладки источника и внешнего вида. В узкой рабочей области подписи переходят над полями. Источник меню и внешний вид сохраняются отдельными кнопками.

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

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

Установка сама не добавляет кнопку и не изменяет страницы сайта. Для подключения понадобится доступ к шаблону и базовое знание PHP.

Подключение

Вставьте пример в PHP-файл своего шаблона сайта в том месте, где должна находиться кнопка «Каталог», после подключения заголовка Битрикс. На обычной странице это место между bitrix/header.php и bitrix/footer.php. В редакторе компонента доступны те же параметры.

<button type="button" data-qmm-menu-trigger aria-controls="catalog-megamenu" aria-expanded="false">Каталог</button>
<?php
$APPLICATION->IncludeComponent('qwelp:megamenu.menu', '.default', [
    'SITE_ID' => '',
    'VIEW_TYPE' => 'site',
    'MAX_DEPTH' => 3,
    'SHOW_IMAGES' => 'Y',
    'SHOW_DESCRIPTIONS' => 'Y',
    'EDIT_MODE' => 'Y',
    'HTML_ID' => 'catalog-megamenu',
    'CACHE_TYPE' => 'A',
    'CACHE_TIME' => 3600,
    'CACHE_GROUPS' => 'N',
]);
?>

Оставьте SITE_ID пустым: модуль выберет текущий сайт. Значение VIEW_TYPE = site использует вид из настроек. Кнопка открывает меню, Escape закрывает его и возвращает фокус.

Публичное меню использует права гостя даже при просмотре администратором. Закрытые разделы каталога, изображения товаров и бренды исключаются из общего кеша.

Оформление

В настройках выберите один из четырёх видов. В меню сайта общие баннер и бренды действуют для пунктов без собственных изображений.

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

Баннер и бренды наследуются независимо. В список брендов можно добавлять строки, менять порядок, подписи, ссылки и изображения для тёмного оформления. Лимиты одного сохранения зависят от PHP: большой список сохраняйте частями.

Для тёмного оформления задайте data-qmm-theme="dark" элементу html. Цвета меняются собственными переменными --qmm-* в CSS сайта.

Кнопка «К меню сайта» в редакторе баннера и брендов закрывает боковое окно и возвращает к исходной странице. Если редактор открыт отдельной страницей, кнопка открывает меню выбранного сайта.

Проверка

1. Откройте страницу как посетитель. Проверьте кнопку, вложенные пункты, ссылки, картинки и закрытие по Escape.
2. Проверьте узкое окно и прокрутку длинного меню. Откройте страницу повторно с кешем и Композитом.
3. Измените пункт, опубликуйте черновик и убедитесь, что посетитель видит новую версию.
4. На втором сайте задайте другое меню и проверьте, что настройки первого не изменились.

Справка

Откройте «Перенести меню из инфоблока» в настройках. Если ручного меню ещё нет, введите название и создайте его прямо на странице переноса. Пункты вручную добавлять не нужно. Выберите источник и меню, нажмите «Проверить перенос», затем «Перенести в черновик» в результате проверки. Откроется редактор с перенесённой структурой. Режим с изображениями копирует изображения разделов, баннеры и логотипы брендов в локальные файлы модуля; штатное облачное хранилище Битрикс не мешает переносу локальных исходников. «Только структура» не копирует изображения. Повтор того же режима не создаёт дубль; после переноса структуры можно отдельно импортировать изображения. Проверьте черновик и нажмите «Сохранить и опубликовать». Затем в настройках выберите ручной источник и это меню, включите показ и сохраните источник. Перенос сам не переключает меню сайта. Редактор показывает последнюю публикацию, если после неё не сохранён более новый черновик.

Требования: PHP 8.2 и Bitrix main 25.900.0 или новее. Ручной источник не требует торгового каталога; автоматический использует штатные модули iblock и catalog. Импорт использует iblock. Внешних платных сервисов и встроенных покупок нет.