Ресурсы в MODX: что это и как устроен сайт

Что вы увидите в конце

За 10–15 минут вы разберётесь, как ресурс превращается в страницу в MODX Revolution, где найти его адрес и шаблон и почему одна запись может быть видна в админке, но не открываться на сайте. Речь о базовых понятиях, общих для MODX Revolution 2.x и 3.x; расположение отдельных элементов интерфейса может отличаться в зависимости от версии и оформления панели.

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

Ресурс — основа страницы в MODX

В дереве слева ресурс выглядит как страница или папка. Внутри MODX это объект с набором полей: названием, содержимым, адресом, родителем, шаблоном и параметрами публикации. При запросе сайта MODX находит подходящий ресурс и использует его настройки, чтобы сформировать ответ.

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

Если страница ведёт себя не так, как вы ожидали, сначала проверьте её адрес, родителя, шаблон и публикацию. Изменение текста — только одна часть настройки ресурса.

Поля, которые важно различать

Название и заголовок в браузере

Название помогает найти ресурс в дереве менеджера. Оно может также использоваться в навигации или шаблоне, но само по себе не гарантирует, что именно этот текст появится на странице. Заголовок страницы и содержимое задаются отдельно — в полях ресурса, дополнительных полях или шаблоне сайта.

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

Содержимое

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

Родитель и дерево

Родитель показывает, где ресурс находится в структуре сайта. Например, страница товара может быть дочерней для раздела каталога. Дерево помогает организовать материалы и может участвовать в формировании адреса, если в настройках сайта используется иерархическая схема URL.

Перемещение ресурса в дереве — не только косметическая операция. В зависимости от настройки адресов его URL может измениться. Перед переносом проверьте ссылки на страницу и предусмотренные на сайте перенаправления.

Шаблон

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

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

Псевдоним и адрес

Псевдоним — часть человекочитаемого адреса ресурса. Итоговый URL зависит также от родителя и настроек сайта. Поэтому после изменения псевдонима проверьте адрес страницы на сайте, а не только значение в форме менеджера.

URI¹ — адресный путь, по которому система находит ресурс. У двух записей может быть похожее содержимое, но разные URI; если адреса конфликтуют или ожидания о вложенности не совпадают с настройками сайта, результатом может стать не та страница или ошибка.

Публикация и доступность

У ресурса есть состояние публикации и связанные с доступностью параметры. Снятая с публикации запись обычно не показывается посетителям как обычная опубликованная страница, хотя редактор может видеть её в менеджере. Также проверьте даты публикации и снятия с публикации, если они заданы: страница может стать доступной не сразу.

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

1. Найдите запись в дереве. Уточните контекст сайта и родителя ресурса. Проверка: вы открыли именно нужную запись, а не соседнюю с похожим названием.
2. Сверьте адресные поля. Посмотрите псевдоним и итоговый путь с учётом родителя и настроек сайта. Проверка: адрес, который вы ожидаете увидеть в браузере, соответствует фактической структуре.
3. Проверьте публикацию. Убедитесь, что ресурс опубликован и не ограничен датами или настройками доступа. Проверка: статус и даты не объясняют, почему посетитель не видит страницу.
4. Посмотрите шаблон и содержимое. Выясните, где хранится текст и какой шаблон отвечает за вывод. Проверка: вы понимаете, какое поле нужно менять и почему именно этот шаблон должен показать страницу.
5. Откройте URL в браузере. Проверяйте страницу как обычный посетитель, а не только через менеджер. Проверка: загружается нужный адрес и на нём отображается ожидаемый ресурс.

Почему ресурс есть в менеджере, а страницы нет

Чаще всего причина находится не в самом тексте. Идите от простого к сложному: проверьте публикацию и даты, затем адрес и родителя, после — настройки доступа и шаблон. Если ресурс опубликован, но URL показывает другую страницу или ошибку, понадобятся сведения о конфигурации сайта и версия MODX: без них нельзя надёжно определить причину.

• В менеджере запись видна, на сайте — нет. Проверьте публикацию, даты доступности и ограничения доступа.
• Открывается не та страница. Сверьте адрес ресурса и его родителей; проверьте, не совпадает ли ожидаемый путь с другим адресом сайта.
• Страница открывается без привычного оформления. Проверьте назначенный шаблон и связанные с ним элементы. Не заменяйте шаблон до выяснения, что именно использует страница.
• После редактирования текст не изменился. Убедитесь, что меняли поле, которое выводит шаблон, и что сохранение прошло успешно.

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

Где начинающие чаще всего ошибаются

Первая ошибка — считать название ресурса заголовком страницы. Вторая — менять псевдоним, не проверив последствия для URL и внешних ссылок. Третья — назначать шаблон по названию, не зная, какие поля и блоки он выводит. Наконец, дерево воспринимают как папки на диске, хотя это структура ресурсов внутри MODX, а не буквальное расположение HTML-файлов.

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

Что делать дальше

Возьмите одну тестовую или уже опубликованную страницу и запишите её родителя, псевдоним, шаблон, состояние публикации и фактический URL. Затем проследите, какое поле даёт заголовок и откуда берётся основной контент. Такой разбор быстрее объяснит устройство именно вашего сайта, чем попытка угадать назначение полей по их названиям.

Следующий шаг — изучить шаблон и связанные с ним чанки или дополнительные поля. Это отдельная тема: здесь мы разобрали только ресурс как запись, которая связывает содержание страницы с её адресом и оформлением.

¹ URI — путь к ресурсу внутри адреса сайта; его вид зависит от структуры сайта и настроек MODX.