TV-параметри в MODx Revolution

Змінна шаблону (TV) є полем, що налаштовується, або, точніше, це налаштовується поле для ресурсу MODx. TV використовуються для розширення стандартних атрибутів, доступних для ресурсу (наприклад, для сторінки або веб-посилання). Нормальний MODx ресурс має певну кількість полів за замовчуванням: pagetitle, content, description і т.д. Якщо вам потрібно додати деякі поля користувача на ваші сторінки, наприклад друге поле контенту або список назв місяців, що випадає, або будь-який інший вид користувацьких даних, ви можете зробити це, додавши TV в шаблон. MODx дозволяє мати практично необмежену кількість TV.

Коли ресурс відображається у браузері, TV замінюється фактичним значенням, введеним користувачем. TV використовуються лише в шаблонах, для яких вони призначені.

Вихідні фільтри зроблять TV зручнішим для користувачів, вони допоможуть додати спеціальні візуальні ефекти на своїх веб-сайтах. За допомогою лише кількох кліків миші, ви можете додати зображення, URL або свій спосіб парсингу документа на ваш сайт.

Використання TV

Припустимо, є TV з ім'ям 'bio' – ми вказали при створенні, що це текстовий TV і віднесли його до шаблону 'Biography Pages'. Для того, щоб показати нашу TV на сторінці, необхідно зробити виклик у шаблоні:

Крім того, можна передавати параметри в TV. Допустимо, у нас є TV під назвою 'intromsg' із вмістом:

Ви можете передати параметри, аналогічно чанкам:

На виході ми отримаємо:

Вихідні фільтри – це чудовий інструмент маніпулювання нашими TV. До речі, якщо ви хочете вивести лише 100 символів із значення TV, то це можна зробити вихідним фільтром 'limit':

Про фільтри ми поговоримо трохи згодом.

Створення TV-параметра

Заходимо в панель керування MODx
Додаємо TV

У лівій частині панелі керування переходимо на вкладку Елементи і натискаємо лівим кліком на кнопку з іконкою-телевізором.

Заповнюємо загальну інформацію

Ім'я : використовуватиметься при виклику TV, тобто.bio = . Воно має бути УНІКАЛЬНИМ!
Заголовок : відображатиметься під час редагування вмісту TV.
Опис : відображатиметься під час редагування TV.
Категорія : створить нову вкладку під час редагування TV.
Сортування : якщо ви використовуєте більше одного TV, це визначатиме, які з'являються у верхній частині (1 = верх, великі номери нижче)

Наступний крок – перехід на вкладку Параметри введення. Тут нам потрібно вибрати, як буде відображатися наш TV при введенні:

Тип введення : поле введення може бути простим текстовим полем, списком, що випадає, посиланням на іншу сторінку, або ін.
Вхідніпараметри : Деякі типи вхідних можуть бути проігноровані цим полем. Наприклад, лише числове значення.
За замовчуванням : значення за промовчанням, якщо поле не заповнене.

Налаштування доступу до TV

Перейдіть на вкладку 'Доступно для шаблонів': необхідно визначити, який шаблон (и) насправді використовуватиме цей TV і вибрати їх.

Щоразу, коли ви створюєте ресурс, який використовує шаблон, до якого TV був прикріплений, TV буде доступним для редагування. Переконайтеся, що ви прикріпили TV до принаймні одного шаблону.

Коли ви заповнили все, ви можете зберегти TV.

Тепер, коли ви створили свій TV та прикріпили його до шаблону, можнастворити ресурс MODx (наприклад, клацніть правою кнопкою миші у дереві документа та виберіть Створити -> Створити дочірній ресурс). Виберіть шаблон, який використовує цей телевізор.

Як тільки ваш MODx ресурс (тобто сторінка) використовує шаблон, що містить змінну шаблон, ви можете додати йому значення, натиснувши на вкладці "Додаткові поля" сторінки.

Форматування висновку

Далі ми виберемо вихідні опції рендерингу. Ми оберемо TV 'date':

Тут ми можемо настроїти формат виведення дати.

Стосовно TV, джерело даних – це розташування інформації, яка має бути показана. Джерела даних можуть бути такі:

зовнішній файл, який надсилається через FTP на сервер
таблиця БД, доступних для MODx
ресурси у дереві ресурсів
чанк у дереві елементів
результат виконання PHP-коду

Ці джерела даних можуть бути прив'язані до TV для форматування та відображення у документі. Формат використання типів джерел даних доступний для всіх TV наступним чином:

