Хлебные крошки (навигационная цепочка): настройка

Хлебные крошки — это навигационная цепочка, которая показывает путь от главной страницы до текущей и помогает посетителю ориентироваться в структуре сайта. В 1С-Битрикс цепочка формируется автоматически, но её вывод и содержимое можно гибко настраивать.

Что такое навигационная цепочка и как она формируется

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

В 1С-Битрикс цепочка строится из двух источников:

• Названия разделов — берутся из свойства раздела (файл .section.php в каждой папке структуры);
• Заголовок текущей страницы — добавляется в конец цепочки автоматически на основании заголовка страницы или задаётся вручную.

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

Где подключается компонент хлебных крошек

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

1. Перейдите в Настройки → Настройки продукта → Сайты → Шаблоны сайтов.
2. Откройте на редактирование нужный шаблон и найдите файл header.php.
3. В коде шаблона отыщите вызов компонента bitrix:breadcrumb.

Типовой вызов компонента выглядит так:

$APPLICATION->IncludeComponent("bitrix:breadcrumb", "breadcrumb", array("START_FROM" => "0", "PATH" => "", "SITE_ID" => "s1"));

Второй параметр (breadcrumb) — это имя шаблона компонента. Именно в нём задаётся HTML-разметка и разделители между элементами цепочки.

Основные параметры компонента breadcrumb

У компонента навигационной цепочки немного настроек, но их важно понимать:

Параметр	Назначение
START_FROM	Порядковый номер элемента, с которого начинается вывод цепочки. Значение 0 — выводить с самого начала (обычно с «Главной»).
PATH	Путь, для которого строится цепочка. Пусто — используется путь текущей страницы.
SITE_ID	Идентификатор сайта (например, s1), из структуры которого берутся названия разделов.

Внешний вид (разделитель, ссылки, микроразметка) настраивается не параметрами, а шаблоном компонента в файле template.php.

Как задать названия разделов в цепочке

Название раздела, которое попадает в хлебные крошки, хранится в его свойстве Название. Изменить его можно двумя способами.

Через публичную часть:

1. Включите режим правки и откройте нужный раздел сайта.
2. На панели управления выберите Изменить → Свойства раздела.
3. Задайте поле Название — именно оно отобразится в цепочке.

Через админку: перейдите в Контент → Структура сайта → Файлы и папки, откройте свойства папки раздела и укажите название. Технически это значение сохраняется в файле .section.php строкой вида $sSectionName = "Каталог";.

Если у раздела не задано название, в цепочке для него не появится отдельного звена — учитывайте это при проектировании структуры.

Заголовок текущей страницы в конце цепочки

Последний элемент цепочки — текущая страница. По умолчанию туда подставляется заголовок страницы. Управлять им можно через свойство страницы title или напрямую из кода.

Чтобы задать заголовок страницы вручную, в начале файла страницы используйте:

$APPLICATION->SetTitle("Название страницы");

Для добавления дополнительного звена в цепочку без создания отдельного раздела применяется метод:

$APPLICATION->AddChainItem("Текст ссылки", "/path/to/page.php");

Если второй аргумент оставить пустым (""), звено выведется как обычный текст без ссылки — это удобно для последнего элемента цепочки.

Метод AddChainItem нужно вызывать до подключения шаблона (то есть до вызова bitrix:breadcrumb в header.php), иначе новое звено не попадёт в вывод.

Частые ошибки при настройке хлебных крошек

Разберём типичные проблемы, с которыми сталкиваются контент-менеджеры и разработчики.

• Цепочка не отображается вовсе. Скорее всего, компонент bitrix:breadcrumb удалён из шаблона или его шаблон не выводит разметку. Проверьте header.php.
• В цепочке пустые звенья. У промежуточных разделов не заданы названия. Задайте свойство Название каждому разделу структуры.
• Новое звено через AddChainItem не появляется. Вызов сделан после подключения шаблона. Переместите его в самое начало файла страницы.
• Дублируется последний элемент. Заголовок страницы и вручную добавленное звено совпадают. Уберите лишний AddChainItem или скорректируйте SetTitle.
• Нет микроразметки для поисковиков. Стандартный шаблон компонента не всегда содержит разметку Schema.org. Добавьте её в template.php шаблона компонента.
• Цепочка кэшируется со старыми названиями. После изменения свойств раздела сбросьте кэш в разделе Настройки → Настройки продукта → Автокэширование или очистите кэш компонента.

Итог

Хлебные крошки в 1С-Битрикс формируются компонентом bitrix:breadcrumb из названий разделов структуры и заголовка текущей страницы. Для базовой настройки достаточно корректно заполнять свойство Название у разделов и заголовки страниц.

Более тонкое управление доступно через API: AddChainItem добавляет собственные звенья, а SetTitle управляет последним элементом. Внешний вид и микроразметка настраиваются в шаблоне компонента. Проверяйте порядок вызовов и не забывайте про кэш — это снимает большинство проблем с отображением навигационной цепочки.