ТВ опции в MODX Revolution

revolution

Променливата на шаблона (TV) е потребителско поле, или по-конкретно, това е персонализирано поле за MODx ресурс. Телевизорите се използват за разширяване на атрибутите по подразбиране, налични за даден ресурс (като страница или уеб връзка). Един нормален MODx ресурс има определен брой полета по подразбиране: заглавие на страницата, съдържание, описание и т.н. Ако трябва да добавите някои персонализирани полета към страниците си, като второ поле за съдържание или падащ списък с имена на месеци, или друг вид персонализирани данни, можете да направите това, като добавите TV към шаблона. MODx ви позволява да имате почти неограничен брой телевизори.

Когато ресурсът се покаже в браузъра, TV се заменя с действителната стойност, въведена от потребителя. TV се използват само в шаблоните, за които са зададени.

Изходните филтри ще направят телевизията по-удобна за потребителя и ще ви помогнат да добавите специални визуални ефекти към уебсайтовете си. Само с няколко щраквания можете да добавите изображения, URL адреси или свой собствен метод за анализ на документи към вашия сайт.

използване на телевизия

Да кажем, че има телевизия, наречена „био“ – уточнихме по време на създаването, че това е текстова телевизия и я приписахме на шаблона „Страници с биография“. За да покажем нашия телевизор на страницата, трябва да направим повикване в шаблона:

Освен това можете да предавате параметри към телевизора. Да приемем, че имаме телевизор, наречен „intromsg“ със съдържание:

Можете да предавате параметри по същия начин като парчетата:

На изхода ще получим:

Изходните филтри са чудесен инструмент за манипулиране на нашите телевизори. Между другото, ако искате да изведете само 100 знака от стойността на TV, тогава това може да стане с изходния филтър 'limit':

Ще говорим за филтрите малко по-късно.

Създаване на телевизионен параметър

  1. Отидете на контролния панел на MODx
  2. Добавете телевизор

В лявата част на контролния панел отидете в раздела Елементи и щракнете с левия бутон върху бутона с иконата на телевизора.

Попълнете обща информация

  • Име : ще се използва при обаждане на телевизия, т.е.био = . Трябва да е УНИКАТЕН!
  • Заглавие : ще се показва при редактиране на телевизионно съдържание.
  • Описание : ще се показва при редактиране на телевизия.
  • Категория : ще създаде нов раздел при редактиране на телевизия.
  • Сортиране : ако използвате повече от един телевизор, това ще определи кои да се показват най-отгоре (1 = отгоре, големи числа отдолу)

Следващата стъпка е да отидете в раздела Опции за въвеждане. Тук трябва да изберем как ще се показва нашият телевизор, докато пишете:

  • Тип въвеждане : Полето за въвеждане може да бъде просто текстово поле, падащ списък, връзка към друга страница или повече.
  • ВходПараметри : Някои типове вход могат да бъдат игнорирани от това поле. Например само числова стойност.
  • По подразбиране : Стойността по подразбиране, ако полето е празно.

Настройка на достъп до телевизия

Отидете в раздела „Налични за шаблони“: трябва да определите кой шаблон(и) този телевизор действително ще използва и да ги изберете.

Всеки път, когато създавате ресурс, който използва шаблона, към който е прикачен телевизорът, телевизорът ще може да се редактира. Уверете се, че сте прикачили телевизор към поне един шаблон.

Когато завършите всичко, можете да запазите телевизия.

Сега, след като сте създали вашия телевизор и сте го прикрепили към шаблона, можетесъздайте MODx ресурс (например, щракнете с десния бутон върху дървото на документа и изберете Нов -> Създаване на дъщерен ресурс). Изберете шаблона, който този телевизор използва.

След като вашият MODx ресурс (т.е. страница) използва шаблон, съдържащ шаблонна променлива, можете да добавите стойност към него, като щракнете върху раздела „Допълнителни полета“ на страницата.

Изходно форматиране

След това ще изберем опциите за изобразяване на изхода. Ще изберем телевизионна „дата“:

Тук можем да персонализираме изходния формат на датата.

Във връзка с телевизията източникът на данни е местоположението на информацията, която трябва да бъде показана. Източниците на данни могат да бъдат следните:

  • външен файл, който се изпраща чрез FTP до сървъра
  • таблица с налични бази данни за MODx
  • ресурси в дървото на ресурсите
  • парче в дървото на елементите
  • Резултат от изпълнение на PHP код

