Хлебные крошки в MODX через pdoCrumbs

Хлебные крошки MODX из дерева ресурсов через pdoCrumbs MODX Revo
pdoCrumbs строит хлебные крошки MODX по родительским ресурсам. Через параметры можно добавить главную, убрать текущую страницу, ограничить цепочку и настроить HTML. Для поисковой разметки используется BreadcrumbList, а оформление адаптируется под Bootstrap 5 или разметку вашего шаблона.
Содержание
  1. Быстрый старт: выводим хлебные крошки MODX
  2. Откуда берется цепочка навигации
  3. Документация по pdoCrumbs
  4. Параметры
  5. Полезные общие параметры pdoTools
  6. Шаблоны по умолчанию
  7. Плейсхолдеры
  8. Флаги pdoTools 3.1+
  9. Типовые примеры pdoCrumbs
  10. Минимальный вызов
  11. Ограничение количества пунктов
  12. Не показываем текущую страницу
  13. Исключаем ресурс
  14. Строим цепочку для другой страницы
  15. Вызов внутри pdoResources
  16. Хлебные крошки Bootstrap 5
  17. Практика FlexStart: заменяем статические крошки
  18. Заменяем nav.breadcrumbs
  19. Если крошки нужны в нескольких шаблонах
  20. Вставка вызова через интерфейс
  21. Как убрать хлебные крошки с главной
  22. Скрываем только навигацию
  23. Скрываем всю заголовочную область
  24. Почему не нужно разрывать обертку между шаблонами
  25. Микроразметка BreadcrumbList
  26. Microdata на стандартных тегах MODX
  27. Microdata на Fenom для FlexStart
  28. BreadcrumbList в формате JSON-LD
  29. Создаем сниппет breadSchema
  30. Подключаем вывод
  31. Проверяем хлебные крошки и микроразметку
  32. Частые ошибки pdoCrumbs
  33. О названиях и экранировании
  34. Что дальше

Для начала установите 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">&nbsp;...&nbsp;</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>`
]]
Вариант на Fenom

{'!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'}

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

Вставка вызова через интерфейс

В некоторых версиях редактора можно перетащить сниппет из дерева элементов и заполнить параметры в открывшемся окне:

Опции pdoCrumbs в прежнем интерфейсе MODX

Скриншот показывает прежний интерфейс. Если ваш редактор не поддерживает перетаскивание, вставьте вызов вручную.

Как убрать хлебные крошки с главной

Скрываем только навигацию

Если весь 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, а не прописываются вручную.

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. В таком случае используйте один источник цепочки внутри существующего решения.

Проверяем хлебные крошки и микроразметку

  1. Откройте страницу первого уровня и вложенную страницу.
  2. Проверьте порядок разделов и переход по каждой ссылке.
  3. Убедитесь, что текущая страница выведена так, как задумано.
  4. Откройте главную и проверьте отсутствие лишней навигационной обертки.
  5. Посмотрите исходный HTML, в нем не должно быть необработанных плейсхолдеров.
  6. Для JSON-LD проверьте страницу с кавычками в названии.
  7. Проверьте разметку валидаторами.

Для 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.

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

pdomenu
← Предыдущая статьяМеню в MODX через pdoMenu: параметры и примеры
Следующая статья →Блог на MODX: способы создания и выбор дополнений
Способы создания блога на MODX и выбор дополнений
Поделиться с друзьями
Алексей

Веб-дизайнер и SEO оптимизатор. Занимаюсь созданием сайтов с 2010 года и их продвижение с 2012 года!

Оцените автора
( 18 оценок, среднее 4.33 из 5 )
Web-Revenue.ru