@FILE шлях до файлу
@RESOURCE ідентифікатор ресурсу
@CHUNK ім'я чанка
@SELECT sql запит
@EVAL php-код
@DIRECTORY шлях щодо кореня
@INLINE доступно в деяких сніпетах (наприклад, getResources), це специфічний чанк, написаний в один рядок під час виклику.

Chunk bindings

@CHUNK Binding повертає розібраний чанк, коли @CHUNK використовується у змінній шаблоні (TV).

Іншими словами, якщо @CHUNK hello є значенням TV званої MyChunk, наступний тег у шаблоні або у вмісті ресурсу, поле ресурсу буде замінено вмістом чанка Hello:

DIRECTORY Binding

DIRECTORY Binding зчитує вмістдиректорії. Це може дійсно корисно, коли ви пов'язуєте зі списком віджетів, наприклад, якщо ви хочете дати користувачеві список логотипу на вибір для сторінки, або вибрати файл mp3 грає на певній сторінці. ПОМ'ЯТАЙТЕ: він повертає весь вміст каталогу, включаючи всі файли та всі каталоги - з єдиним винятком каталогів префікса з періодом.

При створенні змінної шаблону помістіть наступний текст у полі введення значення:

Часто це поєднується з вхідним типом: "Випадаючий список меню", щоб дозволити користувачеві вибрати файл зі списку.

EVAL Binding

Цю зв'язку слід використовувати при застосуванні необхідних заходів безпеки.

Для застосування слід просто написати php-код:

FILE Binding

Ця зв'язка повертає вміст зовнішнього файлу.

Команда @FILE дуже корисна в тих випадках, коли ми хочемо, щоб генерувалися дані, доступні у файлі. Використовуючи і == символи як роздільник ми могли взаємодіяти з будь-яким зовнішнім додатком бази даних.

RESOURCE Binding

Ця зв'язка повертає згенерований вміст ресурсу.

SELECT Binding

Ця зв'язка повертає відповідь на запит до БД.

Вхідні типи даних для TV

Є зручною змінною шаблон для використання тегів, для блогу, в будь-який час вам потрібен список тегів, які були використані раніше. Щоразу, коли ви захочете змінити або створити ресурс з доступом до змінної шаблону - авто-тега, ви побачите мітки, які були використані раніше. Ви можете легко натиснути на теги, що часто використовуються, і вибрати їх у списку.

Для виведення тегів таким чином, щоб кожен тег був посиланням на певний ресурс і приймає тег як параметр GET, виВи можете використовувати вихідний фільтр (СНІПЕТ) наступним чином:

Базове використання – просто визначити поле у вигляді прапорця. Ви можете керувати, чи буде checkbox встановлений за замовчуванням чи ні, маніпулюючи "вхідним значенням" і "Значенням за умовчанням".

За замовчуванням відзначено

Input Option Values: My Option==1
Default Value: 1

За замовчуванням не зазначено:

Input Option Values: My Option==1
Default Value: 0

Ви можете встановити кілька ключів і значень за допомогою роздільника (подвійна вертикальна риса):

Дозволяє вибрати дату та час.

Значення за умовчанням

Функція

yesterday

Вчорашній день, час 12:00pm

today

Сьогодні, час 12:00pm

now

Поточна дата та час

tomorrow

Завтрашній день, час 12:00pm

X – годинник від поточної дати, наприклад, +72 означає "3 від поточного моменту"

-X

X – годинник від поточної дати, наприклад, -72 означає "3 дні"

Встановіть вхідні значення опцій у форматі option1 == значення1 опція2 == значення2 option3 == значення3. Переконайтеся, що ви вибрали тип виводу з роздільниками (або інший на ваш смак). Ви також можете використовувати @SELECT, щоб вибрати 2 колонки, наприклад:

Також є перелік ресурсів.

Це текстове поле, яке проходить валідацію: буде прийнято лише текст, який знаходиться у допустимому форматі електронної пошти.

Створює форму введення – файл для завантаження на сервер. Файли можуть бути завантажені через файловий менеджер MODx. За промовчанням можна оголосити значення, вказавши шлях до файлу.

Будьте уважні до відносних шляхів до файлів при використанні дружніх URL.

Приховане поле не з'являється в менеджері, тому це має бути щось рідкісне. Ви можете встановити значення за промовчанням, які можуть бути вилучені на всіх сторінках, використовуючи цю змінну. Інша можливість полягає у зберіганні фрагмента, який бере- ID сторінки як вхідні дані.