Содержание
Тип ресурса по умолчанию в MODX — это «Документ» (Document) (phpDocument или modDocument) . При создании новой страницы в дереве ресурсов (при условии, что вы не изменили класс ресурса вручную), MODX автоматически создаёт ресурс типа «Документ», который представляет собой обычную HTML-веб-страницу сайта . Хотя в некоторых технических обсуждениях упоминается абстрактный класс modResource, он не является самостоятельным типом ресурса для конечной страницы — это базовый класс, который наследуют все конкретные типы . Для реального использования выбирается один из четырёх типов, и по умолчанию это именно «Документ» .
Типы ресурсов в MODX
Всего в MODX существует четыре основных типа ресурсов, каждый из которых имеет своё назначение .
| Тип ресурса | Описание | Типичное использование |
|---|---|---|
| Документ (Document) | Стандартная веб-страница с HTML-содержимым. Это тип по умолчанию . | Создание обычных страниц сайта (главная, о компании, услуги, контакты, статьи). |
| Weblink (Ссылка на сайт) | Перенаправляет посетителя на внешний URL. | Создание пунктов меню, которые ведут на внешние ресурсы (например, ссылка на соцсети или партнёра). |
| Symlink (Символическая ссылка) | Отображает содержимое другого ресурса из того же сайта по его ID. | Размещение одного и того же контента в нескольких разделах сайта без дублирования. |
| Static Resource (Статичный ресурс) | Ссылается на файл на сервере (например, PDF, изображение, ZIP-архив). | Предоставление файлов для скачивания через меню сайта. |
Особые случаи: Почему не modResource?
В некоторых ситуациях, особенно при использовании устаревших версий MODX или при определённых сценариях создания ресурсов (например, создание дочернего документа через контекстное меню в дереве ресурсов), в коде мог упоминаться тип modResource . Однако это приводило к ошибкам, так как modResource — это абстрактный (базовый) класс в ядре MODX, а не конечный тип ресурса для отображения на сайте . При попытке сохранить страницу с типом modResource MODX выдаёт ошибку, потому что этот класс должен быть расширен конкретными типами, такими как modDocument (Документ).
Разработчики MODX рекомендуют всегда использовать конкретные типы ресурсов (Document, Weblink, Symlink, Static Resource), чтобы избежать технических проблем . Для управления сайтом через административную панель вы не увидите modResource в выпадающем списке типов — там всегда присутствуют перечисленные выше четыре типа.
Как это влияет на разработку сайта на MODX
Понимание типов ресурсов критически важно при построении архитектуры сайта на MODX .
- Иерархия и навигация: Каждый ресурс имеет уникальный ID, и вы можете строить меню и ссылки, используя эти ID. Это позволяет создавать сложные, многоуровневые структуры сайта.
- Шаблонизация: Разные типы ресурсов могут использовать разные шаблоны. Например, обычные страницы используют один шаблон (со всеми модулями), а страницы-ссылки (Weblink) могут вообще не иметь содержимого, а только перенаправлять.
- Работа с выборками: При получении данных через pdoResources или другие сниппеты, вы можете фильтровать ресурсы по типу, получая только нужные страницы.
В отличие от Joomla, где контент организован через категории и материалы, MODX предлагает более гибкую, но и более техническую модель ресурсов, которая, однако, даёт полный контроль над структурой сайта.
Резюме от эксперта
Для обычного пользователя или веб-мастера, работающего с MODX, ответ однозначен: тип ресурса по умолчанию — это «Документ» (Document). Именно он используется для создания стандартных веб-страниц, наполненных текстом, изображениями и другим контентом . Термин modResource — это техническая деталь для разработчиков, и его появление при создании ресурса — это признак ошибки или использования неподходящего метода создания. При штатной работе с панелью администратора вы всегда будете иметь дело с конкретными типами, где «Документ» является основным и предустановленным.
