MoreSEOОб авторе

MODX сниппеты и SEO: ЧПУ, мета-теги и карта сайта

Как устроены сниппеты и теги в MODX 3.x, как включить понятные адреса, вывести title и description, собрать sitemap.xml и настроить страницу 404.

Обновлено 15 ноября 2026
9 мин. чтения
Обложка: сборка страницы из блоковОкно браузера, в которое крупные квадратные скобки вставляют цветные блоки страницы, рядом шестерёнка настроек

Сниппет в MODX это короткий фрагмент PHP-кода, который возвращает значение и вызывается в шаблоне тегом [[имяСниппета]]. Через сниппеты на MODX строят всё динамическое: меню, списки статей, хлебные крошки, карту сайта, формы. Для SEO это главный инструмент, потому что готового модуля «SEO» в ядре нет. Заголовок и описание страницы выводят тегами полей ресурса ([[*pagetitle]], [[*description]]), понятные адреса включают системными настройками friendly_urls и use_alias_path, а sitemap.xml собирают сниппетом pdoSitemap или GoogleSiteMap.

Не путайте термин с сниппетом в поисковой выдаче: там это блок с заголовком и описанием под ссылкой, а здесь кусок кода. Ниже разбор по документации MODX 3.x (это текущая ветка MODX Revolution) на 15.11.2026.

**Коротко** - Вызов `[[mySnippet]]` кешируется, `[[!mySnippet]]` выполняется при каждом запросе; кеш задаёт тег, а не настройка. - Параметры передают так: ``[[!mySnippet? &input=`текст`]]``, значения только в обратных кавычках, имена чувствительны к регистру. - Понятные адреса включают двумя настройками, `friendly_urls` и `use_alias_path` (обе по умолчанию «Нет»), плюс правила веб-сервера и тег ``. - Для русских заголовков нужна транслитерация: `friendly_alias_translit` по умолчанию `none`, таблицу `russian` даёт пакет Translit. - Настройка `error_page` по умолчанию равна 1, то есть указывает на ресурс с ID 1, обычно главную; для SEO заведите отдельную страницу 404.

Что такое сниппет и чем он отличается от чанка

Сниппет выполняет PHP и возвращает результат, чанк хранит готовый HTML с плейсхолдерами. Обычно они работают в паре: сниппет получает данные, а чанк задаёт, как их показать. В шаблоне каждый элемент вызывается своим тегом с отдельным символом.

Документация MODX описывает теги так:

ТегЧто выводитПримерГде пригодится для SEO
[[*поле]]Поле текущего ресурса или TV[[*pagetitle]], [[*description]]title, description, H1
[[$чанк]]Готовый фрагмент HTML[[$header]]Общая шапка с мета-тегами для всех шаблонов
[[сниппет]]Результат PHP-кода[[pdoMenu]]Меню, крошки, sitemap, списки
[[+плейсхолдер]]Значение, которое задал сниппет[[+pagetitle]] внутри чанкаШаблоны элементов списков и карты сайта
[[~id]]Адрес ресурса по ID[[~1? &scheme=`full`]]Внутренние ссылки и canonical, которые не ломаются при смене адреса
[[++настройка]]Системная настройка[[++site_name]]Название сайта в title, адрес сайта в base href
[[- комментарий]]Ничего, тег не обрабатывается[[- TODO]]Заметки в шаблоне, которые не попадут в HTML

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

Как написать свой сниппет

Создайте сниппет в разделе элементов менеджера, напишите PHP-код, который возвращает строку через return, и вставьте вызов в шаблон. Параметры из вызова приходят в код переменными с тем же именем и общим массивом $scriptProperties.

Пример задачи: у части страниц пустое поле «Описание», и мета-тег description выходит пустым. Сниппет metaDescription берёт описание, а если его нет, обрезает вводный текст:

<?php
// Сниппет metaDescription: описание страницы с запасным вариантом
$limit = isset($limit) ? (int) $limit : 155;
$text  = $modx->resource->get('description');
if (empty($text)) {
    $text = strip_tags($modx->resource->get('introtext'));
}
$text = trim(preg_replace('/\s+/u', ' ', $text));
if (mb_strlen($text) > $limit) {
    $text = rtrim(mb_substr($text, 0, $limit - 1)) . '…';
}
return htmlspecialchars($text, ENT_QUOTES, 'UTF-8');

Вызов в шаблоне: <meta name="description" content="[[metaDescription? &limit=`155`]]">.

Правила из документации MODX, на которых чаще всего ошибаются:

  • Возвращайте, а не печатайте. echo тоже сработает, MODX перехватит вывод, но соглашение именно return.
  • Не смешивайте HTML и PHP в сниппете. MODX сам добавляет <?php в начало кода, поэтому HTML до него даст синтаксическую ошибку. Разметку выносите в чанк и вызывайте через $modx->getChunk().
  • Обратные кавычки и регистр. &input=`значение`, а не 'значение'; input и INPUT это разные параметры.
  • Работа с базой через xPDO. Методы getObject() и getCollection() вместо сырых SQL-запросов: значения экранируются через PDO.

Как включить понятные адреса

