Параметры getImageList MIGX

Кирилл 47.2K просмотров

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

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

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

Параметры getImageList

Параметр По умолчанию Описание
tvname   название TV с типом ввода MIGX
tpl [[*id]] имя чанка для вывода каждой записи. Можно использовать @CODE:, @FILE:, @FIELD
docid   можно указать ID документа, чей TV надо обработать
value   JSON строка для обработки getImageList. Если указан, параметры docid и tvname будут проигнорированы. Можно использовать для вывода в getImageList еще одного вызова getImageList
limit 0 количество записей для вывода
offset 0 количество записей, которые необходимо пропустить
totalVar total имя плейсхолдера, в котором содержится общее количество записей
randomize 0 если установить 1, результаты будут отсортированы в случайном порядке
preselectLimit 5 вместе с параметров &randomize можно указать число записей, которые выведутся в любом случае
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 1 включить режим обработки вывода TV параметров (для полей с inputTV)

Для каждой записи можно использовать свой шаблон вывода. Для этого в конфигурации 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`
]]
Метки getImageList MIGX

Обсудим ваш проект?

Расскажите о задаче — вернёмся с планом работ и оценкой сроков. Обычно отвечаем в ближайшее время.

Сначала посмотреть кейсы