Общие шаблоны тегов

Последнее обновление May 13th, 2019 | История страницы | Улучшить эту страницу | Сообщить о проблеме

Support the team building MODX with a monthly donation.

The budget raised through OpenCollective is transparent, including payouts, and any contributor can apply to be paid for their work on MODX.

Backers

Budget

$306 per month—let's make that $500!

Learn more

На этой странице перечислены наиболее часто используемые теги 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]]`	Название сайта	`[[++site_name]]</td> </tr> <tr> <td><strong><code>[[++site_start]]</code></strong></td> <td>Содержит идентификатор страницы, обозначенной как «домашняя» страница.</td> <td>Часто используется вместе с синтаксисом ссылки, например: <code><a id="logo" href="[[~[[++site_start]]]]">Home</a></code></td> </tr> <tr> <td><strong><code>[[$chunk]]</code></strong></td> <td>Это ссылается на чанк по имени. Чанки - это любой контент многократного использования.</td> <td>Общие чанки могут быть для <em>header</em> или <em>footer</em></td> </tr> <tr> <td><strong><code>[[~link]]</code></strong></td> <td>Используйте этот синтаксис для создания ссылок на страницы, ссылаясь на их уникальный идентификатор (отображается в скобках рядом с именем страницы в дереве ресурсов). Эти ссылки не прервутся, если страницы будут перемещены или переименованы. Вы можете изменить сгенерированную схему ссылки, передав параметр & схема (см. <a href="/3.x/ru/building-sites/settings/link_tag_scheme">link_tag_scheme</a>)</td> <td><code><a id="logo" href="[[~1]]">Home</a></code></td> </tr> <tr> <td><strong><code>[[%translated_message]]</code></strong></td> <td>Используйте теги лексикона для локализации сообщений.</td> <td><code>[[!%setting_emailsender? &topic=`setting` &namespace=`core` &language=`en`]]</code></td> </tr> </tbody> </table> <h2>Все теги</h2> <p>По мере того, как вы будете лучше понимать, как работают шаблоны MODX, вы захотите иметь в своем распоряжении полный список доступных полей контента. Вот полный список всех тегов, полученных из этого <a href="https://forums.modx.com/index.php/topic,63481.0/topicseen.html" class="is-externallink" target="_blank" rel="noreferrer noopener">Сообщение блога</a>.</p> <table> <thead> <tr> <th>Тег</th> <th>Тип данных</th> <th>Описание</th> <th>Пример использования</th> </tr> </thead> <tbody> <tr> <td><strong><code>[[alias]]</code></strong></td> <td>text</td> <td>Псевдоним</td> <td>Обычно вы будете использовать <em>id</em> создавая URL, например: <code><a href="[[~[[id]]]]">Click Here!</a></code>, но это позволяет распечатать параметр псевдонима.</td> </tr> <tr> <td><strong><code>[[cacheable]]</code></strong></td> <td>int 0/1</td> <td>Кэшируемый</td> <td></td> </tr> <tr> <td><strong><code>[[class_key]]</code></strong></td> <td>int</td> <td>Ключ класса ресурса, например: <em>modDocument</em></td> <td></td> </tr> <tr> <td><strong><code>[[content]]</code></strong></td> <td>text</td> <td>Содержание ресурса</td> <td></td> </tr> <tr> <td><strong><code>[[content_type]]</code></strong></td> <td>int</td> <td>Тип содержимого</td> <td></td> </tr> <tr> <td><strong><code>[[createdon]]</code></strong></td> <td>date</td> <td>Дата создания, например, <em>2011-04-14 20: 40: 50</em>, часто используется вместе с выходным фильтром <em>strtotime</em></td> <td><code>[[createdon:strtotime:date=`%a %b %e, %Y`]]</code> Смотрите <a href="/3.x/ru/building-sites/tag-syntax/date-formats">Форматы даты</a>.</td> </tr> <tr> <td><strong><code>[[createdby]]</code></strong></td> <td>int</td> <td>Создано пользователем ID</td> <td></td> </tr> <tr> <td><strong><code>[[deleted]]</code></strong></td> <td>int 0/1</td> <td>Удаленный</td> <td></td> </tr> <tr> <td><strong><code>[[deletedby]]</code></strong></td> <td>int</td> <td>Удалено пользователем ID</td> <td></td> </tr> <tr> <td><strong><code>[[deletedon]]</code></strong></td> <td>date</td> <td>Дата удаления</td> <td><code>[[deletedon:strtotime:date=`%a %b %e, %Y`]]</code> Смотрите <a href="/3.x/ru/building-sites/tag-syntax/date-formats">Форматы даты</a>.</td> </tr> <tr> <td><strong><code>[[description]]</code></strong></td> <td>text</td> <td>Описание</td> <td></td> </tr> <tr> <td><strong><code>[[editedon]]</code></strong></td> <td>date</td> <td>Отредактировано на дату, например: <em>2011-04-18 09:06:08</em></td> <td><code>[[editedon:strtotime:date=`%a %b %e, %Y`]]</code> Смотрите <a href="/3.x/ru/building-sites/tag-syntax/date-formats">Форматы даты</a>.</td> </tr> <tr> <td><strong><code>[[editedby]]</code></strong></td> <td>int</td> <td>Отредактировано пользователем ID</td> <td></td> </tr> <tr> <td><strong><code>[[hidemenu]]</code></strong></td> <td>int 0/1</td> <td>Скрыть из меню: этот атрибут используется многими сниппетами, например, Wayfinder</td> <td></td> </tr> <tr> <td><strong><code>[[id]]</code></strong></td> <td>int</td> <td>ID ресурса</td> <td>Часто используется для создания ссылок на эту страницу.</td> </tr> <tr> <td><strong><code>[[introtext]]</code></strong></td> <td>text</td> <td>Резюме</td> <td></td> </tr> <tr> <td><strong><code>[[isfolder]]</code></strong></td> <td>int 0/1</td> <td>Контейнер</td> <td></td> </tr> <tr> <td><strong><code>[[link_attributes]]</code></strong></td> <td>text</td> <td>Атрибуты ссылки: они вставляются автоматически при использовании синтаксиса <code>[[~123]]</code></td> <td></td> </tr> <tr> <td><strong><code>[[longtitle]]</code></strong></td> <td>text</td> <td>Длинное название</td> <td></td> </tr> <tr> <td><strong><code>[[menuindex]]</code></strong></td> <td>int</td> <td>Индекс меню</td> <td></td> </tr> <tr> <td><strong><code>[[menutitle]]</code></strong></td> <td>text</td> <td>Название меню</td> <td></td> </tr> <tr> <td><strong><code>[[pagetitle]]</code></strong></td> <td>text</td> <td>Заголовок страницы</td> <td></td> </tr> <tr> <td><strong><code>[[parent]]</code></strong></td> <td>int</td> <td>Родительский ресурс</td> <td></td> </tr> <tr> <td><strong><code>[[pub_date]]</code></strong></td> <td>date</td> <td>Дата публикации</td> <td></td> </tr> <tr> <td><strong><code>[[published]]</code></strong></td> <td>int 0/1</td> <td>Опубликованно</td> <td></td> </tr> <tr> <td><strong><code>[[publishedby]]</code></strong></td> <td>int</td> <td>Опубликованно пользователем ID</td> <td></td> </tr> <tr> <td><strong><code>[[publishedon]]</code></strong></td> <td>date</td> <td>Опубликован в</td> <td><code>[[publishedon:strtotime:date=`%a %b %e, %Y`]]</code> Смотрите <a href="/3.x/ru/building-sites/tag-syntax/date-formats">Форматы даты</a>.</td> </tr> <tr> <td><strong><code>[[richtext]]</code></strong></td> <td>int 0/1</td> <td>Rich Text</td> <td></td> </tr> <tr> <td><strong><code>[[searchable]]</code></strong></td> <td>int 0/1</td> <td>Searchable</td> <td></td> </tr> <tr> <td><strong><code>[[template]]</code></strong></td> <td>int</td> <td>Идентификационный номер шаблона</td> <td></td> </tr> <tr> <td><strong><code>[[unpub_date]]</code></strong></td> <td>date – Дата отмены публикации</td> <td><code>[[unpub_date:strtotime:date=`%a %b %e, %Y`]]</code> Смотрите <a href="/3.x/ru/building-sites/tag-syntax/date-formats">Форматы даты</a>.</td> <td></td> </tr> <tr> <td><strong><code>[[uri_override]]</code></strong></td> <td>int 0/1</td> <td>Замороженный URI</td> <td></td> </tr> <tr> <td><strong><code>[[*uri]]</code></strong></td> <td>string</td> <td>URI</td> <td></td> </tr> </tbody> </table> <p>Чтобы уточнить <code>pub_date</code> - он устанавливается только тогда, когда пользователь устанавливает будущую дату публикации в поле «Опубликовать в». И когда документ действительно опубликован, он обнуляется. Поле опубликовано всегда содержит самую последнюю дату, когда ресурс изменил неопубликованную форму на опубликованную (или дату, когда новый документ был сохранен с проверкой публикации).</p> <h2>Смотрите также</h2> <ol> <li> <a href="/3.x/ru/building-sites/tag-syntax/date-formats">Форматы даты</a>: показывает, как форматировать поля даты.</li> <li> <a href="/3.x/ru/building-sites/resources">Ресурсы</a> </li> <li> <a href="/3.x/ru/building-sites/resources/content-types">Типы контента</a> </li> <li> <a href="/3.x/ru/building-sites/integrating-templates/named-anchor">Именованный якорь</a> </li> <li> <a href="/3.x/ru/building-sites/resources/static-resource">Статический Ресурс</a> </li> <li> <a href="/3.x/ru/building-sites/resources/symlink">Символическая ссылка</a> </li> <li> <a href="/3.x/ru/building-sites/resources/symlink/using-resource-symlinks">Использование ресурсных ссылок</a> </li> <li> <a href="/3.x/ru/building-sites/resources/weblink">Вебссылка</a> </li> <li> <a href="/3.x/ru/building-sites/elements/templates">Шаблоны</a> </li> <li> <a href="/3.x/ru/building-sites/elements/chunks">Чанки</a> </li> <li> <a href="/3.x/ru/building-sites/elements/snippets">Использование сниппетов</a> </li> </ol> </body>