TV-параметры позволяют добавить к документу дополнительную информацию, которую затем можно использовать на равне с основными параметрами. Также TV-параметры имеют различные типы и в зависимости от этого меняется их управление и представление.

TV-параметры задуманы таким образом, чтобы передавать значение переменной и при этом именоваться, как угодно. Но стоит ли дать создавать новые параметры, когда среди уже имеющихся по умолчанию представлен исчерпывающий список имён, о котором не всем известно?

Рассмотрим основные и системные TV-параметры по умолчанию в CMS MODx Evo и Evolution СMS.

Параметр в MODX - элемент, который содержит определенную информацию для текущей страницы. Их можно непосредственно вывести на страницу или передать сниппету в качестве параметра.

Основные параметры содержат информацию о документе.

*pagetitle* - заголовок документа

*longtitle* - расширенный заголовок документа

*description* - описание документа

*introtext* - аннотация документа

*content* - содержимое документа

*id* - идентификатор (номер) документа

*parent* - номер (ID) родительского документа

*pub_date* - дата публикации дкоумента

*unpub_date* - дата завершения публикации

*createdby* - Идентификатор пользователя создавшего документ

*createdon* - Дата создания документа

~идентификатор~ - URL документа по указанному идентификатору

Дополнительно

*alias* - псевдоним документа

*editedby* - Идентификатор пользователя редактировавшего документ

*editedon* - Дата редактирования документа

*type* - вариант (документ, папка или ссылка)

contentType* - тип содержимого (например, text/html)

*published* - опубликован ли документ (1|0)

*isfolder* - является ли документа папкой (1|0)

*richtext* - используется ли при редактировании документа визуальный редактор

*template* - номер (ID) используемого шаблона для документа

*menuindex* - порядковый номер отображения в меню

*searchable* - доступен ли документ для поиска (1|0)

*cacheable* - Кэшируется ли документ (1|0)

*deleted* - Документ удален (1|0)

*deletedby* - Идентификатор пользователя удалившего документ

*menutitle* - Заголовок меню.

*donthit* - Слежение за количеством посещений отключено (1|0)

*haskeywords* - Документ содержит ключевые слова (1|0)

*hasmetatags* - Документ имеет метатеги (1|0)

*privateweb* - Документ входит в частную группу пользовательских документов (1|0)

*privatemgr* - Документ входит в частную группу менеджерских документов (1|0)

*content_dispo* - Вариант выдачи содержимого (1 - для отображения | 0 - для скачивания)

*hidemenu* - Документ не отображается в меню (1|0)

Назначение полей

Имя параметра - используется для вызова TV-параметра. Можно использовать как английский так и русский язык, а также дефис (-) и знак подчеркивания (_). Пробел использовать нельзя!

Заголовок - используется для обозначения TV-параметра в документе при редактировании.

Описание - используется для более расширенной информации о TV-параметре в документе при редактировании, а также в общем списке TV-параметров.

Тип ввода - определяет вид получаемой информации. В зависимости от выбранного типа интерфейс меняется. Более подробно смотрите Типы ввода TV-параметров.

Значение по умолчанию - определеяет значение TV-параметра по умолчанию при редактировании документа.

Возможные значения - используются в некоторых типах ввода (например Radio Options, Check Box) для предоставления вариантов выбора. Более подробно смотрите Определение значений TV-параметра.

Визуальный компонент - определеяет вариант вывода TV-параметра на страницу сайта. Более подробно смотрите Вид TV-параметра.

Порядок в списке - определяет порядок TV-параметра в документе.

Ограничить доступ к редактированию параметра - если включить флажок, то никто кроме администраторов не сможет редактировать этот TV-параметр.

Типы ввода

  • Text - поле ввода. Поле ввода MODX Evo. Возможные значения не используются. Значение по умолчанию автоматически записывается в поле при первом редактировании.
  • Raw Text, Raw Textarea. Устарели и не рекомендуются к использованию. Вместо них рекомендуется использовать Textarea и Textarea (Mini).
  • Textarea и Textarea (Mini) - текстовое поле. Текстовое поле в MODX Evo. Возможные значения не используются. Значение по умолчанию автоматически записывается в поле при первом редактировании.
  • RichText - поле с визуальным редактором. Визуальный редактор (RichText) в MODX Evo. Возможные значения не используются. Значение по умолчанию автоматически записывается в поле при первом редактировании.
  • DropDown List Menu - раскрывающийся список. Выпадающий список в MODX Evo. Поле Возможные значения задает конечный список значений и определеляется специальным форматом. Более подробно смотрите Определение значений TV-параметра. Значение по умолчанию определяет выбранный пункт при первом редактировании.
  • Listbox (Single-Select) и Listbox (Multi-Select) - список множественного выбора. Список с множественным выбором в MODX Evo
  • Single-Select и Multi-Select отличаются только тем, что в первом варианте можно выбрать одно значение, а во втором несколько (+Ctrl). Поле Возможные значения задает конечный список значений и определеляется специальным форматом. Более подробно смотрите Определение значений TV-параметра. Значение по умолчанию определяет выбранный пункт при первом редактировании.
  • Radio Options - Переключатели (Radio) в MODX Evo. Поле Возможные значения задает конечный список значений и определеляется специальным форматом. Более подробно смотрите Определение значений TV-параметра. Значение по умолчанию определяет выбранный пункт при первом редактировании.
  • Check Box - флажки. Переключатели (checkbox) в MODX Evo. Поле Возможные значения задает конечный список значений и определеляется специальным форматом. Более подробно смотрите Определение значений TV-параметра. Значение по умолчанию определяет выбранный пункт при первом редактировании.
  • Image - изображение. Выбор изображения в MODX Evo. При нажатии кнопки Вставить открывается файловый менеджер, который позволяет выбрать необходимое изображение и загрузить его при необходимости. Возможные значения не используются. Значение по умолчанию автоматически записывается в поле при первом редактировании.
  • File - Выбор файла в MODX Evo. При нажатии кнопки Вставить открывается файловый менеджер, который позволяет выбрать необходимый файл и загрузить его при необходимости. Возможные значения не используются. Значение по умолчанию автоматически записывается в поле при первом редактировании.
  • URL - ссылка. Ссылка - TV-параметр в MODX Evo. Возможные значения не используются. Значение по умолчанию автоматически записывается в поле при первом редактировании.
  • Email - Email - TV-параметр в MODX Evo. Возможные значения не используются. Значение по умолчанию автоматически записывается в поле при первом редактировании.
  • Number - число. Число - TV-параметр в MODX Evo. Возможные значения не используются. Значение по умолчанию автоматически записывается в поле при первом редактировании.
  • Date - Дата - TV-параметр в MODX Evo. Первая кнопка вызывает календарик, с помощью которого можно выбрать дату. Вторая кнопка стирает дату. Возможные значения не используются. Значение по умолчанию автоматически записывается в поле при первом редактировании.