Главная / Документация / Шаблоны / WPBox / Модули

Хлебные крошки

Модуль Хлебные крошки выводит на сайте цепочку навигации, которая показывает текущий путь пользователя. Например: Главная > Блог > Название записи.

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

Как работает модуль

В теме есть два источника хлебных крошек:

  • Из темы — встроенный билдер WPBox сам собирает цепочку для текущей страницы.
  • SEO-плагин — тема берет готовые крошки из поддерживаемого плагина.

Сейчас поддерживаются Yoast SEO, Rank Math и Breadcrumb NavXT.

Если выбран SEO-плагин, но он неактивен, отключен или не отдает свою разметку, тема безопасно возвращается к встроенному источнику Из темы.

Настройки в кастомайзере

Все настройки находятся в кастомайзере Внешний вид > Настроить в разделе Модули > Хлебные крошки.

Если на сайте нет поддерживаемых SEO-плагинов, настройка выбора источника не показывается. В этом случае хлебные крошки всегда строятся самой темой.

Включение модуля

Настройка Включить хлебные крошки полностью включает или отключает модуль.

Если она выключена, хлебные крошки не выводятся ни в записи, ни на страницах архивов, ни в других разделах сайта.

Источник крошек

Настройка Источник крошек определяет, откуда брать готовую цепочку:

  • Из темы — используется встроенный билдер WPBox.
  • Yoast SEO — используются крошки плагина Yoast SEO.
  • Rank Math — используются крошки плагина Rank Math.
  • Breadcrumb NavXT — используются крошки плагина Breadcrumb NavXT.

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

Если выбран SEO-плагин, настройки встроенного билдера темы ниже скрываются, потому что в этом режиме структуру крошек определяет сам плагин.

Показывать в архивах

Настройка Показывать в архивах отвечает за вывод хлебных крошек на архивных страницах, включая страницу записей.

Если настройка выключена, в рубриках, метках, архивах дат, авторах и на странице блога хлебные крошки не выводятся.

Ярлык главной страницы

Настройка Ярлык главной страницы задает текст первого элемента цепочки. Обычно это Home или Главная.

Настройка Ссылка на главную задает URL первого элемента цепочки.

Можно использовать как полный адрес сайта, так и относительный путь, например /.

Разделитель

Настройка Разделитель задает символ между элементами цепочки во встроенном билдере темы.

Например, это может быть /, > или другой символ из списка.

Если разработчик задает разделитель через хук, стандартная настройка скрывается, а вместо нее показывается уведомление.

Показывать заголовок текущей страницы

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

Если настройка выключена, модуль оставляет только путь до текущего объекта, без последнего пункта с его названием.

Показывать номер страницы

Настройка Показывать номер страницы добавляет в конец цепочки номер текущей страницы пагинации.

Например, на второй странице архива может получиться такой вариант:

Главная / Блог / Страница 2

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

Настройка Включить разметку schema.org добавляет в HTML хлебных крошек микроразметку BreadcrumbList.

По умолчанию эта настройка включена. Она помогает поисковым системам лучше понимать структуру навигации страницы.

Работа с SEO-плагинами

Если вы хотите использовать крошки SEO-плагина, сначала убедитесь, что они включены и настроены в самом плагине.

Для разных плагинов это может выглядеть по-разному:

  • Yoast SEO — в настройках плагина должен быть включен вывод breadcrumbs.
  • Rank Math — в настройках плагина должны быть включены хлебные крошки в разделе Основные настройки.
  • Breadcrumb NavXT — плагин выводит собственную разметку, а тема добавляет внешнюю обертку для единых отступов и быстрой настройки из кастомайзера.

Если выбранный плагин не возвращает HTML крошек, тема автоматически использует встроенный источник Из темы.

Хуки

Если стандартных настроек недостаточно, модуль можно доработать с помощью хуков. Подробнее о том, как работают хуки в теме, читайте в этой статье.

Ниже перечислены основные хуки, которые относятся к хлебным крошкам.

wpbox/breadcrumbs/init

Срабатывает после базовой настройки встроенного билдера. Через него можно изменить поведение билдера до вывода крошек.

add_action( 'wpbox/breadcrumbs/init', function( $builder, $module ) {
    // Здесь можно настроить билдер перед выводом.
}, 10, 2 );

wpbox/breadcrumbs/is_enabled

Позволяет программно включить или отключить хлебные крошки для текущего запроса.

add_filter( 'wpbox/breadcrumbs/is_enabled', function( $enabled, $module ) {
    if ( is_search() ) {
        return false;
    }

    return $enabled;
}, 10, 2 );

wpbox/breadcrumbs/items

Позволяет изменить массив элементов встроенной цепочки перед финальным рендером.

add_filter( 'wpbox/breadcrumbs/items', function( $items, $args, $builder ) {
    return $items;
}, 10, 3 );

Позволяет изменить уже готовый HTML отдельных пунктов перед выводом общей цепочки.

add_filter( 'wpbox/breadcrumbs/links', function( $links, $items, $module ) {
    return $links;
}, 10, 3 );

wpbox/breadcrumbs/separator

Позволяет задать разделитель через код вместо настройки в интерфейсе.

add_filter( 'wpbox/breadcrumbs/separator', function( $separator, $module ) {
    return '»';
}, 10, 2 );

wpbox/breadcrumbs/plugin_html

Позволяет изменить HTML, который тема получила от SEO-плагина, до финальной обертки и вывода.

add_filter( 'wpbox/breadcrumbs/plugin_html', function( $html, $module ) {
    return $html;
}, 10, 2 );

wpbox/breadcrumbs/user_title

Позволяет изменить подпись элемента на странице автора.

add_filter( 'wpbox/breadcrumbs/user_title', function( $title, $user, $builder ) {
    return $title;
}, 10, 3 );

wpbox/breadcrumbs/item_additional_content

Позволяет добавить дополнительный HTML внутрь отдельного пункта цепочки.

add_filter( 'wpbox/breadcrumbs/item_additional_content', function( $content, $item, $index, $count, $module ) {
    return $content;
}, 10, 5 );

CSS-переменные

Подробнее о работе с CSS-переменными и о том, где их можно переопределить, читайте в этой статье. Обычно достаточно настроек кастомайзера, но при необходимости вы всегда можете изменить нужные CSS-переменные вручную.

По умолчанию хлебные крошки используют приглушенный цвет текста из палитры сайта. Его можно поменять через настройку Дизайн > Палитра сайта > Muted Text Color или переопределить вручную через CSS.

--wpbox-breadcrumbs-color: var(--wpbox-text-muted-color); /* Цвет текста хлебных крошек */
--wpbox-breadcrumbs-gap: .375rem;                         /* Расстояние между элементами */
--wpbox-breadcrumbs-font-size: .8rem;                    /* Размер текста */
  • Как работает модуль
  • Настройки в кастомайзере
  • Включение модуля
  • Источник крошек
  • Показывать в архивах
  • Ярлык главной страницы
  • Ссылка на главную
  • Разделитель
  • Показывать заголовок текущей страницы
  • Показывать номер страницы
  • Микроразметка
  • Работа с SEO-плагинами
  • Хуки
  • wpbox/breadcrumbs/init
  • wpbox/breadcrumbs/is_enabled
  • wpbox/breadcrumbs/items
  • wpbox/breadcrumbs/links
  • wpbox/breadcrumbs/separator
  • wpbox/breadcrumbs/plugin_html
  • wpbox/breadcrumbs/user_title
  • wpbox/breadcrumbs/item_additional_content
  • CSS-переменные

    • 2026 © Поддержка WPShop.ru - Регламент технической поддержки