Базовые понятия MODX Revolution. Статичный ресурс modx

Статический ресурс в MODx Revolution

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

Статические ресурсы также могут иметь метки внутри своих областях контента, чтобы определить путь к файлу - так что вы можете задать пользовательские пути установленные в качестве Параметры системы.

Они ведут себя так же, как Документы (вид ресурсов). Содержимое в статическом ресурсе анализируется и отображается точно так же, как документ, но вы будете изменять тип содержания в соответствии с типом файла.

При создании статического ресурса, псевдоним не должен включать в себя расширение файла: расширение файла определяется содержанием Type. Например, если вы создаете статический ресурс, который указывает на PDF файл на веб-сервере, вы можете дать странице псевдоним «test». После того как вы выберите "PDF" в качестве типа содержимого, ".PDF " будет добавлено к псевдониму (предполагается, что вы определили тип содержимого PDF с помощью ".PDF" в качестве расширения файла).

Если вы создали настраиваемый тип контента для PDF, то вы не должны устанавливать в поле контента "attachment". Его можно оставить как пустым, так как современные браузеры могут по-своему отображать PDF-файлы – например, Chrome будет отображать PDF в браузере, в то время как другие будут скачивать файл.

Чтобы гарантировать, что ваш файл передается правильно, вы должны использовать пустой шаблон. Статический ресурс становится ссылкой на файл, пока вы используете этот шаблон. Если вам нужно добавить метаинформацию к ресурсу через некоторые переменные шаблона, вам необходимо создать свой собственный "пустой" шаблон и вы должны установить тег содержимого в шаблоне - [ [*content] ].

artemblog.ru

MODX - Ресурсы | ИТ Шеф

Статья, в которой рассмотрим понятие и роль такого объекта MODX Revolution как ресурс. Кроме этого познакомимся с тем, как осуществляется работа с ресурсами в MODX, разберём назначение полей ресурса, а также то, как связанный с ресурсом шаблон влияет на его вывод.

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

Ресурс - это некоторая сущность, которая представляет страницу в MODX.

Всего в MODX насчитывается 4 различных типа ресурсов: документы (documents), ссылки (weblinks), символические ссылки (symlinks) и статические ресурсы (Static Resources). По умолчанию ресурс имеет тип "Документ".

Ресурс "Документ (document)"

Документ - это тип ресурса MODX, который представляет собой веб-страницу на сайте.

Ресурс "Символическая ссылка (symlink)"

Символическая ссылка в MODX Revolution - это ресурс, с помощью которого можно отобразить контент другого ресурса сайта под определённым URL.

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

Символическую ссылку обычно используют:

как вид редиректа 301;
для того, чтобы избежать дублирования контента. Т.е. ресурс (контент), имеющий тип "Документ", можно создать один раз, а затем при необходимости использовать символическую ссылку на него. Это может применяться, когда необходимо обеспечить чтобы один и тот же контент находился фактически и логически более чем в одном месте на сайте;

когда необходимо оставить доступ к документу, который был перемещён в структуре сайта, по старой ссылке;
для обеспечения простого и краткого URL-адреса для документа, который находится глубоко в структуре сайта;
для того чтобы реализовать обращение к некоторому ресурсу (контенту), используя различные написания. Например: foursquare, 4square, forsquare и т.п. Каждый из этих ресурсов будет представлять собой символическую ссылку, указывающую на один и тот же контент.

Кроме этого, символическим ссылкам, как и другим ресурсам MODX можно настраивать разрешения. Это достигается посредством помещения символических ссылок, в необходимые группы ресурсов.

При работе с символическими ссылками убедитесь в том, что ресурс, с которого она берёт контент, существует и опубликован. Если это не так, то при обращении к ресурсу (символической ссылки) будет создана ошибка.

Ресурс "Ссылка (Weblink)"

Weblink - это ресурс, представляющий собой ссылку. Шаблон для отображения или форматирования этого ресурса (ссылки) обычно не используется. Его применение может быть обусловлено только в том случае, если он будет использоваться как контейнер для переменных шаблона (TV-параметров), которые необходимо добавить к ссылке. Weblink можно использовать на сайте, например, в качестве ссылки, которая должна стать частью сгенерированного меню.

Контент веб-ссылки представляет собой URL-адрес. MODX при открытии такого ресурса просто перенаправляет пользователя на указанный адрес URL. Даже парсер такой тип ресурса не разбирает. Т.е. как только MODX видит, что это "ссылка", он просто использует контент этого ресурса в качестве аргумента метода sendRedirect($url).

