Хлебные крошки показывают, где находится текущая страница и как вернуться к разделам выше. В WordPress их можно включить в настройках темы, вывести через SEO-плагин или добавить в шаблон. У ядра WordPress нет универсальной функции, которая строит такие навигационные цепочки для любых типов страниц.
Для большинства сайтов проще использовать уже установленный SEO-плагин: он формирует цепочку и может добавить разметку BreadcrumbList. Если тема уже выводит хлебные крошки, обычно достаточно включить эту настройку. Код в шаблон стоит добавлять, когда нужно точно выбрать место вывода или тема не предлагает подходящей настройки.
Выберите способ, который подходит вашему сайту
Прежде чем что-либо устанавливать, проверьте настройки активной темы и плагины. Две системы хлебных крошек на одной странице часто приводят к повторяющейся навигации и дублирующейся структурированной разметке.
| Способ | Когда подходит | Что учесть |
|---|---|---|
| Настройка темы | Тема уже умеет выводить хлебные крошки | Расположение и логика цепочки зависят от темы |
| SEO-плагин | Плагин уже установлен, а отдельной функции темы нет | Нужно включить функцию и разместить её вывод в шаблоне или редакторе |
| Собственная реализация | Нужны особые правила для типов записей или таксономий | Придётся самостоятельно поддерживать навигацию и, если нужно, микроразметку |
Если на сайте уже работает Yoast SEO или Rank Math, не устанавливайте ещё один плагин только ради крошек, пока не проверили возможности имеющегося. Настройки и доступные варианты вывода зависят от версии плагина.
Включите хлебные крошки в SEO-плагине
В настройках Yoast SEO найдите раздел хлебных крошек и включите их. Там же можно настроить подпись главной страницы, разделитель и другие параметры. Названия пунктов меню могут отличаться между версиями. Само включение не всегда размещает цепочку на сайте: иногда плагин только готовит вывод, а место для него нужно добавить в тему или редактор.
В Rank Math откройте настройки хлебных крошек и включите функцию. Плагин позволяет настроить отдельные элементы цепочки, но доступные параметры также зависят от версии и конфигурации сайта. Не включайте одновременно хлебные крошки в теме и SEO-плагине, если оба варианта выводятся на одной и той же странице.
Выведите крошки в шаблоне темы
Если нужна постоянная позиция — например, перед заголовком записи, — добавьте вызов плагина в соответствующий шаблон. Сначала сделайте резервную копию изменяемых файлов. Не редактируйте родительскую тему: обновление может перезаписать изменения. Используйте дочернюю тему, если она настроена, или предусмотренный темой способ переопределения шаблонов.
Для Yoast SEO в нужном месте шаблона можно использовать такой код:
<?php
if ( function_exists( 'yoast_breadcrumb' ) ) {
yoast_breadcrumb( "<nav class='breadcrumbs' aria-label='Хлебные крошки'>", '</nav>' );
}
?>Проверка function_exists() не даст шаблону вызвать функцию, если плагин отключён. Код разместите в файле шаблона, который отвечает за нужную страницу: например, в шаблоне записи или страницы. Имена файлов и устройство темы различаются; сначала проверьте, как она формирует страницу и нет ли у неё собственного места для вставки кода.
Для Rank Math используйте его функцию, а не вызов Yoast:
<?php
if ( function_exists( 'rank_math_the_breadcrumbs' ) ) {
echo "<nav class='breadcrumbs' aria-label='Хлебные крошки'>";
rank_math_the_breadcrumbs();
echo '</nav>';
}
?>Оба примера предназначены для PHP-шаблона, а не для поля текста в редакторе. Если вы используете редактор блоков, проще вставить поддерживаемый плагином шорткод в блок «Шорткод»: для Yoast SEO это [wpseo_breadcrumb], для Rank Math — [rank_math_breadcrumb]. Убедитесь, что шорткод действительно обрабатывается в выбранном месте; некоторые области темы не запускают обработку шорткодов.
Когда стоит использовать функцию темы
Если в теме есть настройка хлебных крошек, проверьте её до добавления кода. Готовая функция обычно учитывает шаблоны и стили темы, а также может правильно обрабатывать страницы, записи и архивы. Названия настроек отличаются: они могут находиться в настройщике темы, панели параметров или редакторе сайта.
Если функция темы не подходит, вызов SEO-плагина в дочерней теме даёт больше контроля над расположением, не заставляя самостоятельно строить цепочку. Собственный код имеет смысл, когда нужна логика, которой нет ни у темы, ни у плагина. Учитывайте, что для записей, страниц с родителями, архивов и пользовательских типов записей правила формирования пути различаются. Простая самодельная цепочка, рассчитанная только на записи, может некорректно работать на остальных страницах.
Проверьте вывод и избегайте дублей
После добавления откройте несколько типов страниц: запись, вложенную страницу и архив, если он есть на сайте. Убедитесь, что крошки отображаются один раз, ссылки ведут в нужные разделы, а текущая страница не ведёт сама на себя, если такой элемент присутствует в цепочке. Проверьте также мобильную версию и внешний вид после очистки кэша темы, плагина или CDN.
Если цепочка не появилась, проверьте, что функция включена в плагине, вызов находится в шаблоне нужного типа страницы и активен именно этот шаблон. При использовании шорткода проверьте, что он вставлен в блок «Шорткод», а не отображается на странице как обычный текст. Если крошки появились дважды, отключите один из источников — например, функцию темы или вызов плагина.
Некоторые SEO-плагины добавляют вместе с выводом хлебных крошек структурированные данные. Проверить разметку можно инструментом Google Rich Results Test или Schema Markup Validator, передав URL страницы. Наличие разметки не гарантирует, что поисковая система покажет хлебные крошки в сниппете: внешний вид результата определяет сам поисковик. На сайте при этом должна оставаться полезная видимая навигация, даже если поисковый сниппет её не отображает.