Веб ресурсы

Веб ресурсы (обычно упоминаемые как просто ресурсы) - наиболее простой  для описания из объектов MODX : это те объекты, доступ к которым вы можете осуществить посредством единого указателя ресурсов (URL). Наиболее распространенными до сих пор в MODX ресурсами являлись документы. Фактически документы являются типом ресурсов по умолчанию. Многие пользователи MODX никогда не создавали символьные ссылки, веб ссылки или статические ресурсы, но каждый создавал множество документов. Наиболее удобным способом создания ресурсов является клик правой кнопкой мыши где-нибудь в области дерева ресурсов  - в таблице Ресурсы  (Resources) в левой части панели управления.

панель управления

Далее в меню нужно выбрать пункт Create (Создать). При этом откроется вкладка с возможностью выбора :

  • Создать документ здесь  (Create a Document here)
  • Создать веб ссылку здесь (Create a Weblink here)
  • Создать символьную ссылку здесь (Create a Symlink here)
  • Создать статический ресурс здесь (Create a Static Resource here)

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

Вы также можете создавать новые ресурсы, кликнув на закладке "Сайт" ("Site") в верхнем меню и выбрав тип ресурса, который хотите создать. Имеются также небольшие иконки в верхней части дерева ресурсов, которые позволяют делать это же. При всех этих действиях мы создаем в дереве ресурсов ресурс верхнего уровня  (под иконкой "web"). Обычно вам требуется располагать ресурсы  в определенном месте дерева ресурсов, поэтому чаще всего наилучшим вариантом будет кликнуть правой кнопкой на вышестоящем ресурсе или папке.

Документы

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

Документ, с другой стороны, представляет собой специфический объект, созданный в панели управления MODX. Если вы используете текстовый редактор, подобный Microsoft Word, вы уже создаете документы. Эти документы имеют заголовок, некоторое содержание, дату создания, имя автора и т.д. Документы в MODX очень похожи на документы, создаваемые в текстовом редакторе, но они адаптированы для использования на веб страницах. Например, они имеют более одного заголовка. Имеется краткий заголовок (Title), расширенный заголовок, часто используемый в качестве заготовка страницы (Long Title), заголовок для использования в меню (Menu Title) и заголовок для использования в URL, связанным с документом (Alias).

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

Имеется еще одно различие, которое мы должны упомянуть. Многие из полей ресурсов известны под двумя именами. Одно имя, это фактическое имя поля в базе данных MODX. Это имя, которое должно использоваться в коде или в тегах MODX (подробнее об этом позже). Другое имя, это обычное имя поля, взятое из панели Создать/Редактировать (Create/Edit) ресурс в панели управления, где вы фактически заполняете значения.  Например, в панели Создания/Редактирования (Create/Edit) мы можем работать с полем под назанем "Аннотация" (Summary), однако в базе данных MODX оно имеет название introtext. Когда мы будем говорить об имени поля в базе данных, мы будем для отличия его от общеупотребимого имени использовать жирный шрифт.

 

Здесь мы будем обращаться к документам как к ресурсам (каковыми они и являются). Документ является типом ресурса по умолчанию и также наиболее часто используемым ресурсом, но кроме документов имеются и другие ресурсы : веб ссылки, символьные ссылки и статические ресурсы. Итак, все документы являются ресурсами, но не все ресурсы являются документами.

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

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

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

Веб-ссылки, символьные ссылки и статические ресурсы

Веб ссылка представляет собой ресурс MODX, который содержит URL (единый указатель ресурсов, называемый также ссылкой) в поле контента. Используя веб ссылку, мы можем задавать адрес страницы нашего сайта MODX или любого другого сайта в сети. В MODX ссылку можно указать при помощи полного URL :

http://ваш_сайт.ru/home.html

Ссылка на страницу вашего собственного сайта MODX может быть также указана при помощи тега ссылки (например, [[~1]]). Если на вашем сайте домашняя страница имеет номер ресурса 1 (другими словами её идентификатор ресурса, или ID, равен 1), то в данном случае MODX заменит указанный тег ссылки на полный URL, который будет указывать на вашу домашнюю страницу.

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

Символьная ссылка также является ресурсом MODX, указывающим на другой документ, но поле символьной ссылки содержит только идентификатор ресурса (ID) документа, на который ссылаются, и она должна указывать на страницу сайта MODX.

Основным назначением веб ссылок и символьных ссылок является использование их в качестве ссылок в меню MODX. Это вопрос, который мы рассмотрим более подробно позже.

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

Статические ресурсы могут также содержать ссылки на файлы .pdf или .doc, которые может просмотреть или загрузить посетитель.

НазадВперёд