В качестве ссылки можно использовать как внешний URL-адрес, так и id существующего ресурса сайта.

Статический ресурс (Static Resource)

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

В поле контента статического ресурса для указания пути к файлу можно использовать теги (параметры системы). Кроме системных тегов в поле контента можно также использовать сниппеты. Это в основном используется только тогда, когда необходимо установить динамический путь к файлу.

Статические ресурсы в MODX Revolution ведут себя подобно документу (стандартному ресурсу). Но для представления файла в статическом ресурсе, ему обязательно необходимо установить соответствующее содержимое (content_type), а также способ того, как браузер должен обработать этот ресурс (content_dispo). Для того чтобы ресурс отображался в браузере, выберите в качестве значения поля "Местонахождение ресурса" вариант "Встроенный". Для того чтобы ресурс стал доступен для скачивания выберите параметр "Прикреплённый".

Обратите внимание на то, что при создании статического ресурса, псевдоним alias не должен содержать расширение файла. Расширение файла определяется типом контента ресурса.

Для того чтобы файл передавался правильно через статический ресурс, ему необходимо в качестве шаблона указывать пустой шаблон. Если к статическому ресурсу необходимо добавить некоторую дополнительную информацию через переменные шаблона (TV-параметры). То в этом случае необходимо создать новый "пустой" шаблон и установить в качестве его содержания следующее:

[[*content]]

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

Каждый ресурс в MODX имеет уникальный идентификатор (id). Он позволяет системе MODX определить, какой ресурс необходимо выбрать, когда пользователь загружает в браузере ту или иную веб-страницу. Его также желательно использовать, когда необходимо организовать связь между ресурсами. В этом случае MODX будет генерировать ссылку автоматически, и её не придётся редактировать при изменении псевдонима (alias), типа контента или какого-нибудь другого поля ресурса.

Рассмотрим небольшой пример, а именно то, как MODX определяет какой ресурс необходимо отдать пользователю при открытии им некоторой страницы на сайте (www.mysite.ru).

Если на сайте не используются дружественные URL, то ресурс, который необходимо отобразить пользователю указывается посредством идентификатора в get параметре id страницы "index.php".

Например, отобразить в браузере страницу (ресурс) сайта, имеющий идентификатор 16:

http://www.mysite.ru/index.php?id=16

Если же на сайте включены и настроены дружественные URL, то обращение к ресурсу уже будет осуществляться с использованием псевдонима. Например, отобразить ресурс с идентификатором 16, имеющий псевдоним some-page и тип содержимого "html" (суффикс, равен .html):

http://www.mysite.ru/some-page.html

Здесь some-page - это alias ресурса, а .html - это тип содержимого (контента) данного ресурса.

Кроме этого, MODX разрешает использовать вложенные URL. Например, ресурс с псевдонимом "child", который расположен внутри ресурса-контейнера с псевдонимом "parent", будет иметь адрес:

http://www.mysite.ru/parent/child.html

Работа с ресурсами в MODX

Ресурсы в админке (менеджере) MODX отображаются в левой панели на вкладке "Ресурсы". Представляются они пользователю в виде дерева.

Создание ресурса

Создание ресурса в MODX осуществляется с помощью кнопок расположенных на соответствующей панели в левой части админки.

После этого на экране появится страница ресурса, состоящая из вкладок и панели "Содержимое ресурса". Все эти элементы содержат поля ресурса.

После заполнения необходимых полей и нажатия на кнопку "Сохранить", они заносятся в базу данных, а ресурсу присваивается некоторый идентификатор (порядковый номер ресурса).

Редактирование ресурса

Отредактировать ресурс в админке MODX можно несколькими способами:

с помощью нажатия левой кнопкой мыши на необходимый ресурс в дереве;
посредством поднесения курсора к определённому ресурсу и выбором из контекстного меню пункта "Редактировать". Вызывается контекстное меню с помощью правой кнопки мыши.

После редактирования ресурса, его необходимо сохранить. Для этого необходимо нажать на кнопку, расположенную вверху экрана и имеющее соответствующее название.

Удаление ресурса