Тези източници на данни могат да бъдат обвързани с TV за форматиране и показване в документа. Форматът за използване на типове източници на данни е наличен за всички телевизори, както следва:

  • @FILE път на файла
  • @RESOURCE идентификатор на ресурс
  • @CHUNK име на парче
  • @SELECT sql заявка
  • @EVAL PHP код
  • @DIRECTORY път спрямо root
  • @INLINE е наличен в някои фрагменти (например getResources), това е специфична част, написана на един ред при извикване.

Подвързване на парчета

@CHUNK Binding връща анализирана част, когато @CHUNK се използва в шаблонна променлива (TV).

С други думи, ако @CHUNK hello е стойността на телевизор, наречен MyChunk, следващият таг в съдържанието на шаблона или ресурса, полето за ресурс ще бъде заменено от съдържанието на парчето Hello:

ДИРЕКТОРИЯ Подвързване

ДИРЕКТОРИЯ Обвързването чете съдържаниетодиректории. Това може да бъде наистина полезно, когато се свързвате към списък с джаджи, например ако искате да дадете на потребителя списък с лога, от които да избира за дадена страница, или да изберете кой mp3 файл се възпроизвежда на определена страница. ЗАПОМНЕТЕ: връща цялото съдържание на директория, включително всички файлове и всички директории - с единственото изключение на префиксните директории с точка.

Когато създавате шаблонна променлива, поставете следния текст в полето за въвеждане на стойност:

Често това се комбинира с тип въвеждане: „Падащо меню“, за да позволи на потребителя да избере файл от списък.

Подвързване EVAL

Тази връзка трябва да се използва при прилагане на необходимите мерки за сигурност.

За да използвате, трябва само да напишете php код:

Свързване на ФАЙЛ

Това обвързване връща съдържанието на външен файл.

Командата @FILE е много полезна в случаите, когато може да искаме да генерираме данни, които са налични във файл. Като използваме знаците и == като разделители, можем да взаимодействаме с всяко външно приложение за база данни.

Обвързване на РЕСУРСИ

Това обвързване връща генерираното съдържание на ресурса.

ИЗБЕРЕТЕ Обвързване

Този пакет връща отговора на заявката в базата данни.

Типове входни данни за телевизия

Това е удобна шаблонна променлива за използване на тагове, за блог, винаги когато имате нужда от списък с тагове, които са били използвани преди. Всеки път, когато искате да промените или създадете ресурс с достъп до променливата на шаблона за автоматично маркиране, ще видите таговете, които са били използвани преди това. Можете лесно да щракнете върху често използвани тагове и да ги изберете от списъка.

За да изведете тагове, така че всеки таг да е връзка към конкретен ресурс и да приема етикета като GET параметър, виеМожете да използвате изходния филтър (фрагмент) по този начин:

Основната употреба е просто да дефинирате полето като квадратче за отметка. Можете да контролирате дали квадратчето за отметка ще бъде отметнато по подразбиране или не, като манипулирате „въведена стойност“ и „Стойност по подразбиране“.

Отметнато по подразбиране

  • Стойности на опцията за въвеждане: My Option==1
  • Стойност по подразбиране: 1

Не е отметнато по подразбиране:

  • Стойности на опцията за въвеждане: My Option==1
  • Стойност по подразбиране: 0

Можете да посочите множество ключове и стойности с помощта на разделител (двойна вертикална лента):

Позволява ви да изберете дата и час.

Стойност по подразбиране

Функция

вчера

Вчера, час 12:00ч

днес

Днес, час 12:00ч

сега

Текуща дата и час

утре

Утре, час 12:00ч

+X

X - часове от текущата дата, например +72 означава "3 от текущия момент"

-X

X - часове от текущата дата, например -72 означава "3 дни"

Задайте входни стойности на опцията във формат опция1 == стойност1 опция2 == стойност2 опция3 == стойност3. Уверете се, че сте избрали разделения изходен тип (или каквото искате). Можете също да използвате @SELECT, за да изберете 2 колони по следния начин:

Има и списък с ресурси.

Това е текстово поле, което се проверява: ще се приема само текст, който е във валиден имейл формат.

Създава форма за въвеждане - файл за качване на сървъра. Файловете могат да се качват чрез файловия мениджър на MODx. Можете да декларирате стойност по подразбиране, като посочите път към файла.

Бъдете особено внимателни относно относителните файлови пътища, когато използвате приятелски URL адреси.

Скритото поле не се показва в мениджъра, така че трябва да е нещо рядко. Можете да зададете стойност по подразбиране, която може да бъде извлечена на всички страници, използващи тази променлива. Друга възможност е да съхраните фрагмент, който приема идентификатора на страницата като вход.