Правки ТВ

Author: 0test

ru/02_Разработка/01_TV-параметры/index.md

@@ -5,6 +5,7 @@ TV-параметры позволяют добавить к документу
 #### Для чего нужен TV-параметр?
 
 Для упорядочненного и логичного хранения информации на сайте. Допустим, на сайте есть 2 типа материалов - товары и новости. Для товара можно создать параметры, в одном из которых будет храниться цена, а в другом фотография. А для новостей - теги и сюжет.
+
 Зачастую TV-параметры используются для создания SEO-полей наподобие meta description, keywords и т.д.
 Параметры привязываются к шаблонам, и это позоляет в зависимости от типа материала задавать абсолютно разные для заполнения поля.
 
@@ -40,14 +41,14 @@ TV-параметры позволяют добавить к документу
 
 Стоит отдельно упомянуть о том, что параметры можно сочетать. В особенности это актуально для создания ссылок на разные документы с помощью параметра **[\~идентификатор\~]**. В качестве идентификатора можно также задать параметр.
 
-**[~[\*id\*]~]** -Вывести ссылку на текущий документ.
+**[\~[\*id\*]\~]** -Вывести ссылку на текущий документ.
 
-**[~[\*parent\*]~]** - Вывести ссылку на родителя текущего документа.
+**[\~[\*parent\*]\~]** - Вывести ссылку на родителя текущего документа.
 
 #### Дополнительные
 
 - **[\*alias\*]** - псевдоним документа
-- **[\*editedby\*]** - идентификатор пользователя редактировавшего документ
+- **[\*editedby\*]** - идентификатор пользователя, редактировавшего документ
 - **[\*editedon\*]** - дата редактирования документа
 - **[\*type\*]** - тип ресурса (документ, папка или ссылка)
 - **[\*contentType\*]** - тип содержимого (например, text/html)
@@ -72,7 +73,7 @@ TV-параметры позволяют добавить к документу
 
 ### Системные параметры
 
-Параметры, которые отображают системые данные
+Параметры, которые отображают системные данные
 
 - **[^qt^]** - время на запросы к базе данных
 - **[^q^]** - запросов к базе данных
@@ -93,150 +94,93 @@ Document from [^s^].
 
 ### Пользовательские TV-параметры
 
-Пользовательские параметры создаются программистом вручную исходя из опыта и структуры документа.
+Пользовательские параметры создаются программистом вручную, исходя из опыта и структуры сайта.
 
 #### Создание и редактирование TV-параметра
 
 Для создания параметра необходимо нажать на ссылку "Элементы - Параметры (TV)" и выбрать "Новый параметр (TV)".
 