Для удаления ресурса в MODX Revolution к нему необходимо поднести курсор и в контекстном меню выбрать пункт "Удалить". Кроме этого удалить ресурс можно также в режиме редактирования с помощью кнопки "Удалить". После удаления, ресурс на самом деле не удаляется. Ему просто устанавливается включенным состояние параметра deleted, т.е. ресурс как бы помечается на удаление. Для того чтобы окончательно стереть ресурс или ресурсы, помеченные на удаление, необходимо на вкладке "Ресурсы" нажать на значок мусорного ведра.

Поля ресурса

Все ресурсы имеют следующие предопределенные поля:

1. Базовые поля ресурса MODX.

Имя Описание

id	Идентификатор (порядковый номер) ресурса.
template	Ссылка на шаблон, который будет использоваться для отображения этого ресурса.
published	Включает публикацию ресурса во front-end.
pagetitle	Заголовок (название) ресурса.
longtitle	Расширенный заголовок ресурса.
description	Описание ресурса.
introtext	Краткая информация о содержимом ресурса. Может использоваться для его представления на главной странице или в некотором разделе.
alias	URL-псевдоним по которому можно обратиться к этому ресурсу. Предназначен для сайтов, которые используют дружественные URL. Например, ресурс с псевдонимом "home" и типом контента "html" будет иметь URL "home.html" (если конечно же он не контейнер).
parent	идентификатор (id) родительского ресурса.
link_attributes	Предназначен для указания атрибутов, которые необходимо добавить к ссылке. Обычно используется сниппетом, генерирующим меню.
menutitle	Заголовок, который может использоваться сниппетами для представления ресурса в меню.
menuindex	Порядковый номер индекса ресурса в меню. Более высокие значения индекса указывают на то, что ссылку на ресурс необходимо расположить ниже.
hidemenu	Убирает ресурс из выборки при формировании меню. Обычно используется сниппетами, генерирующими меню.
content	Контент ресурса.

2. Поля, осуществляющие настройку ресурса.

Имя Описание

isfolder	Указывает, является ли ресурс "Контейнером". Если это так, то ресурс будет вместо суффикса иметь слеш (/). Это касается только тех сайтов, которые используют дружественные URL.
searchable	Определяет, необходимо ли ресурс включать в результаты поиска.
cacheable	Определяет, необходимо ли ресурс кешировать.
createdby	Содержит идентификатор (id) пользователя, который создал ресурс.
editedby	Содержит идентификатор (id) пользователя, который последним редактировал этот ресурс.
deleted	Определяет, отмечен ли ресурс на удаление или нет.
deletedby	Содержит идентификатор (id) пользователя, который отметил ресурс на удаление.
publishedby	Содержит идентификатор (id) пользователя, который опубликовал ресурс.
createdon	Содержит дату создания ресурса пользователем.
publishedon	Содержит дату публикации ресурса.
editedon	Содержит дату последнего редактирования документа.
pub_date	Содержит дату, начиная с которой ресурс будет опубликован.
unpub_date	Содержит дату, начиная с которой ресурс будет снят с публикации.

Где хранятся ресурсы

Ресурсы, как и другие объекты MODX хранятся в базе данных.

1. Обзор таблицы (site_content), содержащей ресурсы, в phpmyadmin.

2. Структура таблицы (site_content), содержащей ресурсы.

Ресурс и связанный с ним шаблон

Каждому ресурсу в MODX Revolution должен быть обязательно назначен имеющийся или пустой шаблон. Определиться, нужен ли ресурсу шаблон или нет можно следующим образом. Шаблон имеет смысл создавать, если его необходимо связать с несколькими ресурсами или использовать TV-переменные. В этом случае страница будет выводиться, используя связанный с ней шаблон. Контент ресурса в этом шаблоне будет представляться с помощью тега MODX [[*content]].

Если страница не имеет связанного с ней шаблона (выбран пустой шаблон), то она будет отображаться на основании поля "Содержимое ресурса".

itchief.ru

Создание сайтов | MODx

MODX - Ресурсы

Статья, в которой описывается понятие и роль такого объекта MODX Revolution как ресурс. Кроме этого разберёмся с тем, как осуществляется работа с ресурсами в MODX, узнаем назначение полей ресурса, а также то, как связанный с ресурсом шаблон влияет на его вывод.

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

Ресурс - это некоторая сущность, которая представляет страницу в MODX.

Ресурс "Документ (document)"

Документ - это тип ресурса MODX, который представляет собой веб-страницу на сайте.

Ресурс "Символическая ссылка (symlink)"

Символическую ссылку обычно используют:

