Параметры getImageList MIGX

Дополненный перевод официальной документации: MIGX.Frontend-Usage

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

- любое поле из конфигурации MIGX или из переданных параметров в сниппет
- порядковый номер, начиная с 1
- вернет 1, если это первая запись
- вернет 1, если это последняя запись
- вернет 1, если это четная запись
- общее число элементов (можно изменить через &totalVar)
- выведет параметр с именем &name=`` в вызове getImageList. Например, при вызове:
modx
```
[[getImageList? &tvname=`slider` &tpl=`@CODE: [[+image]]`]]
```
плейсхолдер будет иметь значение "slider".

Параметры getImageList

&tvname - название TV с типом ввода MIGX
&tpl - имя чанка для вывода каждой записи. Можно использовать @CODE:, @FILE:, @FIELD
&docid - можно указать ID документа, чей TV надо обработать. По умолчанию: 122
&value - JSON строка для обработки getImageList. Если указан, параметры &docid и &tvname будут проигнорированы. Можно использовать для вывода в getImageList еще одного вызова getImageList
&limit - количество записей для вывода. По умолчанию: 0
&offset - количество записей, которые необходимо пропустить. По умолчанию: 0
&totalVar - имя плейсхолдера, в котором содержится общее количество записей. По умолчанию: total
&randomize - если установить 1, результаты будут отсортированы в случайном порядке. По умолчанию: 0
&preselectLimit - вместе с параметров &randomize можно указать число записей, которые выведутся в любом случае. По умолчанию: 5
&where - JSON строка с условиями выборки, например: { "active:=":"1","rating:>":"5" }
&sort - JSON строка с условиями сортировки. Можно указывать несколько параметров: [{ "sortby":"age","sortdir":"DESC","sortmode":"numeric" } , { "sortby":"name","sortdir":"ASC" }]
&toPlaceholder - сохранить вывод в плейсхолдер
&toSeparatePlaceholders - сохранить каждую запись в отдельный плейсхолдер. Например, &toSeparatePlaceholders=`item` создаст плейсхолдеры: , и т.д.
&outputSeparator - разделитель между результатами
&wrapperTpl - чанк-обертка для вывода результатов. Принимает плейсхолдер для вывода результатов
&processTVs - включить режим обработки вывода TV параметров (для полей с inputTV). По умолчанию: 1

Выбор шаблона для каждого результата

Для каждой записи можно использовать свой шаблон вывода. Для этого в конфигурации MIGX TV указываем поле для выбора шаблона, например:

json

{
    "field": "chunk",
    "caption": "Чанк для вывода",
    "inputTVtype": "listbox",
    "inputOptionValues": "Вывод 1==migx_tpl_1||Вывод 2==migx_tpl_2"
}

Далее, создать чанки для вывода: migx_tpl_1, migx_tpl_2. Чтобы не создавать чанки, можно использовать @CODE: и @FILE: (как для параметра &tpl). И потом вызвать getImageList со следующими параметрами:

modx

[[getImageList?
    &tvname=`myMIGXtv`
    &tpl=`@FIELD:chunk`
]]