Меню и структура сайта в Битрикс: настройка за 30 минут

За полчаса на «1С-Битрикс: Управление сайтом» можно собрать структуру из нескольких разделов и двухуровневое верхнее меню: с выпадающими пунктами, рабочими адресами вроде /about/history/ и корректной навигационной цепочкой. Руководство написано для коробочной версии. В Битрикс24 и в конструкторе сайтов меню устроено иначе.

Что нужно до начала

• Редакция «Управление сайтом» 22.x–24.x. Версию показывает страница обновления платформы в админке. Подписи кнопок в вашей сборке могут отличаться.
• Доступ в /bitrix/admin/ и право записи в корень сайта: группа администраторов или права на нужные папки.
• Шаблон сайта, где меню выводит компонент bitrix:menu. В стандартных шаблонах так и есть, в самописном проверьте header.php.
• Резервная копия, если сайт рабочий (раздел «Резервное копирование» в админке). Меню хранится в файлах, и синтаксическая ошибка в одном из них ломает вывод на всех страницах.

Тип меню - короткий идентификатор набора пунктов, например top или left. Он входит в имя файла: пункты типа top лежат в .top.menu.php в папке раздела. Список типов задаётся в настройках модуля «Управление структурой».

Меню в Битрикс ничего не знает о папках. Пункт и раздел связаны только ссылкой: переименуете папку, и пункт останется со старым адресом.

Шаги

1. Нарисуйте дерево. Адреса латиницей, глубина не больше трёх уровней. Для примера возьмём /about/ (О компании), /about/history/ (История), /about/contacts/ (Контакты) и /services/ (Услуги). Проверка: у каждой строки плана есть пара «название и адрес», адреса не повторяются.
2. Создайте папки и страницы. Откройте Контент → Структура сайта → Файлы и папки. Создайте в корне папку about, а внутри неё страницу index.php с заголовком «О компании». В форме папки укажите и название раздела: оно сохраняется в файле .section.php и попадает в навигационную цепочку. Так же создайте history и contacts внутри about и services в корне. Проверка: адрес /about/history/ открывается страницей, а не ошибкой 404.
3. Добавьте пункты в верхнее меню. Откройте сайт под администратором, включите режим правки на панели управления, наведите курсор на меню и выберите редактирование пунктов. Добавьте «О компании» с адресом /about/ и «Услуги» с адресом /services/, сохраните. Проверка: после обновления страницы оба пункта на месте и ведут на нужные адреса.
4. Подключите второй уровень. Откройте /about/ и добавьте в левое меню этой папки пункты «История» (/about/history/) и «Контакты» (/about/contacts/). Если левого меню в шаблоне нет, создайте файл /about/.left.menu.php вручную по образцу ниже. Затем задайте параметры компонента верхнего меню из таблицы. Проверка: при наведении на «О компании» открывается список из двух пунктов.
5. Проверьте навигационную цепочку. Откройте /about/history/. Проверка: над заголовком стоит цепочка «Главная / О компании / История». Если название раздела не показывается, убедитесь, что в /about/.section.php задана переменная $sSectionName.
6. Сбросьте кеш и посмотрите глазами гостя. Очистите кеш: Настройки → Производительность → Автокеширование. Откройте сайт в окне инкогнито. Проверка: гость видит те же пункты и то же подменю.

Что редактор записывает в файлы

Если удобнее работать без интерфейса, правьте файлы в «Файлы и папки» или по SFTP. Формат один и тот же. Пункт - это массив из пяти элементов: название, адрес, дополнительные адреса для подсветки, параметры и условие показа.

Файл /.top.menu.php:

<?php
// /.top.menu.php: верхнее меню, первый уровень
$aMenuLinks = [
    [
        'О компании', // текст пункта
        '/about/',    // адрес пункта
        [],           // дополнительные адреса для подсветки
        [],           // параметры пункта
        ''            // условие показа; пусто - показывать всем
    ],
    [
        'Услуги',
        '/services/',
        [],
        [],
        ''
    ],
];

Файл /about/.left.menu.php, из него компонент возьмёт второй уровень:

<?php
// /about/.left.menu.php: пункты второго уровня для раздела /about/
$aMenuLinks = [
    [
        'История',
        '/about/history/',
        [],
        [],
        ''
    ],
    [
        'Контакты',
        '/about/contacts/',
        [],
        [],
        ''
    ],
];

Параметры компонента верхнего меню

Откройте настройки компонента в режиме правки. Подписи в форме могут отличаться, ориентируйтесь на коды параметров.

Если не получилось

• Пункт добавлен, но на сайте его нет. Чаще всего виноват кеш компонента меню. Очистите кеш, а на время правок отключите кеширование в параметрах компонента.
• По адресу пункта открывается «Страница не найдена» (404). В ссылке опечатка или в папке нет index.php. Сравните ссылку с адресом в «Файлы и папки».
• После ручной правки белая страница или ошибка 500, в логе Parse error: syntax error. Текст зависит от версии PHP, но в нём будет путь к .top.menu.php или .left.menu.php и номер строки. Обычно потеряна запятая или скобка. Исправьте строку или верните файл из копии.
• Вместо русских букв в меню набор символов «Р» и «С» с лишними знаками. Файл сохранён в кодировке, отличной от кодировки сайта (UTF-8 или windows-1251). Пересохраните его в кодировке сайта.
• Подменю не выпадает. Шаблон меню одноуровневый или в MAX_LEVEL стоит 1. Выберите шаблон с вложенностью (в стандартных он обычно называется horizontal_multilevel) и сверьтесь с таблицей выше.

Что делать дальше

Следующий шаг зависит от сайта.

• Если в меню нужны разделы каталога или другие данные инфоблока, понадобятся файлы .menu_ext.php. Это отдельная тема, здесь она не разбирается.
• Если вы меняли адреса уже проиндексированных страниц, настройте 301-редиректы и следите за числом ошибок 404 в Яндекс Вебмастере и Google Search Console. Это главный показатель, что структура не потеряла трафик.
• Если сайт выкатывается из git, заранее решите, где живут файлы меню: в репозитории или вне деплоя. Иначе первый релиз перезапишет правки контент-менеджера.