как вид редиректа 301;
для того, чтобы избежать дублирования контента. Т.е. ресурс (контент), имеющий тип "Документ", можно создать один раз, а затем при необходимости использовать символическую ссылку на него. Это может применяться, когда необходимо обеспечить чтобы один и тот же контент находился фактически и логически более чем в одном месте на сайте;
когда необходимо оставить доступ к документу, который был перемещён в структуре сайта, по старой ссылке;
для обеспечения простого и краткого URL-адреса для документа, который находится глубоко в структуре сайта;
для того чтобы реализовать обращение к некоторому ресурсу (контенту), используя различные написания. Например: foursquare, 4square, forsquare и т.п. Каждый из этих ресурсов будет представлять собой символическую ссылку, указывающую на один и тот же контент.

Ресурс "Ссылка (Weblink)"

В качестве ссылки можно использовать как внешний URL-адрес, так и id существующего ресурса сайта.

Статический ресурс (Static Resource)

[[*content]]

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

Например, отобразить в браузере страницу (ресурс) сайта, имеющий идентификатор 19:

http://www.mysite.ru/index.php?id=19

Если же на сайте включены и настроены дружественные URL, то обращение к ресурсу уже будет осуществляться с использованием псевдонима. Например, отобразить ресурс с идентификатором 19, имеющий псевдоним some-page и тип содержимого "html" (суффикс, равен .html):

http://www.mysite.ru/some-page.html

Здесь some-page - это alias ресурса, а .html - это тип содержимого (контента) данного ресурса.

http://www.mysite.ru/parent/child.html

Работа с ресурсами в MODX

Создание ресурса

Жмите Система->Типы содержимого. Вам будет представлена таблицу заполненная текущими видами содержимого. Жмите новый тип содержимого и в новом окошке увидите такие строки:

Жмите сохранить и в перечне будет представлен новый тип содержимого.

В тот момент вы создаете ресурс, то расширение файла, характеризуемое типом содержимого, которое вы избрали, будет прибавляться к псевдониму ресурса (В случае если вы включили дружественный URL)

Редактирование ресурса

Отредактировать ресурс в админке MODX можно несколькими способами:

с помощью нажатия левой кнопкой мыши на необходимый ресурс в дереве;
посредством поднесения курсора к определённому ресурсу и выбором из контекстного меню пункта "Редактировать". Вызывается контекстное меню с помощью правой кнопки мыши.

Удаление ресурса

Поля ресурса

Все ресурсы имеют следующие предопределенные поля:

Базовые поля ресурса MODX.

Имя Описание

id	Идентификатор (порядковый номер) ресурса.
template	Ссылка на шаблон, который будет использоваться для отображения этого ресурса.
published	Включает публикацию ресурса во front-end.
pagetitle	Заголовок (название) ресурса.
longtitle	Расширенный заголовок ресурса.
description	Описание ресурса.
introtext	Краткая информация о содержимом ресурса. Может использоваться для его представления на главной странице или в некотором разделе.
alias	URL-псевдоним по которому можно обратиться к этому ресурсу. Предназначен для сайтов, которые используют дружественные URL. Например, ресурс с псевдонимом "home" и типом контента "html" будет иметь URL "home.html" (если конечно же он не контейнер).
parent	идентификатор (id) родительского ресурса.
link_attributes	Предназначен для указания атрибутов, которые необходимо добавить к ссылке. Обычно используется сниппетом, генерирующим меню.
menutitle	Заголовок, который может использоваться сниппетами для представления ресурса в меню.
menuindex	Порядковый номер индекса ресурса в меню. Более высокие значения индекса указывают на то, что ссылку на ресурс необходимо расположить ниже.
hidemenu	Убирает ресурс из выборки при формировании меню. Обычно используется сниппетами, генерирующими меню.
content	Контент ресурса.

Поля, осуществляющие настройку ресурса.

Имя Описание

isfolder	Указывает, является ли ресурс "Контейнером". Если это так, то ресурс будет вместо суффикса иметь слеш (/). Это касается только тех сайтов, которые используют дружественные URL.
searchable	Определяет, необходимо ли ресурс включать в результаты поиска.
cacheable	Определяет, необходимо ли ресурс кешировать.
createdby	Содержит идентификатор (id) пользователя, который создал ресурс.
editedby	Содержит идентификатор (id) пользователя, который последним редактировал этот ресурс.
deleted	Определяет, отмечен ли ресурс на удаление или нет.
deletedby	Содержит идентификатор (id) пользователя, который отметил ресурс на удаление.
publishedby	Содержит идентификатор (id) пользователя, который опубликовал ресурс.
createdon	Содержит дату создания ресурса пользователем.
publishedon	Содержит дату публикации ресурса.
editedon	Содержит дату последнего редактирования документа.
pub_date	Содержит дату, начиная с которой ресурс будет опубликован.
unpub_date	Содержит дату, начиная с которой ресурс будет снят с публикации.