Настройте правила веб-сервера, которые отправляют неизвестные пути в index.php, затем включите в системных настройках friendly_urls и use_alias_path, добавьте base href в шаблоны и очистите кеш. До настройки сервера красивые адреса будут отдавать 404.

По шагам из руководства MODX:

  1. Веб-сервер. На Apache переименуйте файл ht.access из дистрибутива в .htaccess. Для nginx, IIS и lighttpd в документации есть отдельные конфигурации.
  2. Настройки. Раздел System Settings (значок шестерёнки в верхнем меню менеджера), фильтр по ключу friendly: friendly_urls = «Да», use_alias_path = «Да», чтобы адрес строился с учётом родительских разделов (/blog/statya/). Без второй настройки все страницы ведут себя так, будто лежат в корне.
  3. Транслитерация. По умолчанию friendly_alias_translit = none, и кириллица в псевдониме может пропасть. Установите пакет Translit и укажите таблицу russian. Настройка automatic_alias по умолчанию включена: псевдоним строится из заголовка при сохранении, если поле пустое.
  4. base href. В <head> каждого HTML-шаблона: <base href="[[!++site_url]]" />. Без него на вложенных адресах ломаются относительные пути к CSS и картинкам.
  5. Кеш. Очистите кеш сайта. Уже созданные страницы сохраняют свои псевдонимы, пока вы их не отредактируете.

Ещё две настройки стоит знать. container_suffix (по умолчанию /) задаёт окончание адресов разделов. friendly_urls_strict на странице настройки описана так: неканонические запросы, совпавшие с ресурсом, получают 301 на канонический адрес. Это защищает от дублей вида /blog/statya и /blog/statya/. Какой должна быть сама структура адреса, разобрано в статье про ЧПУ.

После включения выберите один вариант хоста (с www или без) и протокол. В ht.access есть закомментированные примеры правил склейки, а для nginx документация советует return 301. Как их правильно настраивать, в статье про редиректы.

Как MODX обрабатывает запрос страницыЗапрос понятного адреса, правило веб-сервера передаёт его в index.php, MODX ищет ресурс по адресу. Найден: шаблон, теги полей и сниппеты, готовая страница с мета-тегами. Не найден: ресурс из настройки error_page с кодом 404. Путь запроса в MODX и где включается SEO Запрос /blog/statya/ Веб-сервер .htaccess → index.php Поиск ресурса friendly_urls, алиас Не найден error_page, код 404 Шаблон теги [[*поле]] Сниппеты меню, крошки, карта Страница 200, title, canonical Кешированные теги считаются один раз, теги с «!» на каждом запросе SEO-теги одинаковы для всех посетителей, поэтому их вызывают с кешем нет да
Как MODX обрабатывает запрос: правило веб-сервера, index.php, поиск ресурса по адресу, шаблон с тегами и сниппетами, готовая страница или страница ошибки с кодом 404

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

Мета-теги и canonical в шаблоне

У каждого ресурса есть поля pagetitle, longtitle, description и introtext. В шаблоне их выводят тегами: title из longtitle с запасным pagetitle, description из поля «Описание» или сниппетом, canonical через тег ссылки с полной схемой.

Минимальный <head>, который закрывает основные SEO-задачи:

<title>[[*longtitle:default=`[[*pagetitle]]`]] | [[++site_name]]</title>
<meta name="description" content="[[metaDescription]]">
<link rel="canonical" href="[[~[[*id]]? &scheme=`full`]]">
<base href="[[!++site_url]]" />

Модификатор :default выводит запасное значение, если поле пустое. Поле longtitle удобно держать под title, а pagetitle под H1 и меню: так заголовок для выдачи и заголовок на странице можно писать по-разному. Как их формулировать, разобрано в статьях про тег title и про мета-теги.

Sitemap, robots.txt и страница 404

Карту сайта и robots.txt в MODX делают обычными ресурсами с пустым шаблоном и нужным типом содержимого: XML для карты, текст для robots.txt. Внутрь карты ставят вызов pdoSitemap или GoogleSiteMap. Для 404 создают отдельную страницу и указывают её ID в настройке error_page.

Задачи и инструменты:

ЧтоКогда подходитЧем платитеПочему важно
pdoSitemap (пакет pdoTools)Почти всегда: понимает параметры GoogleSiteMap и работает быстрееНужен пакет pdoTools; права пользователей по умолчанию не проверяетНа сайте из 1 700 страниц генерация ускорилась в 12 раз, с 8,4 до 0,7 секунды (пример из документации)
GoogleSiteMapСайт уже на нём, менять нет причинОтдельный пакет; часть старых возможностей переписанная версия не поддерживаетПереписан в 2016 году под десятки тысяч ресурсов
Ресурс robots.txtНужно править правила из менеджера без доступа к файламНужен тип содержимого text/plain с расширением .txtMODX отдаёт верный заголовок Content-Type по типу ресурса
Свой сниппетНестандартная логика: несколько контекстов, фильтр по TVПоддерживать код придётся самимПолный контроль над тем, что попадёт в карту

