Что такое «Функция меню Битрикс»

Обычное меню Битрикс хранится в файлах вида .top.menu.php как простой массив: текст, ссылка, параметры. Такой список правят вручную, и для «О компании» или «Контактов» этого достаточно. Но когда пункты должны следовать за данными — разделами каталога, рубриками блога, статусом посетителя, — к меню добавляют программную часть. Её и называют функциями меню.

Два механизма

  • Файл расширения .тип.menu_ext.php. Лежит рядом с обычным файлом меню и выполняется после него. В нём в массив дописывают пункты из любого источника.
  • Условие показа. Пятый элемент описания пункта — PHP-выражение. Пункт выводится, только если оно истинно, например $USER->IsAuthorized() для ссылки «Личный кабинет».

Пример: разделы каталога в левом меню

<?php
if (!defined('B_PROLOG_INCLUDED') || B_PROLOG_INCLUDED !== true) die();
global $APPLICATION;

$aMenuLinksExt = $APPLICATION->IncludeComponent('bitrix:menu.sections', '', [
    'IBLOCK_TYPE' => 'catalog',
    'IBLOCK_ID'   => 2,
    'DEPTH_LEVEL' => 2,
    'CACHE_TIME'  => 3600,
], false);

$aMenuLinks = array_merge($aMenuLinks, $aMenuLinksExt);

Компонент bitrix:menu.sections возвращает разделы инфоблока в формате пунктов меню, и новый раздел каталога появляется в навигации сам, без правки файлов. Чтобы файл расширения выполнялся, у компонента меню на странице должен быть включён параметр USE_EXT.

Что учесть

  • Кэш. Меню кэшируется, и пункт с условием может показаться не тому пользователю. Для меню с условиями по правам включают параметр MENU_CACHE_USE_GROUPS, чтобы кэш учитывал группы.
  • Скорость. Запрос в .menu_ext.php выполняется на каждой странице с этим меню, поэтому без кэша не обойтись.
  • Права. Условие скрывает пункт, но не закрывает страницу: доступ к ней всё равно ограничивают правами доступа.

Связанные термины

Обновлено: 10 октября 2026

Все термины раздела «1С-Битрикс» ↗