- Быстрый старт: выводим хлебные крошки MODX
- Откуда берется цепочка навигации
- Документация по pdoCrumbs
- Параметры
- Полезные общие параметры pdoTools
- Шаблоны по умолчанию
- Плейсхолдеры
- Флаги pdoTools 3.1+
- Типовые примеры pdoCrumbs
- Минимальный вызов
- Ограничение количества пунктов
- Не показываем текущую страницу
- Исключаем ресурс
- Строим цепочку для другой страницы
- Вызов внутри pdoResources
- Хлебные крошки Bootstrap 5
- Практика FlexStart: заменяем статические крошки
- Заменяем nav.breadcrumbs
- Если крошки нужны в нескольких шаблонах
- Вставка вызова через интерфейс
- Как убрать хлебные крошки с главной
- Скрываем только навигацию
- Скрываем всю заголовочную область
- Почему не нужно разрывать обертку между шаблонами
- Микроразметка BreadcrumbList
- Microdata на стандартных тегах MODX
- Microdata на Fenom для FlexStart
- BreadcrumbList в формате JSON-LD
- Создаем сниппет breadSchema
- Подключаем вывод
- Проверяем хлебные крошки и микроразметку
- Частые ошибки pdoCrumbs
- О названиях и экранировании
- Что дальше
Для начала установите pdoTools и создайте хотя бы одну вложенную страницу. Например, раздел «Услуги» и страницу услуги внутри него. На таком примере будет видно, как pdoCrumbs добавляет родителей в навигационную цепочку.
Сначала разберем самостоятельный вызов и параметры, затем подключим крошки к FlexStart и добавим разметку BreadcrumbList.
Быстрый старт: выводим хлебные крошки MODX
Вставьте в шаблон внутренней страницы:
[[!pdoCrumbs?
&showHome=`1`
&showAtHome=`0`
&showCurrent=`1`
]]
Сохраните изменения и откройте вложенную страницу. В цепочке появятся главная, подходящие родительские ресурсы и текущая страница.
На Fenom:
{'!pdoCrumbs' | snippet : [
'showHome' => 1,
'showAtHome' => 0,
'showCurrent' => 1
]}
Выберите один синтаксис. Стандартный вызов MODX не требует Fenom.
В обычных примерах ниже используются плейсхолдеры [[+link]], [[+menutitle]] и [[+output]]. В Fenom-примерах им соответствуют {$link}, {$menutitle} и {$output}.
Разметку передаем через @INLINE. Этот префикс означает, что шаблон задан строкой, но сам по себе не включает Fenom.
Откуда берется цепочка навигации
pdoCrumbs строит путь по родительским ресурсам MODX. Например:
Услуги
└── Разработка сайтов
└── Корпоративный сайт
Для последней страницы можно получить:
Главная / Услуги / Разработка сайтов / Корпоративный сайт
Это не история переходов посетителя. Если человек пришел из поиска, цепочка все равно покажет положение страницы в структуре сайта.
Если все статьи лежат непосредственно в разделе блога, название рубрики не появится в цепочке само по себе. Текстовая TV с категорией не создает родительский ресурс.
pdoCrumbs не требует, чтобы URL буквально повторял дерево ресурсов. Однако страницы в цепочке должны образовывать понятный путь для посетителя.
Документация по pdoCrumbs
Сниппет входит в pdoTools и предназначен для построения навигационных цепочек. Его можно использовать вместо BreadCrumb.
pdoCrumbs принимает общие параметры pdoTools и собственные настройки. Значения по умолчанию могут быть переопределены в свойствах установленного сниппета и наборах параметров.
Параметры
| Параметр | По умолчанию | Описание |
|---|---|---|
&showLog |
0 |
Включает диагностику для пользователя с сессией менеджера. Начиная с pdoTools 3.0 лог выводится через плейсхолдер, а не добавляется к HTML. |
&from |
0 |
ID ресурса, от которого строится цепочка. Значение 0 означает корень дерева, а не ID главной страницы. |
&to |
ID текущего ресурса | Ресурс, для которого строится цепочка. При вызове внутри карточки другого сниппета передавайте нужный ID явно. |
&exclude |
Пусто | Список ID ресурсов, которые нужно исключить из цепочки. |
&toPlaceholder |
Пусто | Сохраняет итоговый результат в плейсхолдер с указанным именем вместо непосредственного вывода. |
&outputSeparator |
\n |
Строка между результатами. Для списка с CSS-разделителями обычно можно передать пустое значение. |
&tpl |
Стандартный шаблон ссылки | Оформляет обычный пункт цепочки. В штатных свойствах pdoCrumbs предусмотрена базовая разметка. |
&tplCurrent |
Стандартный шаблон текущего пункта | Оформляет текущую страницу. Обычно это текст без ссылки. |
&tplMax |
Шаблон многоточия | Добавляется при сокращении цепочки параметром limit. |
&tplHome |
Пусто | Отдельное оформление главной. Если специальный шаблон не задан, используется обычное оформление ссылки. |
&tplWrapper |
Стандартная обертка | Оборачивает результат. Получает цепочку в [[+output]]. Не применяется при раздельном выводе через toSeparatePlaceholders. |
&wrapIfEmpty |
Выключено | Разрешает вывод обертки даже при пустом результате. Для обычных крошек обычно не требуется. |
&showCurrent |
1 |
Добавляет текущую страницу в цепочку. |
&showHome |
0 |
Добавляет главную страницу в начало цепочки. |
&showAtHome |
1 |
Разрешает вывод крошек на главной. Для внутренней навигации обычно задают 0. |
&hideSingle |
0 |
Скрывает одиночный результат. Проверяйте поведение вместе с настройками главной и текущей страницы. |
&direction |
ltr |
Порядок цепочки: ltr или rtl. Изменение порядка не заменяет настройку направления текста и оформления страницы. |
Полезные общие параметры pdoTools
| Параметр | Для чего нужен |
|---|---|
&limit |
Ограничивает количество пунктов. Если цепочка сокращается, учитывайте оформление tplMax. Значение по умолчанию смотрите в свойствах своей версии. |
&scheme |
Определяет формирование ссылок. Для абсолютных URL используйте full. |
&showHidden |
Разрешает включать ресурсы, скрытые из меню. Для крошек это бывает полезно, потому что скрытый пункт меню может оставаться нормальным разделом сайта. |
&showUnpublished |
Разрешает неопубликованные ресурсы. В публичных примерах оставляем 0. |
&checkPermissions |
Задает проверяемые разрешения пользователя. Особенно важно для закрытых разделов. |
&toSeparatePlaceholders |
Размещает результаты в отдельных плейсхолдерах вместо обычной общей обертки. |
Полный список общих настроек находится в документации pdoTools.
Шаблоны по умолчанию
| Параметр | Разметка |
|---|---|
&tpl |
@INLINE <li><a href="[[+link]]">[[+menutitle]]</a></li> |
&tplCurrent |
@INLINE <li class="active">[[+menutitle]]</li> |
&tplMax |
@INLINE <li class="disabled"> ... </li> |
&tplHome |
Отдельный шаблон не задан. |
&tplWrapper |
@INLINE <ul class="breadcrumb">[[+output]]</ul> |
В старых выпусках и измененных наборах свойств разметка может отличаться. Поэтому в примерах для конкретного шаблона задаем ее явно.
Плейсхолдеры
| Плейсхолдер | Описание |
|---|---|
id |
ID ресурса крошки. |
pagetitle |
Заголовок ресурса. |
menutitle |
Название для навигации с подстановкой заголовка при пустом поле меню. |
link |
Подготовленная ссылка. |
idx |
Порядковый номер выводимого пункта, используется в разметке position. |
output |
Готовая цепочка внутри tplWrapper. |
Данные отдельной строки доступны в шаблонах пунктов. Не рассчитывайте, что tplWrapper автоматически получит pagetitle текущей крошки или все поля последнего ресурса.
Флаги pdoTools 3.1+
В pdoTools 3.1.0+ для MODX 3 дополнительно доступны:
| Плейсхолдер | Описание |
|---|---|
isFirst |
Первая крошка. |
isLast |
Последняя крошка. |
isActive |
Крошка текущей страницы. |
isHome |
Крошка стартовой страницы сайта. |
Это значения 0 или 1. В старую ветку pdoTools такие условия без проверки не переносим. Отдельные шаблоны tpl, tplCurrent и tplHome продолжают работать.
Первоисточник: документация pdoCrumbs.
Типовые примеры pdoCrumbs
Минимальный вызов
[[!pdoCrumbs]]
Выводит цепочку для текущего ресурса с настройками установленного сниппета.
Ограничение количества пунктов
[[!pdoCrumbs?
&limit=`2`
]]
При сокращении цепочки используется tplMax. Для хлебных крошек со Schema.org лучше сохранять осмысленный путь и не размечать многоточие как обычный раздел.
Не показываем текущую страницу
[[!pdoCrumbs?
&showHome=`1`
&showCurrent=`0`
]]
Полезно, если рядом уже находится заголовок и в самой цепочке нужны только ссылки на вышестоящие разделы.
Исключаем ресурс
[[!pdoCrumbs?
&showHome=`1`
&exclude=`10`
]]
10 — условный ID исключаемого ресурса. Не убирайте раздел только ради сокращения строки, если после этого путь становится непонятным.
Строим цепочку для другой страницы
[[!pdoCrumbs?
&to=`10`
&showHome=`1`
]]
Вместо 10 укажите нужный ресурс. Это не обязательно страница, на которой размещен вызов.
Вызов внутри pdoResources
В чанке карточки можно построить путь для ресурса этой карточки:
<h3>[[+pagetitle]]</h3>
<p>[[+introtext]]</p>
[[!pdoCrumbs?
&to=`[[+id]]`
&showCurrent=`0`
&showHome=`1`
]]
На Fenom:
<h3>{$pagetitle}</h3>
<p>{$introtext}</p>
{'!pdoCrumbs' | snippet : [
'to' => $id,
'showCurrent' => 0,
'showHome' => 1
]}
Параметр to здесь важен. Без него цепочка может строиться для страницы со списком, а не для материала внутри карточки.
Хлебные крошки Bootstrap 5
В Bootstrap список получает класс breadcrumb, пункты — breadcrumb-item, а текущая страница дополнительно active и aria-current="page".
Исходный пример из прежней редакции:

