Skip to content
  1. Компоненты
  2. pdoTools
  3. Сниппеты
  4. pdoTitle

pdoTitle

Сниппет выводит оформленный тег title на страницу сайта, который состоит из имени страницы, имён родителей этой страницы и, других параметров.

В первую очередь он предназначен для визуального различия документов с постраничной навигацией.

Параметры

Сниппет не принимает никаких общих параметров pdoTools, из-за специфики своей работы. Но передаёт все полученные параметры во вложенный вызов pdoCrumbs.

ПараметрПо умолчаниюОписание
&id0Идентификатор ресурса.
&limit3Лимит выборки родителей ресурса.
&titleFieldlongtitleПоле текущего ресурса для вывода в заголовке страницы.
&cacheКэширование выборки родителей ресурса для заголовка страницы.
&cacheTime0Время актуальности кэша, в секундах.
&tplPages@INLINE ...Шаблон оформления пагинации в заголовке страницы.
&pageVarKeypageИмя переменной для поиска номера страницы в url.
&tplSearch@INLINE ...Шаблон оформления поискового запроса в заголовке страницы.
&queryVarKeyqueryИмя переменной поискового запроса в url.
&minQuery3Минимальная длина поискового запроса для вывода в заголовке страницы.
&outputSeparator/Разделитель элементов в заголовке страницы.
&registerJs1Вставить на страницу javascript с переменными для поддержки &ajaxMode сниппета pdoPage.

Поддержка навигации

pdoTitle определяет, когда на страницу был передан параметр &pageVarKey и выводит в title указание на это.

]

Функция работает и при включенном &ajaxMode сниппета pdoPage, тогда заголовок меняется без перезагрузки страницы.

Поддержка поиска

Если в url был передан параметр &queryVarKey, то сниппет вставит для него чанк &tplSearch в тег.

По умолчанию вставляется плейсхолдер [[+mse2_query]] сниппета mSearch2.

Кэширование

pdoTitle нужно вызывать некэшированным, чтобы он мог реагировать на параметры в url, но вы можете кэшировать внутренний вызов выборки родителей ресурса, который работает через pdoCrumbs.

Экономия выйдет небольшой, потому что для title не нужно выбирать много ресурсов, но такая функция может пригодиться на слабых хостингах.

Javascript переменные

Если включен параметр &registerJs, то сниппет вставит в страницу свои переменные в объекте pdoTitle.

Вы можете найти там разделитель элементов title и шаблон оформления постраничной навигации.

Примеры

Обычный вызов на странице:

modx
<title>[[!pdoTitle]] / [[++site_name]]</title>

Вызов с увеличенной выборкой родителей ресурса и кэшированием:

modx
<title>[[!pdoTitle?limit=`5`&cache=`1`]] / [[++site_name]]</title>