+![пример](https://raw.githubusercontent.com/0test/docs/master/ru/02_Разработка/01_TV-параметры/tv_create.png)
 
+#### Назначение полей
 
-Назначение полей
-
-Имя параметра - используется для вызова TV-параметра. Можно использовать как английский так и русский язык, а также дефис (-) и знак подчеркивания (_). Пробел использовать нельзя!
-
-Заголовок - используется для обозначения TV-параметра в документе при редактировании.
-
-Описание - используется для более расширенной информации о TV-параметре в документе при редактировании, а также в общем списке TV-параметров.
-
-Тип ввода - определяет вид получаемой информации. В зависимости от выбранного типа интерфейс меняется. Более подробно смотрите Типы ввода TV-параметров.
-
-Значение по умолчанию - определеяет значение TV-параметра по умолчанию при редактировании документа.
-
-Возможные значения - используются в некоторых типах ввода (например Radio Options, Check Box) для предоставления вариантов выбора. Более подробно смотрите Определение значений TV-параметра.
-
-Визуальный компонент - определеяет вариант вывода TV-параметра на страницу сайта. Более подробно смотрите Вид TV-параметра.
+- **Имя параметра** - используется для вызова TV-параметра. Можно использовать как английский так и русский язык, а также дефис и знак подчеркивания. Пробел использовать нельзя!
+- **Заголовок** - используется для названия TV-параметра в документе при редактировании.
+- **Описание** - используется для более расширенной информации о параметре в документе при редактировании, а также в общем списке TV-параметров.
+- **Тип ввода** - определяет вид получаемой информации. В зависимости от выбранного типа интерфейс меняется. Более подробно смотрите "Типы ввода".
+- **Значение по умолчанию** - определеяет значение TV-параметра по умолчанию при редактировании документа.
+- **Возможные значения** - используются в некоторых типах ввода (например Radio Options, Check Box) для предоставления вариантов выбора. Более подробно смотрите Определение значений TV-параметра.
+- **Визуальный компонент** - определеяет вариант вывода TV-параметра на страницу сайта. Более подробно смотрите Вид TV-параметра.
+- **Порядок в списке** - определяет порядок TV-параметра в документе.
+- **"Замок" в имени параметра** - если включить флажок, то никто, кроме администраторов не сможет редактировать этот TV-параметр.
 
-Порядок в списке - определяет порядок TV-параметра в документе.
-
-Ограничить доступ к редактированию параметра - если включить флажок, то никто кроме администраторов не сможет редактировать этот TV-параметр.
-
-Типы ввода
-
-Text - поле ввода
-
-Поле ввода MODX EVO
+#### Типы ввода ####
 
+- **Text** - поле ввода.
 Возможные значения не используются. Значение по умолчанию автоматически записывается в поле при первом редактировании.
 
-Raw Text, Raw Textarea
+- **Raw Text, Raw Textarea** - устарели и не рекомендуются к использованию. 
+Вместо них рекомендуется использовать Textarea и Textarea (Mini).
 
-Устарели и не рекомендуются к использованию. Вместо них рекомендуется использовать Textarea и Textarea (Mini).
-
-Textarea и Textarea (Mini) - текстовое поле
-
-Текстовое поле в MODX EVO
+- **Textarea и Textarea (Mini)** - текстовое поле. Возможные значения не используются. Значение по умолчанию автоматически записывается в поле при первом редактировании.
 
+- **RichText** - поле с визуальным редактором.
 Возможные значения не используются. Значение по умолчанию автоматически записывается в поле при первом редактировании.
 
-RichText - поле с визуальным редактором
-
-Визуальный редактор (RichText) в MODX EVO
-
-Возможные значения не используются. Значение по умолчанию автоматически записывается в поле при первом редактировании.
-
-DropDown List Menu - раскрывающийся список
-
-Выпадающий список в MODX EVO
-
-Поле Возможные значения задает конечный список значений и определеляется специальным форматом. Более подробно смотрите Определение значений TV-параметра. Значение по умолчанию определяет выбранный пункт при первом редактировании.
-
-Listbox (Single-Select) и Listbox (Multi-Select) - список множественного выбора
-
-Список с множественным выбором в MODX EVO
+- **DropDown List Menu** - раскрывающийся список.
+Поле "Возможные значения" задает список значений и определеляется специальным форматом. Более подробно смотрите Определение значений TV-параметра. Значение по-умолчанию определяет выбранный пункт при первом редактировании.
 
+- **Listbox (Single-Select) и Listbox (Multi-Select)** - список множественного выбора.
 Single-Select и Multi-Select отличаются только тем, что в первом варианте можно выбрать одно значение, а во втором несколько (с использование Ctrl).
+Поле "Возможные значения" задает конечный список значений и определеляется специальным форматом. Более подробно смотрите Определение значений TV-параметра. Значение по умолчанию определяет выбранный пункт при первом редактировании.
 
+- **Radio Options** - переключатели.
 Поле Возможные значения задает конечный список значений и определеляется специальным форматом. Более подробно смотрите Определение значений TV-параметра. Значение по умолчанию определяет выбранный пункт при первом редактировании.
 
-Radio Options - переключатели
-
-Переключатели (Radio) в MODX EVO
-
-Поле Возможные значения задает конечный список значений и определеляется специальным форматом. Более подробно смотрите Определение значений TV-параметра. Значение по умолчанию определяет выбранный пункт при первом редактировании.
-
-Check Box - флажки
-
-Переключатели (checkbox) в MODX EVO
-
+- **Check Box** - флажки.
 Поле Возможные значения задает конечный список значений и определеляется специальным форматом. Более подробно смотрите Определение значений TV-параметра. Значение по умолчанию определяет выбранный пункт при первом редактировании.
 
-Image - изображение
-
-Выбор изображения в MODX EVO
-
-При нажатии кнопки Вставить открывается файловый менеджер, который позволяет выбрать необходимое изображение и загрузить его при необходимости.
-
+- **Image** - изображение.
+При нажатии кнопки "Вставить" открывается файловый менеджер, который позволяет выбрать необходимое изображение и загрузить его.
 Возможные значения не используются. Значение по умолчанию автоматически записывается в поле при первом редактировании. 
 
-File - файл
-
-Выбор файла в MODX EVO
-
-При нажатии кнопки Вставить открывается файловый менеджер, который позволяет выбрать необходимый файл и загрузить его при необходимости.
-
+- **File** - файл.
+При нажатии кнопки "Вставить" открывается файловый менеджер, который позволяет выбрать необходимый файл и загрузить его.
 Возможные значения не используются. Значение по умолчанию автоматически записывается в поле при первом редактировании.
 
-URL - ссылка
-
-Ссылка - TV-параметр в MODX EVO
-
+- **URL** - ссылка.
 Возможные значения не используются. Значение по умолчанию автоматически записывается в поле при первом редактировании.
 
-Email - электронная почта
-
-Email - TV-параметр в MODX EVO
-
+- **Email** - электронная почта.
 Возможные значения не используются. Значение по умолчанию автоматически записывается в поле при первом редактировании.
 
-Number - число
-
-Число - TV-параметр в MODX EVO
-
+- **Number** - число.
 Возможные значения не используются. Значение по умолчанию автоматически записывается в поле при первом редактировании.
 
-Date - дата
-
-Дата - TV-параметр в MODX EVO
-
+- **Date** - дата.
 Первая кнопка вызывает календарик, с помощью которого можно выбрать дату. Вторая кнопка стирает дату.
-
 Возможные значения не используются. Значение по умолчанию автоматически записывается в поле при первом редактировании.
 
-Определение значений TV-параметра
+#### Определение значений TV-параметра ####
 
-Настройка Возможные значения определяются возможные варианты для таких параметров как DropDown List Menu, Listbox,Check Box и Radio Options.
+Настройкой "Возможные значения" определяются варианты для таких параметров как DropDown List Menu, Listbox,Check Box и Radio Options.
 
 Формат определения значений следующий:
-
+```
 параметр1==значение1||параметр2==значение2||параметр3==значение3
+```
 Разделитель "==" используется для разделения отображаемого и фактического значения, а разделитель "||" разделяет значения между собой.
 
 Если фактические и отображаемые значения совпадают, то можно использовать упрощенный вариант записи:
-
+```
 значение1||значение2||значение3
-
-####Пример
+```
+#### Пример ####
 
 Тип ввода: DropDown List Menu
-
 Возможные значения:
-
+```
 Красный==#FF0000||Зеленый==#00FF00||Синий==#0000FF
-Значения выпадающего список - TV-параметр в MODX EVO
-
-Когда пользователь будет редактировать документ, то он увидит выпадающий список со значениями Красный, Зеленый, Синий. Но при выборе в базу сохранится одно из значений - #FF0000, #00FF00 или #0000FF
-
-Вывод выпадающего списка - TV-параметр в MODX EVO
+```
 
-Если определить возможные значения как Красный||Зеленый||Синий, то выводимое значение будет совпадать с сохраняемым.
+Когда пользователь будет редактировать документ, то увидит выпадающий список со значениями "Красный, Зеленый, Синий". При выборе значения и сохранения документа в базу сохранится одно из значений - #FF0000, #00FF00 или #0000FF.