Вывод через pdoCrumbs:
[[!pdoCrumbs?
&showHome=`1`
&showAtHome=`0`
&showCurrent=`1`
&outputSeparator=``
&tplWrapper=`@INLINE <nav aria-label="Хлебные крошки"><ol class="breadcrumb">[[+output]]</ol></nav>`
&tpl=`@INLINE <li class="breadcrumb-item"><a href="[[+link]]">[[+menutitle]]</a></li>`
&tplHome=`@INLINE <li class="breadcrumb-item"><a href="[[+link]]">Главная</a></li>`
&tplCurrent=`@INLINE <li class="breadcrumb-item active" aria-current="page">[[+menutitle]]</li>`
]]
{'!pdoCrumbs' | snippet : [
'showHome' => 1,
'showAtHome' => 0,
'showCurrent' => 1,
'outputSeparator' => '',
'tplWrapper' => '@INLINE <nav aria-label="Хлебные крошки"><ol class="breadcrumb">{$output}</ol></nav>',
'tpl' => '@INLINE <li class="breadcrumb-item"><a href="{$link}">{$menutitle}</a></li>',
'tplHome' => '@INLINE <li class="breadcrumb-item"><a href="{$link}">Главная</a></li>',
'tplCurrent' => '@INLINE <li class="breadcrumb-item active" aria-current="page">{$menutitle}</li>'
]}
Разделители Bootstrap добавляет через CSS. Если пункты слились, проверьте наличие breadcrumb-item и подключение стилей. Добавлять символ / вручную между каждым пунктом обычно не нужно.
Практика FlexStart: заменяем статические крошки
В текущей версии FlexStart заголовочная область отделена от навигации:
<div class="page-title">
<div class="heading">...</div>
<nav class="breadcrumbs">
<div class="container">
<ol>
<li><a href="index.html">Home</a></li>
<li class="current">Service Details</li>
</ol>
</div>
</nav>
</div>
Это фрагмент структуры, а не полный код заголовочной области. Содержимое heading, заголовок страницы и описание оставьте из своего рабочего шаблона.
Не переносите сюда старую секцию section class="breadcrumbs" вместе с дополнительным заголовком. В текущем макете это другая структура.
Заменяем nav.breadcrumbs
В шаблоне внутренней страницы замените весь статический nav class="breadcrumbs" следующим вызовом:
{'!pdoCrumbs' | snippet : [
'showHome' => 1,
'showAtHome' => 0,
'showCurrent' => 1,
'showHidden' => 1,
'showUnpublished' => 0,
'scheme' => 'full',
'outputSeparator' => '',
'tplWrapper' => '@INLINE <nav class="breadcrumbs" aria-label="Хлебные крошки"><div class="container"><ol>{$output}</ol></div></nav>',
'tpl' => '@INLINE <li><a href="{$link}">{$menutitle}</a></li>',
'tplHome' => '@INLINE <li><a href="{$link}">Главная</a></li>',
'tplCurrent' => '@INLINE <li class="current" aria-current="page">{$menutitle}</li>'
]}
pdoCrumbs сам формирует nav, контейнер и список. Старую обертку вокруг вызова не оставляйте, иначе получите вложенные контейнеры и повторную навигацию.
Здесь используется класс current из FlexStart. Классы breadcrumb-item из отдельного Bootstrap-примера не добавляем.
Сохраните шаблон и откройте услугу или вложенную страницу. Вместо статической пары ссылок должен появиться путь по ресурсам MODX.
Если крошки нужны в нескольких шаблонах
Если заголовочная область уже вынесена в общий чанк, замените статическую навигацию в нем. Если она находится отдельно в шаблонах услуг, проектов и блога, обновите соответствующий фрагмент в каждом из них.
Для повторного использования можно вынести только вызов pdoCrumbs в один чанк. Создавать отдельный файл для каждой строки tpl не нужно.
При файловой организации подойдет, например, файл:
core/elements/chunks/breadcrumbs.tpl
В него помещается полный вызов из предыдущего примера. Подключение на Fenom при базовом каталоге элементов core/elements/:
{include 'file:chunks/breadcrumbs.tpl'}
Если у вас уже есть рабочий чанк с другим именем, используйте его. Перестраивать файловый каркас ради крошек не требуется.
Вставка вызова через интерфейс
В некоторых версиях редактора можно перетащить сниппет из дерева элементов и заполнить параметры в открывшемся окне:

Скриншот показывает прежний интерфейс. Если ваш редактор не поддерживает перетаскивание, вставьте вызов вручную.
Как убрать хлебные крошки с главной
Скрываем только навигацию
Если весь HTML крошек находится в tplWrapper, достаточно:
&showAtHome=`0`
На Fenom:
'showAtHome' => 0
Именно так сделано в предыдущем примере. На главной не останется пустого nav, потому что его создает сам сниппет.
Скрываем всю заголовочную область
Параметр showAtHome не может убрать HTML, расположенный вне вызова. Если нужно скрыть вместе с крошками весь page-title, оберните существующий блок условием:
{if $_modx->resource.id != $_modx->config.site_start}
<div class="page-title">
{* Здесь существующий heading и вызов pdoCrumbs. *}
</div>
{/if}
Это схема размещения условия. Внутри оставьте свой полный код заголовочной области.
Сравниваем с site_start, а не с жестко заданным ID 1. Главной страницей может быть другой ресурс.
Если главная и внутренние страницы уже используют разные шаблоны, дополнительное условие может вообще не понадобиться.
Почему не нужно разрывать обертку между шаблонами
Не открывайте ol в tplHome и не закрывайте его в tplCurrent. При отключении главной или текущей страницы такая разметка может сломаться.
Вся обертка списка должна находиться в tplWrapper. Заголовок страницы удобнее оставить в заголовочной области шаблона.
Основной плейсхолдер обертки — output. Это не означает, что в ней запрещены поля страницы. Например, [[*pagetitle]] обращается к текущему ресурсу, а [[+pagetitle]] ожидает переданный плейсхолдер. Это разные источники данных.
Микроразметка BreadcrumbList
Для хлебных крошек используется BreadcrumbList. Каждый пункт описывается как ListItem с названием и позицией, а ссылка указывается через свойство item.
У последнего пункта ссылка необязательна. Поэтому текущую страницу можно оставить обычным текстом.
Разметка помогает описать цепочку для поисковой системы, но не гарантирует особое оформление результата, рост кликабельности или позиций.
Ниже два варианта: Microdata внутри видимых крошек и отдельный JSON-LD. Для одной и той же цепочки обычно достаточно одного согласованного варианта. Если BreadcrumbList уже формирует SEO-компонент или общий Schema.org-граф, не добавляйте второй независимый генератор без необходимости.
Microdata на стандартных тегах MODX
Пример для Bootstrap 5:
[[!pdoCrumbs?
&showHome=`1`
&showAtHome=`0`
&showCurrent=`1`
&showHidden=`1`
&showUnpublished=`0`
&scheme=`full`
&limit=`1000`
&tplMax=``
&outputSeparator=``
&tplWrapper=`@INLINE <nav aria-label="Хлебные крошки"><ol class="breadcrumb" itemscope itemtype="https://schema.org/BreadcrumbList">[[+output]]</ol></nav>`
&tpl=`@INLINE <li class="breadcrumb-item" itemprop="itemListElement" itemscope itemtype="https://schema.org/ListItem"><a itemprop="item" href="[[+link]]"><span itemprop="name">[[+menutitle]]</span></a><meta itemprop="position" content="[[+idx]]"></li>`
&tplHome=`@INLINE <li class="breadcrumb-item" itemprop="itemListElement" itemscope itemtype="https://schema.org/ListItem"><a itemprop="item" href="[[+link]]"><span itemprop="name">Главная</span></a><meta itemprop="position" content="[[+idx]]"></li>`
&tplCurrent=`@INLINE <li class="breadcrumb-item active" aria-current="page" itemprop="itemListElement" itemscope itemtype="https://schema.org/ListItem"><span itemprop="name">[[+menutitle]]</span><meta itemprop="position" content="[[+idx]]"></li>`
]]
Здесь задан высокий технический лимит и отключен шаблон многоточия. Для обычной структуры сайта цепочка не должна искусственно сокращаться до нескольких пунктов ради оформления.
У каждой ссылки присутствует itemprop="item". Одного itemprop="name" внутри ссылки недостаточно, чтобы указать адрес пункта.
Не добавляйте nofollow к обычной ссылке на главную только из-за наличия микроразметки.
Microdata на Fenom для FlexStart
Если используете этот вариант в практике, замените им прежний вызов крошек. Не выводите оба вызова подряд.
{'!pdoCrumbs' | snippet : [
'showHome' => 1,
'showAtHome' => 0,
'showCurrent' => 1,
'showHidden' => 1,
'showUnpublished' => 0,
'scheme' => 'full',
'limit' => 1000,
'tplMax' => '',
'outputSeparator' => '',
'tplWrapper' => '@INLINE <nav class="breadcrumbs" aria-label="Хлебные крошки"><div class="container"><ol itemscope itemtype="https://schema.org/BreadcrumbList">{$output}</ol></div></nav>',
'tpl' => '@INLINE <li itemprop="itemListElement" itemscope itemtype="https://schema.org/ListItem"><a itemprop="item" href="{$link}"><span itemprop="name">{$menutitle}</span></a><meta itemprop="position" content="{$idx}"></li>',
'tplHome' => '@INLINE <li itemprop="itemListElement" itemscope itemtype="https://schema.org/ListItem"><a itemprop="item" href="{$link}"><span itemprop="name">Главная</span></a><meta itemprop="position" content="{$idx}"></li>',
'tplCurrent' => '@INLINE <li class="current" aria-current="page" itemprop="itemListElement" itemscope itemtype="https://schema.org/ListItem"><span itemprop="name">{$menutitle}</span><meta itemprop="position" content="{$idx}"></li>'
]}
Сохраняются классы FlexStart и текущая страница без ссылки. Позиции передаются через idx, а не прописываются вручную.
BreadcrumbList в формате JSON-LD
JSON-LD выводится отдельно от видимого списка. Обычные крошки при этом остаются на странице, но их не обязательно размечать Microdata.
Не вставляйте название ресурса внутрь JSON простой подстановкой между кавычками. Например, название Студия "Пример" без JSON-кодирования нарушит строку.
Ниже pdoCrumbs получает ID ресурсов цепочки, а PHP собирает массив и передает его в json_encode(). Запятые между элементами вручную не расставляются.
Создаем сниппет breadSchema
Создайте сниппет breadSchema в разделе элементов и вставьте код:
<?php
if (!$modx->resource) {
return '';
}
$currentId = (int) $modx->resource->get('id');
$homeId = (int) $modx->getOption('site_start', null, 1);
$contextKey = (string) $modx->resource->get('context_key');
if ($currentId === $homeId) {
return '';
}
$idList = $modx->runSnippet('pdoCrumbs', [
'from' => 0,
'to' => $currentId,
'showHome' => 1,
'showAtHome' => 0,
'showCurrent' => 1,
'showHidden' => 1,
'showUnpublished' => 0,
'direction' => 'ltr',
'limit' => 1000,
'outputSeparator' => ',',
'tpl' => '@INLINE [[+id]]',
'tplHome' => '@INLINE [[+id]]',
'tplCurrent' => '@INLINE [[+id]]',
'tplMax' => '',
'tplWrapper' => '@INLINE [[+output]]'
]);
$ids = array_values(array_unique(array_filter(array_map('intval', explode(',', (string) $idList)))));
if (count($ids) < 2) {
return '';
}
$resourceClass = class_exists('MODX\\Revolution\\modResource')
? 'MODX\\Revolution\\modResource'
: 'modResource';
$items = [];
foreach ($ids as $id) {
$resource = $modx->getObject($resourceClass, [
'id' => $id,
'context_key' => $contextKey,
'published' => 1,
'deleted' => 0
]);
if (!$resource) {
return '';
}
$name = trim((string) $resource->get('menutitle'));
if ($name === '') {
$name = (string) $resource->get('pagetitle');
}
if ($id === $homeId) {
$name = 'Главная';
}
$name = html_entity_decode(strip_tags($name), ENT_QUOTES | ENT_HTML5, 'UTF-8');
$url = $modx->makeUrl($id, $contextKey, '', 'full');
if ($name === '' || $url === '') {
return '';
}
$items[] = [
'@type' => 'ListItem',
'position' => count($items) + 1,
'name' => $name,
'item' => $url
];
}
$data = [
'@context' => 'https://schema.org',
'@type' => 'BreadcrumbList',
'itemListElement' => $items
];
$json = json_encode(
$data,
JSON_UNESCAPED_UNICODE | JSON_HEX_TAG | JSON_HEX_AMP | JSON_HEX_APOS | JSON_HEX_QUOT
);
if ($json === false) {
return '';
}
return '<script type="application/ld+json">' . $json . '</script>';
Сохраните сниппет. В коде предусмотрены имена класса ресурса для MODX 2 и MODX 3.
На главной и при цепочке короче двух пунктов разметка не выводится. Адреса формируются через makeUrl(), позиции идут последовательно от единицы.
Этот пример рассчитан на обычные опубликованные ресурсы текущего контекста. Для закрытых разделов, нестандартных классов ресурсов и специальных правил навигации отдельно согласуйте права, адреса и состав цепочки.
Подключаем вывод
В шаблоне перед закрывающим head или в соответствующем общем чанке добавьте:
[[!breadSchema]]
На Fenom:
{'!breadSchema' | snippet}
Выберите один вариант вызова. Сам JSON-LD можно размещать и в теле страницы, но выводите его в одном согласованном месте.
Параметры цепочки внутри breadSchema должны соответствовать видимым крошкам. Если в основном выводе меняете from, exclude, показ главной или другие условия, внесите такие же изменения в генератор JSON-LD.
В этом примере главная называется «Главная», как в видимом списке выше. Если используете другое название, измените его в обоих местах.
Не добавляйте отдельный вызов, если ваш общий Schema.org-граф уже содержит нужный BreadcrumbList. В таком случае используйте один источник цепочки внутри существующего решения.
Проверяем хлебные крошки и микроразметку
- Откройте страницу первого уровня и вложенную страницу.
- Проверьте порядок разделов и переход по каждой ссылке.
- Убедитесь, что текущая страница выведена так, как задумано.
- Откройте главную и проверьте отсутствие лишней навигационной обертки.
- Посмотрите исходный HTML, в нем не должно быть необработанных плейсхолдеров.
- Для JSON-LD проверьте страницу с кавычками в названии.
- Проверьте разметку валидаторами.
Для Schema.org используйте Schema Markup Validator, для проверки требований Google — Rich Results Test. Дополнительно можно проверить страницу в валидаторе Яндекс Вебмастера.
Для BreadcrumbList Google требует как минимум два элемента ListItem. Проверяйте наличие названия, позиции и адресов промежуточных пунктов. У последнего пункта адрес необязателен.
Успешная проверка подтверждает корректность проверяемой разметки, но не гарантирует ее отображение в поиске.
Частые ошибки pdoCrumbs
| Проблема | Что проверить |
|---|---|
| Крошки не выводятся | Текущую страницу, showAtHome, hideSingle, showCurrent, from, to и условия выборки. |
| Нет нужного раздела | Родителя ресурса, exclude, публикацию, showHidden и ограничение цепочки. |
| Не появляется название рубрики из TV | TV не создает родителя. Нужна реальная структура рубрик или отдельная логика цепочки. |
| Крошки относятся к странице со списком, а не к карточке | Передайте ID карточки в to. |
| На главной осталась пустая полоса | Не находится ли внешний nav, контейнер или весь page-title вне скрываемого вызова. |
| Появились два списка | Не оставлен ли статический ol вокруг вызова с собственной оберткой. |
| Сломалась вложенность HTML | Все открывающие и закрывающие теги обертки должны находиться в tplWrapper. |
| Bootstrap-пункты слились | Классы breadcrumb, breadcrumb-item и подключение CSS. |
| FlexStart выглядит иначе | Не заменены ли его классы breadcrumbs и current классами другого примера. |
| Неверные ссылки на вложенных страницах | Используйте link, проверьте базовый URL, контекст и scheme. |
| Microdata не видит адрес пункта | У ссылки должен быть itemprop="item", а не только название внутри span. |
| JSON-LD ломается на кавычках | Не собирайте JSON простой склейкой строк. Используйте json_encode(). |
| Появились разные цепочки в разметке | Проверьте SEO-компонент, общий Schema.org-граф и отдельные вызовы генераторов. |
| Виден код Fenom | Настройки обработки Fenom. Файловое хранение и @INLINE сами по себе его не включают. |
О названиях и экранировании
В коротких HTML-примерах оставлен обычный вывод названий ресурсов. Если в них встречаются HTML-спецсимволы или используются недоверенные данные, применяйте экранирование.
На Fenom, например:
<a href="{$link | escape}">{$menutitle | escape}</a>
Для стандартных тегов можно использовать htmlent. Если добавляете модификатор прямо внутрь стандартного INLINE-вызова, учитывайте порядок обработки тегов, используйте отложенную запись pdoTools или отдельный чанк.
HTML-экранирование и кодирование JSON — разные операции. В JSON-LD выше данные передаются через json_encode().
Что дальше
В практическом проекте меню уже подключено. Если вы пришли из поиска и пока не настраивали навигацию, посмотрите примеры pdoMenu.
Дальше можно переходить к сборке раздела блога: шаблону списка публикаций, странице статьи и боковой колонке. При настройке крошек учитывайте выбранную структуру, статьи могут находиться непосредственно в блоге или внутри рубрик.