Ресурс для sitemap.xml по инструкции pdoSitemap: создайте документ в корне с пустым шаблоном и псевдонимом sitemap, включите скрытие из меню (Hide From Menus) и публикацию (Published), на вкладке Settings выберите тип содержимого XML, отключите визуальный редактор (Rich Text) и вставьте в содержимое [[pdoSitemap]]. Ссылку на готовую карту добавьте в robots.txt и в Вебмастер.

Одна деталь: pdoSitemap сам ставит priority и changefreq по дате изменения страницы. Google эти поля игнорирует и смотрит только на точный lastmod, так что тратить время на их настройку не нужно. Что важно в карте сайта, подробно в статье про sitemap.xml.

Две ловушки ядра

Мы проверили поведение по исходному коду MODX 3.x на GitHub:

  • Страница ошибки по умолчанию это ресурс 1. Настройка error_page по умолчанию равна 1, а это обычно главная. Код ответа будет правильным: метод sendErrorPage() отправляет 404 Not Found. Но посетитель вместо понятной страницы ошибки видит главную. Создайте отдельный ресурс с поиском и ссылками на разделы и укажите его ID, советы по содержимому в статье об ошибке 404.
  • Перенаправление из сниппета по умолчанию временное. $modx->sendRedirect($url) без опции responseCode отправляет только заголовок Location, а PHP в этом случае ставит 302. Для переезда навсегда передавайте код явно: $modx->sendRedirect($url, ['responseCode' => 'HTTP/1.1 301 Moved Permanently']);. Почему это важно, в статье о временном перенаправлении и PHP.

Наши данные: как ищут SEO на разных движках

Методика. Ядро блога MoreSEO, 477 тем, Яндекс Wordstat, Россия, 30 дней, срез 14.11.2026. Спрос темы равен сумме точных частот запросов группы. В кластере «SEO на CMS» 8 тем и 279 запросов; ниже они сгруппированы по движкам.

ДвижокТемСпрос, точн./месДоля в кластере
Тильда (домен и SSL)214250,9%
WordPress (Yoast, Rank Math, общий запрос)412043,0%
MODX (сниппеты)1155,4%
1С-Битрикс (общий запрос)120,7%
Всего8279100%

Что видно:

  • Про MODX спрашивают как разработчики. Единственная тема о движке в ядре сформулирована через сниппеты, а не через SEO. Широкая частотность 133, точная 15: дословная фраза занимает 11,3%, остальное это уточнения про конкретные сниппеты и примеры кода. Поэтому статья начинается с синтаксиса, а SEO-настройки идут вторыми.
  • Сниппеты MODX ищут в 7,5 раза чаще, чем «SEO для Битрикса» (15 против 2), хотя обе цифры маленькие. Общие запросы «SEO на движке X» почти не вводят дословно: люди ищут решение конкретной задачи.
  • Это справочная статья для перелинковки. Выбор платформы разобран в статье на каком движке делать сайт, соседние инструкции: SEO для WordPress и SEO на 1С-Битрикс.

Кому это не нужно

Разбор пригодится тем, кто сам ведёт сайт на MODX или ставит задачи разработчику. Если сайт ещё не создан, сначала решите, нужен ли вам MODX вообще: он требует знаний HTML и хотя бы чтения PHP.
  • Вы на MODX Cloud или у студии с готовой сборкой. Правила сервера и базовые настройки ЧПУ там обычно уже сделаны, проверьте только транслитерацию и error_page.
  • Нужен сайт без разработчика. Конструктор или WordPress с SEO-плагином закроют те же задачи без написания кода.
  • Сайт на MODX Evolution. Это отдельная ветка со своей документацией, разбор по MODX 3.x к ней напрямую не относится.

Частые вопросы

Что такое сниппет в MODX Revolution?

Это фрагмент PHP-кода, который возвращает значение и вызывается в шаблоне, чанке или содержимом тегом в двойных квадратных скобках, например [[pdoMenu]]. Через сниппеты делают меню, списки, формы и карту сайта.

Чем отличается вызов со знаком «!» и без него?

[[mySnippet]] кешируется и выполняется один раз до сброса кеша. [[!mySnippet]] выполняется при каждом запросе. Без кеша вызывайте только то, что зависит от посетителя: корзину, поиск, формы.

Как передать параметры в сниппет?

После имени ставят знак вопроса и перечисляют параметры через амперсанд, значения в обратных кавычках: [[!mySnippet? &limit=`10`]]. В коде параметр доступен как $limit и в массиве $scriptProperties.

Почему после включения ЧПУ сайт отдаёт 404?

Почти всегда не настроены правила веб-сервера: на Apache не переименован ht.access в .htaccess, на nginx нет правила, которое отправляет неизвестные пути в index.php. Если сломались стили, добавьте в шаблон тег base href.

Как сделать sitemap.xml в MODX?

Создайте ресурс с псевдонимом sitemap, пустым шаблоном и типом содержимого XML и вставьте в него вызов [[pdoSitemap]] из пакета pdoTools или [[!GoogleSiteMap]].

Источники

Частный SEO-специалист. Пишу про поиск и нейропоиск, а цифры беру из Wordstat и первоисточников.

Читайте также

© MoreSEO, Алексей Демкин · все статьи