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

Плейсхолдеры 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`
]]
Кирилл
39 42063
getImageList, MIGX