Наведені нижче елементи не знаходяться в дереві елементів в панелі управління, але вони служать для зберігання і подання контенту вашого сайту. Вони включають в себе плейсхолдери, посилання, системні настройки, теги і поля.
Плейсхолдери, посилання і системні настройки
Плейсхолдери не відображаються в дереві елементів панелі управління, але вони є елементами, оскільки містять контент і можуть відображатися, використовуючи теги ресурсів. Причина, по якій вони не показані в дереві елементів полягає в тому, що їх значення завжди встановлюється в сниппета або плагінах, а не вводиться в панелі управління. Сніппет або плагін встановлює плейсхолдер за допомогою наступного коду PHP:
Після установки плейсхолдера це значення замінить будь-який відповідний тег плейсхолдера:
Відзначимо, що для того, щоб працював тег [[+ autor_name]]. тег сниппета повинен знаходитися в коді раніше, тоді плейсхолдер буде встановлений.
MODX встановить для вас пару плейсхолдеров при кожному запиті сторінки, які ви можете використовувати для відображення ідентифікатора або імені користувача поточного користувача, який ввів логін і пароль (якщо такі в даний час є).
Ідентифікатор поточного користувача: [[+ modx.user.id]]
Ім'я поточного користувача: [[+ modx.user.username]]
Посилання являють собою URL сторінки сайту і засновані на використанні одного з полів ресурсів - ідентифікатора ресурсу. У більшості випадків посилання використовуються для звернення до документів. Ідентифікатор ресурсу документа іноді називається ідентифікатором документа. Даний ідентифікатор відображається в дужках в поле ресурсів панелі управління поруч з ім'ям ресурсу. Ви можете розмістити посилання використовуючи тег посилання:
8]]. Ім'я документа може змінюватися, може змінюватися розташування ресурсу на сайті, але тег посилання завжди буде надійно вказувати на даний ресурс, оскільки номер ідентифікатора ресурсу ніколи не змінюється. При організації посилань на сторінки вашого сайту бажано завжди використовувати теги посилань.
Подібно плейсхолдерам установки не відображаються в дереві елементів, але можуть відображатися, використовуючи теги (точніше, теги установки). Установка в більшості випадків є змінною, значення якої є на сайті MODX. Установки включають в себе системні настройки, контекстні налаштування і призначені для користувача настройки (більш докладно про це далі). Всі настройки можна відображати за допомогою тега налаштувань:
Ви можете використовувати теги налаштувань для відображення або використання значень будь-яких системних, контекстних або призначених для користувача налаштувань. Деякі системні настройки дуже важливі для роботи MODX, тому не змінюйте системні настройки, якщо ви не впевнені.
Ми вже обговорювали деякі теги MODX, а зараз давайте розглянемо їх докладніше. Всі теги MODX замінюються об'єктами, які вони представляють. Ось короткий список, який показує що буде замінений кожен тег:
- Тег чанка - вміст чанка.
- Тег ресурсу - значення поля ресурсу або TV-параметра, яку він представляє.
- Тег сниппета - повертається значення коду PHP в сніпеті.
- Тег посилання - URL ресурсу, на який він посилається.
- Тег плейсхолдера - значення плейсхолдера (часто встановлюється в сніпеті або плагін).
- Тег налаштування - значення контекстної, призначеної для користувача або системного настроювання (змінної).
- Мовний тег - певна мовна рядок з поточного лексикону.
У версіях MODX Revolution все теги починаються з [[і закінчуються]]. Ми розглянули більшість тегів і в таблиці 1-1 дається перелік нових стилів тегів, які використовуються в MODX Revolution, а також теги, які використовуються в більш ранніх версіях MODX:
Таблиця 1-1. Старі і нові стилі тегів
MODX Evolution (стара версія)
Відзначимо, що символи після відкривають дужок ($, +, ++, *,
і%) в MODX називаються токенами. Вони кажуть MODX який тип тега обробляється.
Новачки в MODX не завжди розуміють, що теги можуть використовуватися в MODX практично скрізь і то, що ви можете використовувати вкладені теги. Тег сниппета, наприклад, може містити в якості властивості чанк, а чанк може містити теги ресурсів, які можуть містити теги посилань. Нижче наведено приклад тега настройки, вкладеного в тег посилання. Він відобразить посилання на домашню сторінку сайту:
Давайте розберемо цю конструкцію і спочатку подивимося на зовнішній тег, який є тегом посилання.
X]] є тегом посилання, де елемент X позначає ідентифікатор ресурсу документа, на який ви хочете поставити посилання. Цей елемент буде замінений на URL, пов'язаний з цим документом. Іншими словами, наприклад тег [[
12]] буде замінений на URL документа, чий ідентифікатор ресурсу 12.
У використанні домашньої сторінки немає нічого складного. Системна змінна site_start може вказувати на будь-яку сторінку сайту і MODX обробляє цю сторінку подібно до інших.
[[++ site_start]] є тегом настройки, який буде замінений ідентифікатором ресурсу головної сторінки вашого сайту. Тому, якщо ідентифікатор ресурсу вашої домашньої сторінки дорівнює 1 (і часто так воно і є), цей тег буде замінений числом 1.
При створенні вкладених тегів в MODX завжди звертайте увагу на кількість квадратних дужок зліва і справа. Це кількість повинна бути однаково і в MODX Revolution має бути парним числом.