Ресурсы

Ресурс является представлением страницы в MODx. Существуют различные типы ресурсов, такие как документы, web-ссылки, символические ссылки, сами файлы и т.д. Тип ресурса по умолчанию - документ, и представляет собой веб-страницу на вашем сайте.

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

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

Ресурсы приведены в дереве ресурсов в левой навигационной панели панели администратора. Чтобы отредактировать один из них, просто кликните по ресурсу, который вы хотели бы изменить. Вы можете альтернативно щелкните правой кнопкой мыши ресурс и нажмите кнопку "Редактировать ресурс". Это позволит загрузить страницу ресурса, где его можно изменить:

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

Поля ресурса

Ресурсы идут в комплекте со списком заранее определенных полей по умолчанию. К ним относятся:

Имя

Описание

id

Идентификатор ресурса.

template

Шаблон, который используется при формировании ресурса.

published

Если ресурс опубликован, он будет виден в фронт-энде сайта.

pagetitle

Заголовок ресурса.

longtitle

A longer title of the Resource.

description

Описание ресурса.

introtext

Аннотация ресурса, используется для поиска или блоггинга.

alias

URL алиас используется для организации ЧПУ. Например, алиас ресурса 'home' и тип ресурса 'html' - это будет интерпретировано как 'home.html', если он не является контейнером.

parent

ID родителя ресурса.

link_attributes

Используется со сниппетами, чтобы добавлять атрибуты к ссылкам и т.д. Может быть многократно использовано для других нужд.

menutitle

Заголовок ресурса, которое будет отображено в меню.

menuindex

Индекс - порядок ресурса в меню.

hidemenu

Также называется "Скрыть из меню ', если установлено, на сайте не будет показываться в большинстве меню или навигационных сниппетов.

content

Актуальный контент ресурса.

Служебные поля ресурса

Имя

Описание

isfolder

Маркированный как "контейнер", это указывает будет или нет / в ЧПУ вместо суффикса.

searchable

Если ресурс для поиска.

cacheable

Если ресурс кэшируемый.

createdby

Идентификатор пользователя, создавшего ресурс.

editedby

Идентификатор последнего пользователя редактировавшего ресурс.

deleted

Если ресурс удален или нет.

deletedby

Идентификатор пользователя, который удалил ресурс.

publishedby

Идентификатор пользователя, который в прошлом опубликовал ресурс.

createdon

Дата, когда ресурс был создан.

publishedon

Дата, когда ресурс был опубликован.

editedon

Дата, последнего изменения ресурса.

pub_date

Дата публикации ресурса.

unpub_date

Дата снятия с публикации.

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

Поля ресурса могут быть доступны из любого места, используя синтаксис TV-параметра:

[ [*pagetitle] ] // заголовок страниц.
[ [*id] ] // идентификатор ресурса
[ [*createdby] ] // ID пользователя, создавшего ресурс

К ним также могут применены фильтры ввода:

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

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

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

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

В MODx ссылками на ресурсы динамически можно управлять через “Ресурс Тэг”. Они выглядят так:

[ [~123] ]

,где '123' является идентификатором ресурса. Вы можете поместить эти теги в любом месте, и MODx будет динамически вставлять URL для ресурса.

Передача URL параметров

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

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

Это эквивалентно данной конструкции:

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

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

URL схемы в ресурс тегах

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

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

Указать URL с помощью 'HTTPS' вместо схемы, указанном текущих настройках (т.е. системы или настройках контекста).

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

Имя

Описание

-1

(по умолчанию) URL относительно site_url

0

увидеть http

1

увидеть https

full

Открывает ссылку как абсолютный URL, приписав перед site_url

abs

Открывает ссылку как абсолютный URL, приписав перед base_url

http

Открывает ссылку как абсолютный URL, используя http scheme

https

Открывает ссылку как абсолютный URL, используя https scheme