Параметры getImageList MIGX
Дополненный перевод официальной документации: Документация MIGx
Плейсхолдеры getImageList
[[+fieldname]]
— любое поле из конфигурации MIGX или из переданных параметров в сниппет[[+idx]]
— порядковый номер, начиная с 1[[+_first]]
— вернет 1, если это первая запись[[+_last]]
— вернет 1, если это последняя запись[[+_alt]]
— вернет 1, если это четная запись[[+total]]
— общее число элементов (можно изменить через &totalVar)-
[[+property.name]]
— выведет параметр с именем &name=`` в вызове getImageList. Например, при вызове:[[getImageList? &tvname=`slider` &tpl=`@CODE: [[+image]]`]]
[[+property.tvname]]
будет иметь значение «slider».
Параметры getImageList
- &tvname — название TV с типом ввода MIGX
- &tpl — имя чанка для вывода каждой записи. Можно использовать @CODE:, @FILE:, @FIELD
- &docid — можно указать ID документа, чей TV надо обработать. По умолчанию: [[*id]]
- &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` создаст плейсхолдеры: [[+item.1]], [[+item.2]] и т.д.
- &outputSeparator — разделитель между результатами
- &wrapperTpl — чанк-обертка для вывода результатов. Принимает плейсхолдер [[+output]] для вывода результатов
- &processTVs — включить режим обработки вывода TV параметров (для полей с inputTV). По умолчанию: 1
Выбор шаблона для каждого результата
Для каждой записи можно использовать свой шаблон вывода. Для этого в конфигурации MIGX TV указываем поле для выбора шаблона, например:
{
"field": "chunk",
"caption": "Чанк для вывода",
"inputTVtype": "listbox",
"inputOptionValues": "Вывод 1==migx_tpl_1||Вывод 2==migx_tpl_2"
}
Далее, создать чанки для вывода: migx_tpl_1, migx_tpl_2. Чтобы не создавать чанки, можно использовать @CODE: и @FILE: (как для параметра &tpl). И потом вызвать getImageList со следующими параметрами:
[[getImageList?
&tvname=`myMIGXtv`
&tpl=`@FIELD:chunk`
]]