Настройка хлебных крошек 1С-Битрикс
Хлебные крошки в Битрикс формируются двумя способами: автоматически через структуру сайта и программно через метод AddChainItem. На практике возникают проблемы: крошки не отображаются, показывают неверный путь, или содержат технические заголовки страниц вместо пользовательских названий.
Как Битрикс формирует хлебные крошки
Битрикс автоматически строит цепочку навигации на основе структуры папок сайта. Каждая папка имеет файл .section.php, в котором задаётся название раздела для крошек.
Пример /catalog/.section.php:
<?
$APPLICATION->SetTitle('Каталог');
$APPLICATION->AddChainItem('Каталог', '/catalog/');
?>
Компонент bitrix:breadcrumb выводит собранную цепочку:
$APPLICATION->IncludeComponent('bitrix:breadcrumb', '', [
'START_FROM' => 0, // с какого уровня начинать (0 = от главной)
'PATH' => '', // пусто = текущий путь
'SHOW_ROOT' => 'Y', // показывать ли «Главная»
]);
Хлебные крошки в компонентах каталога
В компонентах bitrix:catalog.element и bitrix:catalog.section крошки добавляются автоматически при параметре ADD_SECTIONS_CHAIN = Y. Компонент добавляет в цепочку все разделы от корня до текущего, используя структуру инфоблока.
Если товар привязан к нескольким разделам — крошка строится по IBLOCK_SECTION_ID (основному разделу товара).
Программное добавление крошки
В любом PHP-коде или шаблоне компонента:
// Добавить элемент в цепочку
$APPLICATION->AddChainItem('Название пункта', '/path/to/page/');
// Переименовать последний пункт (текущую страницу)
$APPLICATION->SetTitle('Заголовок страницы'); // заголовок = последняя крошка
Цепочка хранится в объекте $APPLICATION и сбрасывается при каждом запросе.
Настройка шаблона крошек
Для кастомного вида хлебных крошек — создать шаблон компонента:
/local/components/bitrix/breadcrumb/templates/custom/template.php
Переменные в шаблоне:
-
$arResult['ITEMS']— массив элементов цепочки -
$item['TITLE']— название пункта -
$item['LINK']— URL пункта - Последний элемент без
LINK— текущая страница
Schema.org разметка для крошек
Для передачи структурированных данных поисковикам добавить микроразметку BreadcrumbList в шаблон:
$jsonLd = ['@context' => 'https://schema.org', '@type' => 'BreadcrumbList', 'itemListElement' => []];
foreach ($arResult['ITEMS'] as $pos => $item) {
$jsonLd['itemListElement'][] = [
'@type' => 'ListItem',
'position' => $pos + 1,
'name' => $item['TITLE'],
'item' => 'https://site.ru' . $item['LINK'],
];
}
echo '<script type="application/ld+json">' . json_encode($jsonLd, JSON_UNESCAPED_UNICODE) . '</script>';
Сроки выполнения
Настройка и кастомизация шаблона хлебных крошек со Schema.org разметкой — 2–4 часа.