bitrix:breadcrumb: настройка хлебных крошек

Хлебные крошки показывают путь от главной страницы до текущей и дают посетителю быстрый способ подняться на уровень выше. В Битрикс за их вывод отвечает компонент bitrix:breadcrumb, строящий цепочку автоматически на основе структуры разделов сайта.

Базовое подключение

<$APPLICATION->IncludeComponent(
    'bitrix:breadcrumb',
    'main',
    [
        'START_FROM'  => 0,
        'PATH'        => '',
        'SITE_ID'     => SITE_ID,
    ]
);?>

Компонент сам определяет текущее положение в структуре сайта и строит цепочку от корня. Дополнительно передавать данные о разделах не нужно — источником служит стандартная навигационная структура, та же, что используется для меню и определения активного раздела.

Откуда берутся названия пунктов

Название каждого звена цепочки формируется по правилам:

Именно поэтому важно, чтобы SetTitle() вызывался на каждой странице до того, как отработает breadcrumb, — иначе последнее звено цепочки останется пустым или подставится из технического значения по умолчанию.

Хлебные крошки на элементе инфоблока

Для страниц каталога цепочка обычно строится из названий родительских разделов плюс название самого товара. Это работает автоматически, если элемент выводится через штатный компонент детального просмотра и корректно связан с текущим разделом через переменные ЧПУ — без явной привязки компонент не сможет восстановить путь по дереву разделов.

Кастомизация звена вручную

Иногда автоматическое название не подходит — например, для страницы фильтра нужно показать не техническое название, а человекопонятное описание выбранных условий. Добавить своё звено в цепочку можно методом:

<?php
global $APPLICATION;

$APPLICATION->AddChainItem('Столы белые', '');

Вызов должен происходить до подключения компонента breadcrumb в шаблоне — обычно в теле страницы, до вывода footer.php, где обычно и располагается сам компонент хлебных крошек.

Параметр START_FROM

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

Оформление через шаблон

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

Микроразметка BreadcrumbList

Поисковые системы умеют показывать хлебные крошки прямо в выдаче, если страница размечена соответствующим стандартом структурированных данных. Стандартный шаблон компонента такую разметку не добавляет — её нужно внести в кастомизированный шаблон отдельно, оформив цепочку звеньев в формате BreadcrumbList.

Частые ошибки

• SetTitle() не вызван или вызван после компонента. Последнее звено цепочки остаётся пустым.
• Элемент каталога не связан с текущим разделом. Цепочка обрывается или показывает неверный путь.
• AddChainItem вызван после вывода компонента. Добавленное звено не попадает в уже сформированную цепочку.
• Нет микроразметки для поисковых систем. Возможность показать крошки прямо в выдаче не используется.

Итог

bitrix:breadcrumb строит цепочку навигации автоматически на основе структуры сайта и заголовков страниц, заданных через SetTitle(). Ручное добавление звеньев методом AddChainItem закрывает случаи, где автоматическое название не подходит — например, для страниц с параметрами фильтра, — а разметка BreadcrumbList в кастомизированном шаблоне даёт шанс показать крошки прямо в поисковой выдаче.