|
1 | | -###Использование параметра |
| 1 | +TV-параметр в MODx - элемент (поле), который содержит определенную информацию для текущей страницы. |
2 | 2 |
|
3 | | -*Параметр в MODx - элемент, который содержит определенную информацию для текущей страницы. Их можно непосредственно вывести на страницу или передать сниппету в качестве параметра.* |
| 3 | +TV-параметры позволяют добавить к документу дополнительную информацию, которую затем можно использовать наравне с основными параметрами. Они имеют различные типы и в зависимости от этого меняется их поведение и внешний вид. Значение параметра можно вывести на страницу или передать сниппету для дальнейшей обработки. |
4 | 4 |
|
5 | | -Все параметры можно разделить на основные, TV-параметры и системные. |
| 5 | +#### Для чего нужен TV-параметр? |
6 | 6 |
|
7 | | -####Пример параметра: |
| 7 | +Для упорядочненного и логичного хранения информации на сайте. Допустим, на сайте есть 2 типа материалов - товары и новости. Для товара можно создать параметры, в одном из которых будет храниться цена, а в другом фотография. А для новостей - теги и сюжет. |
| 8 | +Зачастую TV-параметры используются для создания SEO-полей наподобие meta description, keywords и т.д. |
| 9 | +Параметры привязываются к шаблонам, и это позоляет в зависимости от типа материала задавать абсолютно разные для заполнения поля. |
8 | 10 |
|
9 | | -*[\*pagetitle\*]* - Это основной параметр который вернет нам заголовок страницы. Чаще всего он используется для вывода title у страницы: |
| 11 | +### Пример параметра: |
10 | 12 |
|
11 | | - <head> |
12 | | - <title>[*pagetitle*]</title> |
13 | | - </head> |
| 13 | +[\*pagetitle\*] - вызов параметра в шаблоне, который вернет заголовок страницы. Чаще всего он используется для вывода title: |
| 14 | +``` |
| 15 | +<head> |
| 16 | +<title>[*pagetitle*]</title> |
| 17 | +</head> |
| 18 | +``` |
14 | 19 |
|
15 | | -####Основные параметры: |
| 20 | +Все параметры можно разделить на основные, системные и пользовательские. |
16 | 21 |
|
17 | | -Список основных параметров заранее определен и содержит основную информацию о документе. |
| 22 | +### Основные параметры: |
18 | 23 |
|
19 | | -#####Наиболее используемые: |
| 24 | +Список основных параметров заранее определен в cms и содержит основную информацию о документе. Большую часть из них можете увидеть при создании и редактировании любого документа. |
20 | 25 |
|
21 | | -*[\*pagetitle\*]* - заголовок документа |
22 | | -*[\*longtitle\*]* - расширенный заголовок документа |
23 | | -*[\*description\*]* - описание документа |
24 | | -*[\*introtext\*]* - аннотация документа |
25 | | -*[\*content\*]* - содержимое документа |
26 | | -*[\*id\*]* - идентификатор (номер) документа |
27 | | -*[\*parent\*]* - номер (ID) родительского документа |
28 | | -*[\*pub_date\*]* - дата публикации дкоумента |
29 | | -*[\*unpub_date\*]* - дата завершения публикации |
30 | | -*[\*createdby\*]* - Идентификатор пользователя создавшего документ |
31 | | -*[\*createdon\*]* - Дата создания документа |
| 26 | +#### Наиболее используемые: |
32 | 27 |
|
33 | | -*[~идентификатор~]* - URL документа по указанному идентификатору |
| 28 | +- **[\*pagetitle\*]** - заголовок документа |
| 29 | +- **[\*longtitle\*]** - расширенный заголовок документа |
| 30 | +- **[\*description\*]** - описание документа |
| 31 | +- **[\*introtext\*]** - аннотация документа |
| 32 | +- **[\*content\*]** - содержимое документа |
| 33 | +- **[\*id\*]** - идентификатор (номер) документа |
| 34 | +- **[\*parent\*]** - номер (ID) родительского документа |
| 35 | +- **[\*pub_date\*]** - дата публикации дкоумента |
| 36 | +- **[\*unpub_date\*]** - дата завершения публикации |
| 37 | +- **[\*createdby\*]** - Идентификатор пользователя создавшего документ |
| 38 | +- **[\*createdon\*]** - Дата создания документа |
| 39 | +- **[\~идентификатор\~]** - URL документа по указанному идентификатору |
34 | 40 |
|
35 | | -*Стоит отдельно упомянуть о том, что параметры можно сочетать. В особенности это актиально для создания ссылок на разные документы с помощью параметра **[~идентификатор~]**. В качестве идентификатора можно также задать параметр.* |
| 41 | +Стоит отдельно упомянуть о том, что параметры можно сочетать. В особенности это актуально для создания ссылок на разные документы с помощью параметра **[\~идентификатор\~]**. В качестве идентификатора можно также задать параметр. |
36 | 42 |
|
37 | | -*[~[\*id\*]~]* -Вывести ссылку на текущий документ. |
| 43 | +**[~[\*id\*]~]** -Вывести ссылку на текущий документ. |
38 | 44 |
|
39 | | -*[~[\*parent\*]~]* - Вывести ссылку на родителя текущего документа. |
| 45 | +**[~[\*parent\*]~]** - Вывести ссылку на родителя текущего документа. |
40 | 46 |
|
41 | | -#####Дополнительно |
| 47 | +#### Дополнительные |
42 | 48 |
|
43 | | -*[\*alias\*]* - псевдоним документа |
44 | | -*[\*editedby\*]* - Идентификатор пользователя редактировавшего документ |
45 | | -*[\*editedon\*]* - Дата редактирования документа |
46 | | -*[\*type\*]* - вариант (документ, папка или ссылка) |
47 | | -*[\*contentType\*]* - тип содержимого (например, text/html) |
48 | | -*[\*published\*]* - опубликован ли документ (1|0) |
49 | | -*[\*isfolder\*]* - является ли документа папкой (1|0) |
50 | | -*[\*richtext\*]* - используется ли при редактировании документа визуальный редактор |
51 | | -*[\*template\*]* - номер (ID) используемого шаблона для документа |
52 | | -*[\*menuindex\*]* - порядковый номер отображения в меню |
53 | | -*[\*searchable\*]* - доступен ли документ для поиска (1|0) |
54 | | -*[\*cacheable\*]* - Кэшируется ли документ (1|0) |
55 | | -*[\*deleted\*]* - Документ удален (1|0) |
56 | | -*[\*deletedby\*]* - Идентификатор пользователя удалившего документ |
57 | | -*[\*menutitle\*]* - Заголовок меню. |
58 | | -*[\*donthit\*]* - Слежение за количеством посещений отключено (1|0) |
59 | | -*[\*haskeywords\*]* - Документ содержит ключевые слова (1|0) |
60 | | -*[\*hasmetatags\*]* - Документ имеет метатеги (1|0) |
61 | | -*[\*privateweb\*]* - Документ входит в частную группу пользовательских документов (1|0) |
62 | | -*[\*privatemgr\*]* - Документ входит в частную группу менеджерских документов (1|0) |
63 | | -*[\*content_dispo\*]* - Вариант выдачи содержимого (1 - для отображения | 0 - для скачивания) |
64 | | -*[\*hidemenu\*]* - Документ не отображается в меню (1|0) |
65 | | -*[\*alias_visible\*]* - Учавствует в URL(1|0) |
| 49 | +- **[\*alias\*]** - псевдоним документа |
| 50 | +- **[\*editedby\*]** - идентификатор пользователя редактировавшего документ |
| 51 | +- **[\*editedon\*]** - дата редактирования документа |
| 52 | +- **[\*type\*]** - тип ресурса (документ, папка или ссылка) |
| 53 | +- **[\*contentType\*]** - тип содержимого (например, text/html) |
| 54 | +- **[\*published\*]** - опубликован ли документ (1|0) |
| 55 | +- **[\*isfolder\*]** - является ли документа папкой (1|0) |
| 56 | +- **[\*richtext\*]** - используется ли при редактировании документа визуальный редактор |
| 57 | +- **[\*template\*]** - номер (ID) используемого шаблона для документа |
| 58 | +- **[\*menuindex\*]** - порядковый номер отображения в меню |
| 59 | +- **[\*searchable\*]** - доступен ли документ для поиска (1|0) |
| 60 | +- **[\*cacheable\*]** - Кэшируется ли документ (1|0) |
| 61 | +- **[\*deleted\*]** - документ удален (1|0) |
| 62 | +- **[\*deletedby\*]** - идентификатор пользователя удалившего документ |
| 63 | +- **[\*menutitle\*]** - заголовок меню. |
| 64 | +- **[\*donthit\*]** - Слежение за количеством посещений отключено (1|0) |
| 65 | +- **[\*haskeywords\*]** - Документ содержит ключевые слова (1|0) |
| 66 | +- **[\*hasmetatags\*]** - Документ имеет метатеги (1|0) |
| 67 | +- **[\*privateweb\*]** - Документ входит в частную группу пользовательских документов (1|0) |
| 68 | +- **[\*privatemgr\*]** - Документ входит в частную группу менеджерских документов (1|0) |
| 69 | +- **[\*content_dispo\*]** - Вариант выдачи содержимого (1 - для отображения | 0 - для скачивания) |
| 70 | +- **[\*hidemenu\*]** - Документ не отображается в меню (1|0) |
| 71 | +- **[\*alias_visible\*]** - Участвует ли документ в формировании URL(1|0) |
66 | 72 |
|
67 | | -####TV-параметры |
| 73 | +### Системные параметры |
68 | 74 |
|
69 | | -TV-параметры позволяют добавить к документу дополнительную информацию, которую затем можно использовать на равне с основными параметрами. Также TV-параметры имеют различные типы и в зависимости от этого меняется их управление и представление. |
| 75 | +Параметры, которые отображают системые данные |
70 | 76 |
|
71 | | -####Пример параметра: |
| 77 | +- **[^qt^]** - время на запросы к базе данных |
| 78 | +- **[^q^]** - запросов к базе данных |
| 79 | +- **[^p^]** - время на работу PHP скриптов |
| 80 | +- **[^t^]** - общее время на генерацию страницы |
| 81 | +- **[^s^]** - источник содержимого (база или кэш) |
| 82 | +- **[^m^]** - количество потребляемой памяти |
72 | 83 |
|
73 | | -[*МойПараметр*] |
74 | | -Создание и редактирование TV-параметра |
| 84 | +#### Пример: |
75 | 85 |
|
76 | | -Все чанки находятся в следующем месте: |
| 86 | +``` |
| 87 | +Memory : [^m^], |
| 88 | +MySQL: [^qt^], [^q^] request(s), |
| 89 | +PHP: [^p^], |
| 90 | +Total time: [^t^], |
| 91 | +Document from [^s^]. |
| 92 | +``` |
77 | 93 |
|
78 | | -Ресурсы → Управление ресурсами → Параметры (TV) |
79 | | -Список TV-параметров выглядит примерно так: |
| 94 | +### Пользовательские TV-параметры |
80 | 95 |
|
81 | | -Список TV-параметров в MODX EVO |
| 96 | +Пользовательские параметры создаются программистом вручную исходя из опыта и структуры документа. |
| 97 | + |
| 98 | +#### Создание и редактирование TV-параметра |
| 99 | + |
| 100 | +Для создания параметра необходимо нажать на ссылку "Элементы - Параметры (TV)" и выбрать "Новый параметр (TV)". |
82 | 101 |
|
83 | | -Для создания необходимо нажать на ссылку Новый параметр (TV), а для редактирования существующего TV-параметра достаточно нажать на ссылку с его названием. Появится следующая форма: |
84 | 102 |
|
85 | | -Создание TV-параметра в MODX EVO |
86 | 103 |
|
87 | 104 | Назначение полей |
88 | 105 |
|
|
0 commit comments