multiTV 2.0 Пользовательская переменная шаблона

Есть две возможности установить multiTV в MODX Evolution

• Используйте Менеджер Пакетов и установите последний пакет multiTV
• Или установите вручную:
  1. Загрузите папку assets/tvs/multitv в соответствующую папку в вашей установке.
  2. Создайте новый шаблон и переменную с типом ввода custom input (если имя этой переменной будет multidemo то будет использоваться файл конфигурации multidemo)
  3. Вставьте следующий код в возможные значения @INCLUDE/assets/tvs/multitv/multitv.customtv.php
  4. Создайте новый сниппет с названием multiTV и поместите в него следующий кода <?php return include(MODX_BASE_PATH.'assets/tvs/multitv/multitv.snippet.php'); ?>

Совместимость

1. Если вы хотите использовать multiTV с ManagerManager до версии MODX 1.0.9 вы должны исправить файл mm.inc.php и вставить case 'custom_tv': в 136 строке перед строкой $t = 'textarea';
2. Если вы хотите использовать multiTV с YAMS, вы должны исправить yams.plugin.inc.php согласно этой инструкции.
3. Если вы обновляете 1.4.10 и ниже можно установить сниппет updateTV и изменить данные в вашей переменной multiTV в новый формат. Это необходимо, если вы хотите добавить/удалить столбцы в multiTV или если вы хотите отсортировать результаты по столбцу.
4. Если вы хотите использовать PHx с multiTV необходимо немного изменить код плагина PHx:

if (!class_exists('PHxParser')) {
    include MODX_BASE_PATH . "assets/plugins/phx/phx.parser.class.inc.php";
}
$e = &$modx->Event;
switch($e->name) {
    case 'OnParseDocument':
        $PHx = new PHxParser($phxdebug,$phxmaxpass);
        $PHx->OnParseDocument();
        break;
}

Все параметры задаются в конфигурационном файле в папке configs с тем же именем, как и переменная шаблона в виде PHP-массива .config.inc.php или JSON файла .config.json (файл JSON имеет приоритет перед PHP-массивом).

Параметр display

Отображение полей ввода настраивается с помощью параметра display

• horizontal - горизонтальное расположение (пример event.config.inc.php)
• vertical - вертикальное расположение (пример images.config.inc.php)
• single - содержит только один элемент
• datatable - пример links.config.inc.php или multicontent.config.inc.php
• dbtable - пример dbtabledemo.config.json

Параметр fields

Поля ввода одного элемента списка определяются в параметре fields

Эта переменная содержит массив имен полей и каждое имя поля содержит массив свойств поля.

Поддерживаемые типы полей: text, rawtext, email, number, textareamini, textarea, rawtextarea, htmlarea, date, dropdown, listbox, listbox-multiple, checkbox, option, image, file

Параметр columns

В режимах datatable и dbtable могут быть определены в качестве ключа параметры columns. Этот ключ содержит массив параметров столбцов. Каждый столбец содержит массив свойств. Если свойство не задано, в качестве ключа используется fields.

Редактирование слоев

В режимах datatable и dbtable редактирование содержимого слоя может быть определено в ключе form. Этот ключ содержит массив параметров вкладки form.

Each form tab setting contains an associative array of field properties (the key contains the fieldname in fields). If a field property is not set, the field property in fields is used.

Шаблоны по умолчанию

Шаблоны для сниппета multiTV используемые по умолчанию, могут быть определены в параметре templates

Другие опции

Другие опции могут быть определены в параметре configuration

Смотрите файл конфигурации для TV-параметра multidemo для всех используемых вертикальных настроек и multicontent для всех используемых datatable настроек.

Сниппет multiTV отображает содержимое переменной multiTV. Разместите примерно такой вызов сниппета. Параметр &tvName обязателен. Остальные параметры в случае если используются значения по умолчанию, могут быть удалены.

[!multiTV?
&tvName=`yourMultiTVname`
&docid=`[*id*]`
&tplConfig=``
&outerTpl=`@CODE:<ul>((wrapper))</ul>`
&rowTpl=`@CODE:<li>((event)), ((location)), ((price))</li>`
&display=`5`
&offset=`0`
&rows=`all`
&randomize=`0`
&reverse=`0`
&orderBy=``
&toPlaceholder=``
&toJson=`0`
&published=`1`
&emptyOutput=`1`
&noResults=``
&outputSeparator=``
&firstClass=`first`
&lastClass=`last`
&evenClass=``
&oddClass=``
&paginate=`0`
&offsetKey=`page`
!]

Параметры

По умолчанию шаблоны для внешнего блока и строки могут быть определены в файле конфигурации. Эти шаблоны могут быть перезаписаны параметрами rowTpl и outerTpl в вызове сниппета.

&tvName=`yourMultiTVname`

&docid=``

&tplConfig=``

&outerTpl=``

&rowTpl=``

&display=`all`

&offset=`5`

&rows=`1,2`

&randomize=`1`

&reverse=`1`

&orderBy=``

&toPlaceholder=`myPlaceholder`

&toJson=`1`

&published=`2`

&emptyOutput=`0`

&noResults=`noResults`

&outputSeparator=``

&firstClass=``

&lastClass=``

&evenClass=`even`

&oddClass=`odd`

&paginate=`1`

&offsetKey=``

Плейсхолдеры rowTpl

Плейсхолдеры outerTpl

PHx модификатор

[+phx:multitvisempty=`tvname|docid`:then=`xxx`:else=`yyy`+]

[+phx:multitvisnotempty=`tvname|docid`:then=`xxx`:else=`yyy`+]

multiTvFilter экстендер Ditto

[[Ditto?
&parents=`3,4,5`
&display=`all`
&tpl=`...`
&extenders=`@FILE assets/tvs/multitv/dittoExtender/multitvfilter.extender.inc.php`
&multiTvFilterBy=`event`
&multiTvFilterOptions=`[{"name":"title","type":"text","value":"Important","mode":"contains"}]`
]]

[[Ditto?
&parents=`3,4,5`
&display=`all`
&tpl=`...`
&extenders=`@FILE assets/tvs/multitv/dittoExtender/multitvfilter.extender.inc.php`
&multiTvFilterBy=`event,event`
&multiTvFilterOptions=`[{"name":"title","type":"text","value":"Important","mode":"contains"},{"name":"location","type":"text","value":"Outdoor","mode":"allisnot","conjunction":"OR"}]`
]]

Обновление на новый формат данных

[!updateTV?
&tvNames=`yourMultiTVname1,yourMultiTVname2`
!]