В этой статье мы разберемся что такое getResources MODx Revolution, выясним, какие у него параметры, вывод и сортировка - с примерами и пояснениями. Приятного чтения.

Что такое getResourses

Возвращает список используемых ресурсов (общее), играет роль фрагмента обобщения.

Проще говоря - позволяющий извлекать и выводить содержание полей других ресурсов в любом месте и виде.

Как использовать

Сниппет getResources может быть вызван через тег:

[[getResources]]

До версии 1.6.1-pl вызовы без указанного свойства &tpl будут выводить массив каждого ресурса в результирующем наборе (списке) и его полей. Начиная с версии 1.6.1-pl поведение изменилось, и вам придется использовать "&debug=`1`" для получения полного ответа. Пример:

[[getResources? &debug=`1`]]

[[getResources? &parents=`choose_an_id` &debug=`1`]]

Параметры

  • tpl - имя чанка, который выступает как шаблон ресурсов. В случае если шаблон не найден, данные будут выводиться в виде массива.
  • tplOdd - имя чанка, который выступает как шаблон с нечетным индексом.
  • tplFirst - имя чанка, который выступает как шаблон для первого ресурса.
  • tplLast - имя чанка, который выступает как шаблон для заключительного ресурса.
  • tpl_N -имя чанка, который выступает как шаблон для N-ного ресурса.
  • tpl_nN - имя чанка, который выступает как шаблон для каждого N-ного ресурса.
  • tplPath - каталог для просмотра чанков на базе файлов с использованием @FILE (по умолчанию assets_path + "elements/chunks/").
  • tplWrapper - название чанка serving как обвёртка шаблона для вывода (не работает с toSeparatePlaceholders. Плейсхолдер, где элементы вставлены - [[+output]]).
  • wrapIfEmpty - если истинна, будет выводить обвёртку указанную в &tplWrapper даже если вывод пуст.
  • outputSeparator - доп строка для разделения каждого шаблона.
  • toPlaceholder - если установлен, присвоит результат в этот плейсхолдер вместо вывода напрямую.
  • toSeparatePlaceholders - если установлен, присвоит каждый результат разделяющему плейсхолдеру названного с помощью суффикса из значения данного параметра и номера (начиная с нуля).

Свойства

  • Parents - список ID родительских ресурсов, разделенные запятыми. Для исключения родительских ресурсов используется ID ресурса со знаком минус. (по умолчанию ID текущего ресурса).
  • Resources - список ID ресурсов, разделенные запятыми, которые должны включены в результат выборки. ID ресурса, который имеет префикс со знаком минус, исключаются из результата выборки.
  • Depth - целочисленное значение, которое указывает глубину поиска ресурсов от родительского элемента (по умолчанию 10).
  • tvFilters - может применяться для фильтрации ресурсов по конкретным значениям TV. (mytv==somevalue, othertv==othervalue).
  • Sortby - может применяться для сортировки ресурсов по конкретным полям. (&sortby=`{"publishedon":"ASC", "createdon":"DESC"}`, по умолчанию createdon).
  • sortbyAlias - сортировка по алиасу.
  • sortbyTV - сортировка по TV параметру.
  • limit - лимит выводимых ресурсов. Используйте 0 для снятия ограничения (по умолчанию 5).