Сниппет в MODX это короткий фрагмент PHP-кода, который возвращает значение и вызывается в шаблоне тегом [[имяСниппета]]. Через сниппеты на MODX строят всё динамическое: меню, списки статей, хлебные крошки, карту сайта, формы. Для SEO это главный инструмент, потому что готового модуля «SEO» в ядре нет. Заголовок и описание страницы выводят тегами полей ресурса ([[*pagetitle]], [[*description]]), понятные адреса включают системными настройками friendly_urls и use_alias_path, а sitemap.xml собирают сниппетом pdoSitemap или GoogleSiteMap.
Не путайте термин с сниппетом в поисковой выдаче: там это блок с заголовком и описанием под ссылкой, а здесь кусок кода. Ниже разбор по документации MODX 3.x (это текущая ветка MODX Revolution) на 15.11.2026.
Что такое сниппет и чем он отличается от чанка
Документация 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-тегов это обычно не нужно: заголовок и описание страницы одинаковы для всех посетителей, кешированный вызов быстрее. Без кеша вызывайте только то, что меняется от запроса к запросу: корзину, результаты поиска, формы.
Как написать свой сниппет
Пример задачи: у части страниц пустое поле «Описание», и мета-тег 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.
Как включить понятные адреса
По шагам из руководства MODX:
- Веб-сервер. На Apache переименуйте файл
ht.accessиз дистрибутива в.htaccess. Для nginx, IIS и lighttpd в документации есть отдельные конфигурации. - Настройки. Раздел System Settings (значок шестерёнки в верхнем меню менеджера), фильтр по ключу
friendly:friendly_urls= «Да»,use_alias_path= «Да», чтобы адрес строился с учётом родительских разделов (/blog/statya/). Без второй настройки все страницы ведут себя так, будто лежат в корне. - Транслитерация. По умолчанию
friendly_alias_translit=none, и кириллица в псевдониме может пропасть. Установите пакет Translit и укажите таблицуrussian. Настройкаautomatic_aliasпо умолчанию включена: псевдоним строится из заголовка при сохранении, если поле пустое. - base href. В
<head>каждого HTML-шаблона:<base href="[[!++site_url]]" />. Без него на вложенных адресах ломаются относительные пути к CSS и картинкам. - Кеш. Очистите кеш сайта. Уже созданные страницы сохраняют свои псевдонимы, пока вы их не отредактируете.
Ещё две настройки стоит знать. container_suffix (по умолчанию /) задаёт окончание адресов разделов. friendly_urls_strict на странице настройки описана так: неканонические запросы, совпавшие с ресурсом, получают 301 на канонический адрес. Это защищает от дублей вида /blog/statya и /blog/statya/. Какой должна быть сама структура адреса, разобрано в статье про ЧПУ.
После включения выберите один вариант хоста (с www или без) и протокол. В ht.access есть закомментированные примеры правил склейки, а для nginx документация советует return 301. Как их правильно настраивать, в статье про редиректы.
Схема: где в обработке запроса включаются ЧПУ, теги полей, сниппеты и страница ошибки.
Мета-теги и 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
Задачи и инструменты:
| Что | Когда подходит | Чем платите | Почему важно |
|---|---|---|---|
| pdoSitemap (пакет pdoTools) | Почти всегда: понимает параметры GoogleSiteMap и работает быстрее | Нужен пакет pdoTools; права пользователей по умолчанию не проверяет | На сайте из 1 700 страниц генерация ускорилась в 12 раз, с 8,4 до 0,7 секунды (пример из документации) |
| GoogleSiteMap | Сайт уже на нём, менять нет причин | Отдельный пакет; часть старых возможностей переписанная версия не поддерживает | Переписан в 2016 году под десятки тысяч ресурсов |
| Ресурс robots.txt | Нужно править правила из менеджера без доступа к файлам | Нужен тип содержимого text/plain с расширением .txt | MODX отдаёт верный заголовок 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) | 2 | 142 | 50,9% |
| WordPress (Yoast, Rank Math, общий запрос) | 4 | 120 | 43,0% |
| MODX (сниппеты) | 1 | 15 | 5,4% |
| 1С-Битрикс (общий запрос) | 1 | 2 | 0,7% |
| Всего | 8 | 279 | 100% |
Что видно:
- Про MODX спрашивают как разработчики. Единственная тема о движке в ядре сформулирована через сниппеты, а не через SEO. Широкая частотность 133, точная 15: дословная фраза занимает 11,3%, остальное это уточнения про конкретные сниппеты и примеры кода. Поэтому статья начинается с синтаксиса, а SEO-настройки идут вторыми.
- Сниппеты MODX ищут в 7,5 раза чаще, чем «SEO для Битрикса» (15 против 2), хотя обе цифры маленькие. Общие запросы «SEO на движке X» почти не вводят дословно: люди ищут решение конкретной задачи.
- Это справочная статья для перелинковки. Выбор платформы разобран в статье на каком движке делать сайт, соседние инструкции: SEO для WordPress и SEO на 1С-Битрикс.
Кому это не нужно
- Вы на 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]].
Источники
- Документация MODX: сниппеты, вызов и наборы параметров
- Документация MODX: как писать сниппеты
- Документация MODX: синтаксис тегов и кеширование
- Документация MODX: поля ресурса и частые теги шаблона
- Документация MODX: включение понятных адресов
- Документация MODX: транслитерация псевдонимов
- Документация MODX: настройка friendly_urls_strict
- Документация MODX: сниппет pdoSitemap
- Документация MODX: типы содержимого ресурсов
- Исходный код MODX 3.x: класс modX на GitHub
- Google Search Central: создание файла Sitemap