Налаштування хлібних крошок 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.ua' . $item['LINK'],
];
}
echo '<script type="application/ld+json">' . json_encode($jsonLd, JSON_UNESCAPED_UNICODE) . '</script>';
Тривалість виконання
Налаштування та кастомізація шаблону хлібних крошок з розміткою Schema.org — 2–4 години.