Jump to main content Jump to doc navigation

На этой странице перечислены наиболее часто используемые теги MODX Revolution, которые помогут любому преобразовать макеты HTML / CSS в MODX. Шаблоны. Они часто упоминаются как «теги» или плейсхолдеры (а иногда и «переменные шаблона»), поэтому мы упоминаем эти термины здесь в качестве помощи при поиске, хотя с технической точки зрения они не плейсхолдеры или переменные шаблона: они являются тегами MODX Да, это может сбить с толку новичка, поэтому просто помните, что у этих тегов есть разные варианты, каждый со своим назначением и именем. Плейсхолдеры задаются в коде и отображаются с тегами плейсхолдеров. Переменные шаблонов являются дополнительными полями содержимого ресурса, созданными пользователем. Их можно рассматривать как настраиваемые поля. Ни плейсхолдеры, ни переменные шаблона не установлены ядром MODX.

Теги поля контента ресурса по умолчанию

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

Тег Описание Пример использования
[[*id]] Идентификатор ресурса страницы (устанавливается MODX при создании страницы. Часто используется вместе с синтаксисом ссылки, например: <a href="[[~[[*id]]]]">Bookmark this page!</a>
[[*pagetitle]] Название страницы. <title>[[*pagetitle]]</title>
[[*longtitle]] Расширенный заголовок страницы <h1>[[*longtitle]]</h1>
[[*alias]] Псевдоним страницы. Используется для построения URL страницы
[[*description]] Описание страницы <meta name="description" content="[[*description]]"/>
[[*introtext]] вводное текстовое поле (a.k.a. резюме). Часто используется Снипеттами для обобщения постов, например: <div id="summary">[[*introtext]]</div>
[[*parent]] Идентификатор родительской страницы (если есть). Устанавливается MODX при создании страницы. Может быть изменено пользователем. Часто используется вместе с синтаксисом ссылки, например: <a href="[[~[[*parent]]]]">Up to parent page</a>
[[*menutitle]] Название используется, когда страница появляется в меню. Наиболее часто используемые сниппеты, такие как Wayfinder или pdoMenu при динамическом построении меню
[[*content]] Cодержание страницы. <body>[[*content]]</body>

Другие общие теги

Эти теги представляют системные настройки, которые можно редактировать в меню Система -> Системные настройки.

Тег Описание Пример использования
[[++site_url]] Содержит URL для вашего сайта, например: http://www.yoursite.com/ Со многими CMS, которые полагаются на переписывание Apache, обычной практикой является включение базового тега в заголовок HTML: <base href="[[++site_url]]" />
[[++site_name]] Название сайта <title>[[++site_name]] | [[*pagetitle]]</title>
[[++site_start]] Содержит идентификатор страницы, обозначенной как «домашняя» страница. Часто используется вместе с синтаксисом ссылки, например: <a id="logo" href="[[~[[++site_start]]]]">Home</a>
[[$chunk]] Это ссылается на чанк по имени. Чанки - это любой контент многократного использования. Общие чанки могут быть для header или footer
[[~link]] Используйте этот синтаксис для создания ссылок на страницы, ссылаясь на их уникальный идентификатор (отображается в скобках рядом с именем страницы в дереве ресурсов). Эти ссылки не прервутся, если страницы будут перемещены или переименованы. Вы можете изменить сгенерированную схему ссылки, передав параметр & схема (см. link_tag_scheme) <a id="logo" href="[[~1]]">Home</a>
[[%translated_message]] Используйте теги лексикона для локализации сообщений. [[!%setting_emailsender? &topic=`setting` &namespace=`core` &language=`en`]]

Все теги

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

Тег Тип данных Описание Пример использования
[[*alias]] text Псевдоним Обычно вы будете использовать id создавая URL, например: <a href="[[~[[*id]]]]">Click Here!</a>, но это позволяет распечатать параметр псевдонима.
[[*cacheable]] int 0/1 Кэшируемый
[[*class_key]] int Ключ класса ресурса, например: modDocument
[[*content]] text Содержание ресурса
[[*content_type]] int Тип содержимого
[[*createdon]] date Дата создания, например, 2011-04-14 20: 40: 50, часто используется вместе с выходным фильтром strtotime [[*createdon:strtotime:date=`%a %b %e, %Y`]] Смотрите Форматы даты.
[[*createdby]] int Создано пользователем ID
[[*deleted]] int 0/1 Удаленный
[[*deletedby]] int Удалено пользователем ID
[[*deletedon]] date Дата удаления [[*deletedon:strtotime:date=`%a %b %e, %Y`]] Смотрите Форматы даты.
[[*description]] text Описание
[[*editedon]] date Отредактировано на дату, например: 2011-04-18 09:06:08 [[*editedon:strtotime:date=`%a %b %e, %Y`]] Смотрите Форматы даты.
[[*editedby]] int Отредактировано пользователем ID
[[*hidemenu]] int 0/1 Скрыть из меню: этот атрибут используется многими сниппетами, например, Wayfinder
[[*id]] int ID ресурса Часто используется для создания ссылок на эту страницу.
[[*introtext]] text Резюме
[[*isfolder]] int 0/1 Контейнер
[[*link_attributes]] text Атрибуты ссылки: они вставляются автоматически при использовании синтаксиса [[~123]]
[[*longtitle]] text Длинное название
[[*menuindex]] int Индекс меню
[[*menutitle]] text Название меню
[[*pagetitle]] text Заголовок страницы
[[*parent]] int Родительский ресурс
[[*pub_date]] date ---Дата публикации
[[*published]] int 0/1 Опубликованно
[[*publishedby]] int Опубликованно пользователем ID
[[*publishedon]] date Опубликован в [[*publishedon:strtotime:date=`%a %b %e, %Y`]] Смотрите Форматы даты.
[[*richtext]] int 0/1 Rich Text
[[*searchable]] int 0/1 Searchable
[[*template]] int Идентификационный номер шаблона
[[*unpub_date]] date – Дата отмены публикации [[*unpub_date:strtotime:date=`%a %b %e, %Y`]] Смотрите Форматы даты.
[[*uri_override]] int 0/1 Замороженный URI
[[*uri]] string URI

Чтобы уточнить pub_date - он устанавливается только тогда, когда пользователь устанавливает будущую дату публикации в поле «Опубликовать в». И когда документ действительно опубликован, он обнуляется. Поле опубликовано всегда содержит самую последнюю дату, когда ресурс изменил неопубликованную форму на опубликованную (или дату, когда новый документ был сохранен с проверкой публикации).

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

  1. Ресурсы
  2. Типы контента
  3. Именованный якорь
  4. Статический Ресурс
  5. Символическая ссылка
  6. Использование ресурсных ссылок
  7. Вебссылка
  8. Шаблоны
  9. Чанки
  10. Использование сниппетов