Ресурсы

Что такое ресурс?¶

Ресурс — это представление страницы в MODx. По умолчанию в MODx присутствует 4 типа ресурсов — документы, ссылки, символические ссылки и файлы. Тип ресурса по умолчанию — документ. Он просто представляет веб-страницу на вашем сайте.

Существует 4 типа ресурсов, и они являются документами, Weblinks, Symlinks, и Static Resources.

Каждый ресурс также имеет уникальный идентификатор, или «идентификатор ресурса». Это позволяет MODx знать, какой ресурс выбрать при загрузке веб-страницы. Так же идентификаторы нужны для работы с ресурсами (например выборка по ID). Кроме того, если вы захотите связать ресурсы, то для решения этой задачи можно использовать их идентификаторы. Таким образом, MODx создаст ссылку на ваш ресурс, и вам не придется беспокоиться если изменится псевдоним, тип контента или что-либо еще — MODx применит все изменения самостоятельно.

Управление ресурсами¶

Ресурсы отображаются в дереве ресурсов в левом навигационном меню менеджера. Для редактирования, просто нажмите на страницу, которую вы хотите отредактировать. Вы также можете нажать правой кнопкой мыши на ресурс и выбрать «Редактировать». Это загрузит страницу редактирования ресурса:

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

Поля ресурсов¶

По умолчанию у ресурсов есть список предопределенных полей. Вот они:

Общие поля ресурсов¶

Настройки полей ресурса¶

Использование полей ресурса¶

Данные полей ресурса можно получить используя следующий синтаксис: Переменные шаблона например:

[[*pagetitle]] // Отображает заголовок ресурса.
[[*id]] // Отображает идентификатор ресурса.
[[*createdby]] //Отображает идентификатор пользователя который создал ресурс.

Они также могут иметь Выходные фильтры "Фильтры ввода и вывода (модификаторы вывода)") применяемые к ним:

// Визуализирует ограниченную версию поля introtext.
// Если он длиннее 100 символов, добавляет ...
[[*introtext:ellipsis=`100`]]
// Отображает данные поля introtext, обрезает значение на сотом символе.
[[*editedby:userinfo=`username`]]
// Отображает имя пользователя, который последний раз изменял ресурс
[[*publishedby:userinfo=`email`]]
// Отображает почту пользователя, который опубликовал ресурс

Доступ к полям ресурсов в сниппете¶

Получить значение полей ресурсов в Сниппете довольно легко. MODx предоставляет вам объект Resource, в любом сниппете с помощью ссылки на $modx->resource вы можете получить значение любого поля ресурса. Этот пример сниппета вернет заголовок текущей страницы:

/* Отображает заголовок текущего ресурса */
$output = $modx->resource->get('pagetitle');
return strrev($output);

Ссылка на ресурс¶

В MODX, ссылки на ресурсы динамически управляются через «теги ссылок». Они выглядят так::

[[~123]]

где «123» — это идентификатор ресурса, на который нужно ссылаться. Вы можете разместить эти теги в любом месте, и MODX будет динамически формировать URL для указанного ресурса.

Также см. Именованный Якорь.

Параметры URL для тегов ссылок¶

Добавление параметров URL в тег ссылки довольно просто в Revolution. Допустим, у нас есть идентификатор ресурса 42, который преобразуется в URL-адрес «store/items.html». Мы хотим добавить в тег параметр «tag» со значением «Snacks» и параметром «sort» для «Taste». Вот как вы это сделаете:

[[~42? &tag=`Snacks` &sort=`Taste`]]

Это будет отображаться как:

store/items.html?tag=Snacks&sort=Taste

Обратите внимание, что это обратные пометки вместо апострофов.

Схемы URL в тегах ссылок¶

Вы можете указать схему для ресурса в вашем теге:

[[~123? &scheme=`https`]]

Будет отображать URL с использованием «https» вместо схемы, указанной текущими настройками (то есть настройками системы или контекста).

Доступные схемы:

Смотрите также¶

1. Типы контента
2. Именный Якорь
3. Статический Ресурс
4. Символическая ссылка
   1. Использование ресурсных ссылок
5. Ссылка на сайт