Где хранятся ресурсы

Ресурсы, как и другие объекты MODX хранятся в базе данных.

Ресурс и связанный с ним шаблон

На этом все.

Автор: Сергей Дата публикации: 13 Июня 2018

www.taursky.ru

Базовые понятия MODX Revolution

Базовые понятия в MODX

Основные блоки для создания сайта с помощью системы управления контентом MODX Revolution – это ресурсы, элементы и файлы.

К ресурсам относятся документы, веб-ссылки, символьные ссылки и статические ресурсы.

Элементы состоят из шаблонов, дополнительных полей, чанков, сниппетов и плагинов.

Файлы есть файлы – программный код, таблицы стилей, java-скрипты, медиа-контент и т. д.

Ресурсы (Resources)

Ресурс – это один из объектов MODX, доступ к которому можно осуществить посредством уникального идентификатора ресурса (URL/URI – Uniform Resource Locator/Identifier).

В основном ресурс представляет собой документ, другими словами, страницу сайта. Каждому такому ресурсу должен быть назначен шаблон, который, в свою очередь, может определять дополнительные поля (переменные шаблона, TV) этого ресурса.

Существует четыре встроенных типа ресурсов:

Документ – самый распространённый ресурс, веб-страница. Состоит из заголовка, описания, аннотации, подробного содержимого, дат и других полей ресурса;
Веб-ссылка – ресурс MODX, который содержит URL (единый указатель ресурсов), ссылку на внешний ресурс или веб-страницу. Основное назначение ресурса – использование в качестве ссылок в меню MODX;
Символьная ссылка – ресурс , указывающий на другой документ MODX, однако поле символьной ссылки содержит только идентификатор ресурса (ID) документа, на который она ссылается. Основное назначение символьных ссылок – как и в предыдущем случае;
Статический ресурс – ресурс, содержащий в поле контента путь к определенному файлу. Если на сайте имеется контент, который не должен изменяться динамически, можно использовать для его отображения статический ресурс.

Шаблоны (Templates)

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

В шаблонах можно использовать любые теги, включая чанки, сниппеты, переменные шаблона.

Переменные шаблона (TV)

Переменные шаблона (Template Variables) – это дополнительные настраиваемые поля ресурсов MODX. Прменяются TV в тех случаях, когда вам необходимо создание новых пользовательских полей ресурса, отсутствующих в стандартном наборе атрибутов документа.

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

Чанки (Chunks)

Чанк – это фрагмент статического HTML-кода, содержит какую-либо часто повторяемую часть контента.

Стоит запомнить, что чанк не может содержать в себе исполняемый PHP-код (для этого служат сниппеты MODX).

В качестве примера можно привести стандартно применяемый чанк head, содержащий мета-теги страницы, ссылки на таблицы стилей и пр.

В шаблоне чанк вызывается так:

[[$имя_Чанка]]

Чанк обладает свойствами шаблона, но не содержит TV-параметры и не может быть назначен ресурсу напрямую.

Сниппеты (Snippets)

Сниппет в MODX – это элемент, который содержит в себе PHP-код, выполняемый во время обработки шаблона.

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

Если в системе уже присутствует какой-либо установленный сниппет, вызывается он так:

[[имя_Сниппета]] //Кэшируемый вызов

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

[[!имя_Сниппета]] //Некэшируемый вызов

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

Плагины (Plugins)

Плагин в MODX представляет собой PHP-код, который в отличие от работы сниппета исполняется при наступлении какого-то определенного системного события. Само событие для срабатывания плагина определяется вами.

В силу этого отдельного вызова плагина, подобно тому, как вызываются чанки и сниппеты, не существует.

Категории (Categories)

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

Присвоить категорию элементу можно как путем перетаскивания элемента в нужную категорию, так и присваиванием элементу категории в специальном поле элемента.

Использование категорий в MODX необязательно.

Вот теперь можно вдумчиво и планомерно начинать чтение документации по CMS/CMF MODX Revolution.

Изучайте, экспериментируйте, создавайте...

modxinfo.ru