Фильтрация по TV в pdoResources. Modx pdoresources
pdoResources / Сниппеты / pdoTools / docs.modx.pro
Сниппет предназначен для вывода списка ресурсов. Является продвинутой заменой для getResources: обладает всеми его возможностями, но лишен недостатков.
Умеет правильно сортировать ТВ параметры, присоединять таблицы при выборке, включать и исключать категории из разных контекстов и еще много чего.
Параметры
Параметры выборки ресурсов
Эти параметры определяют, какие ресурсы появятся в генерируемом списке.
| &parents | Текущий ресурс | Список родителей, через запятую, для поиска результатов. Если поставить 0 - выборка не ограничивается. Если id родителя начинается с дефиса, он и его потомки исключаются из выборки. |
| &depth | 10 | Глубина поиска дочерних ресурсов от родителя. |
| &resources | Список ресурсов, через запятую, для вывода в результатах. Если id ресурса начинается с дефиса, этот ресурс исключается из выборки. | |
| &context | Ограничение выборки по контексту ресурсов. | |
| &where | Массив дополнительных параметров выборки, закодированный в JSON. | |
| &showHidden | 1 | Показывать ресурсы, скрытые в меню. |
| &showUnpublished | 0 | Показывать неопубликованные ресурсы. |
| &showDeleted | 0 | Показывать удалённые ресурсы. |
| &hideContainers | 0 | Отключает вывод контейнеров, то есть, ресурсов с «isfolder = 1». |
| &select | 0 | Список полей для выборки, через запятую. Можно указывать JSON строку с массивом, например {"modResource":"id,pagetitle,content"}. |
| &sortby | pagetitle | Любое поле ресурса для сортировки, включая ТВ параметр, если он указан в параметре &includeTVs. Можно указывать JSON строку с массивом нескольких полей, например {"tvname":"ASC", "pagetitle":"DESC"}. Для случайно сортировки укажите «RAND()» |
| &sortdir | DESC | |
| &limit | 10 | Ограничение количества результатов выборки. Можно использовать «0». |
| &offset | 0 | Пропуск результатов от начала. |
| &first | 1 | Номер первой итерации вывода результатов. |
| &last | Автоматически, по формуле (total + first - 1) | Номер последней итерации вывода результатов. |
| &loadModels | Список компонентов, через запятую, чьи модели нужно загрузить для построения запроса. Например: &loadModels=`ms2gallery,msearch3`. | |
| &tvFilters | Список фильтров по ТВ, с разделителями AND и OR. Разделитель, указанный в параметре &tvFiltersOrDelimiter представляет логическое условие OR и по нему условия группируются в первую очередь. Внутри каждой группы вы можете задать список значений, разделив их &tvFiltersAndDelimiter. Поиск значений может проводиться в каком-то конкретном ТВ, если он указан «myTV==value», или в любом «value». Пример вызова: &tvFilters=`filter2==one,filter1==bar%||filter1==foo`. Обратите внимание: фильтрация использует оператор LIKE и знак «%» является метасимволом. И еще: Поиск идёт по значениям, которые физически находятся в БД, то есть, сюда не подставляются значения по умолчанию из настроек ТВ. | |
| &tvFiltersAndDelimiter | "," | Разделитель для условий AND в параметре &tvFilters. |
| &tvFiltersOrDelimiter | "||" | Разделитель для условий OR в параметре &tvFilters. |
Параметры шаблонов
Эти параметры устанавливают чанки, которые содержат шаблоны для генерации вывода, то есть отвечают за внешний вид.
| &returnIds | Установите значение «1», чтобы вернуть строку со списком id ресурсов, вместо оформленных результатов. Все указанные шаблоны игнорируются. |
| &tpl | Имя чанка для оформления ресурса. Если не указан, то содержимое полей ресурса будет распечатано на экран. |
| &tplFirst | Имя чанка для первого ресурса в результатах. |
| &tplLast | Имя чанка для последнего ресурса в результатах. |
| &tplOdd | Имя чанка для каждого второго ресурса. |
| &tplWrapper | Чанк-обёртка, для заворачивания всех результатов. Понимает один плейсхолдер: [[+output]]. Не работает вместе с параметром &toSeparatePlaceholders. |
| &wrapIfEmpty | Включает вывод чанка-обертки &tplWrapper даже если результатов нет. |
| &tplCondition | Поле ресурса, из которого будет получено значение для выбора чанка по условию в &conditionalTpls. |
| &tplOperator | Необязательный оператор для проведения сравнения поля ресурса в &tplCondition с массивом значений и чанков в &conditionalTpls. |
| &conditionalTpls | JSON строка с массивом, у которого в ключах указано то, с чем будет сравниваться &tplCondition, а в значениях - чанки, которые будут использованы для вывода, если сравнение будет успешно. Оператор сравнения указывается в &tplOperator. Для операторов типа isempty можно использовать массив без ключей. |
| &outputSeparator | Необязательная строка для разделения результатов работы. |
Параметры результатов
Эти параметры дополнительно определяют, какие данные и каким способом будут выводиться.
| &fastMode | 0 | Быстрый режим обработки чанков. Все необработанные теги (условия, сниппеты и т.п.) будут вырезаны. |
| &idx | Вы можете указать стартовый номер итерации вывода результатов. | |
| &totalVar | total | Имя плейсхолдера для сохранения общего количества результатов. |
| &includeContent | 0 | Включаем поле «content» в выборку. |
| &includeTVs | Список ТВ параметров для выборки, через запятую. Например: «action,time» дадут плейсхолдеры [[+tv.action]] и [[+tv.time]]. | |
| &prepareTVs | «1», что означает подготовку всех ТВ, указанных в &includeTVs | Список ТВ параметров, которые нужно подготовить перед выводом. |
| &processTVs | Список ТВ параметров, которые нужно обработать перед выводом. Если установить в «1», будут обработаны все ТВ, указанные в &includeTVs. | |
| &tvPrefix | tv. | Префикс для ТВ параметров. |
| &useWeblinkUrl | Генерировать ссылку с учетом класса ресурса, включает плейсхолдер [[+link]]. | |
| &toPlaceholder | Если не пусто, сниппет сохранит все данные в плейсхолдер с этим именем, вместо вывода не экран. | |
| &toSeparatePlaceholders | Если вы укажете слово в этом параметре, то ВСЕ результаты будут выставлены в разные плейсхолдеры, начинающиеся с этого слова и заканчивающиеся порядковым номером строки, от нуля. Например, указав в параметре «myPl», вы получите плейсхолдеры [[+myPl0]], [[+myPl1]] и т.д. | |
| &showLog | 0 | Показывать дополнительную информацию о работе сниппета. Только для авторизованных в контекте «mgr». |
Примеры
Простейший вывод списка дочерних ресурсов документа с идентификатором 1:
[[pdoResources? &parents=`1` &depth=`0` &tpl=`ListRowTpl` ]]Если используется дополнительное поле image, то вызов изменится следующим образом:
[[pdoResources? &parents=`1` &depth=`0` &tpl=`ListRowTpl` &includeTVs=`image` ]]В чанке ListRowTpl за это поле будет отвечать плейсхолдер [[+tv.image]]
Дополнительная информация
При переносе чанков с getResources, довольно распространённой ошибкой является использование модификатора strtotime, для форматирования даты.
Дело в том, что даты ресурсов и так хранятся в виде timestamp, но конвертируются в нормальные даты из-за использования объектов modResource - так запрограммировано в его свойствах. А потом, для форматирования даты, их нужно перевести обратно в timestamp. Выходит двойная ненужная конвертация.
pdoTools же работает напрямую с базой данных, без создания объектов и конвертации их значений, поэтому в чанк приходит timestamp, который не нужно дополнительно обрабатывать. Вы можете сразу применять модификатор date к значениям:
[[+publishedon:date=`%d.%m.%Y`]] или [[+createdon:date=`%Y-%m-%d`]]Это касается работы с датами ресурсов и в других сниппетах pdoTools.
docs.modx.pro
pdoResources разбивка результатов по блокам / modx.pro
Всем привет. Столкнулся с такой задачей, нужно на сайте вывести карусель с изображениями и сделать так чтобы в каждом блоке было по 4 изображения. Вот пример:<div> <div> <div><a href="#x"><img src="http://placehold.it/300x300" alt="Image"></a></div> <div><a href="#x"><img src="http://placehold.it/300x300" alt="Image"></a></div> <div><a href="#x"><img src="http://placehold.it/300x300" alt="Image"></a></div> <div><a href="#x"><img src="http://placehold.it/300x300" alt="Image"></a></div> </div> </div> <div> <div> <div><a href="#x col-xs-6"><img src="http://placehold.it/300x300" alt="Image"></a></div> <div><a href="#x"><img src="http://placehold.it/300x300" alt="Image"></a></div> <div><a href="#x"><img src="http://placehold.it/300x300" alt="Image"></a></div> <div><a href="#x"><img src="http://placehold.it/300x300" alt="Image"></a></div> </div> </div>Тоесть блок с class=«item» должен повторяться через 4 добавленных изображения. Есть ли стандартное решение без велосипедов?Фильтрация по TV в pdoResources / modx.pro
Здравствуйте!У меня есть TV акция типа переключатели (радио):
Да==1||Нет==0Значение по умолчанию — 0 И два ресурса — один с акцией, другой без. Не работает вызов pdoResources:[[!AjaxSnippet? &snippet=`pdoPage` &propertySet=`blog` &element=`pdoResources` &parents=`[[*id]]` &tpl=`blogTpl` &includeTVs=`isAction,actionDate,imageOnMain,textOnMain` &prepareTVs=`1` &processTVs=`1` &where=`{"isAction":"0"}` &limit=`1` &page=`[[!geturi]]` &pageVarKey=`page2` &as_mode=`onload` &wrapper=`tpl.ajax` &showLog=`1` ]]Ничего не выводит. Притом если указать &where=`{"isAction":"1"}`то выведет правильный ресурс или оба, если и второму тоже поставить акцию. Лог такой (если не акция):0.0001621: pdoTools loaded 0.0000410: xPDO query object created 0.0032070: Included list of tvs: <b>actionDate, imageOnMain, isAction, textOnMain</b> 0.0043399: leftJoined <i>modTemplateVarResource</i> as <b>TVactiondate</b> 0.0004411: leftJoined <i>modTemplateVarResource</i> as <b>TVimageonmain</b> 0.0004909: leftJoined <i>modTemplateVarResource</i> as <b>TVisaction</b> 0.0003319: leftJoined <i>modTemplateVarResource</i> as <b>TVtextonmain</b> 0.0005219: Added selection of <b>modResource</b>: <small>SQL_CALC_FOUND_ROWS `id`, `type`, `contentType`, `pagetitle`, `longtitle`, `description`, `alias`, `link_attributes`, `published`, `pub_date`, `unpub_date`, `parent`, `isfolder`, `introtext`, `richtext`, `template`, `menuindex`, `searchable`, `cacheable`, `createdby`, `createdon`, `editedby`, `editedon`, `deleted`, `deletedon`, `deletedby`, `publishedon`, `publishedby`, `menutitle`, `donthit`, `privateweb`, `privatemgr`, `content_dispo`, `hidemenu`, `class_key`, `context_key`, `content_type`, `uri`, `uri_override`, `hide_children_in_tree`, `show_in_tree`, `properties`</small> 0.0000150: Added selection of <b>modTemplateVarResource</b>: <small>IFNULL(`value`, '') AS `tv.actionDate`</small> 0.0000122: Added selection of <b>modTemplateVarResource</b>: <small>IFNULL(`value`, '') AS `tv.imageOnMain`</small> 0.0000100: Added selection of <b>modTemplateVarResource</b>: <small>IFNULL(`value`, '0') AS `tv.isAction`</small> 0.0000110: Added selection of <b>modTemplateVarResource</b>: <small>IFNULL(`value`, '') AS `tv.textOnMain`</small> 0.0000491: Replaced TV conditions 0.0007021: Processed additional conditions 0.0011911: Added where condition: <b>`TVisaction`.`value`=0, modResource.parent:IN(256,257,258), modResource.published=1, modResource.deleted=0</b> 0.0000350: Replaced TV conditions 0.0001531: Sorted by <b>modResource.publishedon</b>, <b>DESC</b> 0.0000041: Limited to <b>1</b>, offset <b></b> 0.0003650: SQL prepared <small>"SELECT SQL_CALC_FOUND_ROWS `modResource`.`id`, `modResource`.`type`, `modResource`.`contentType`, `modResource`.`pagetitle`, `modResource`.`longtitle`, `modResource`.`description`, `modResource`.`alias`, `modResource`.`link_attributes`, `modResource`.`published`, `modResource`.`pub_date`, `modResource`.`unpub_date`, `modResource`.`parent`, `modResource`.`isfolder`, `modResource`.`introtext`, `modResource`.`richtext`, `modResource`.`template`, `modResource`.`menuindex`, `modResource`.`searchable`, `modResource`.`cacheable`, `modResource`.`createdby`, `modResource`.`createdon`, `modResource`.`editedby`, `modResource`.`editedon`, `modResource`.`deleted`, `modResource`.`deletedon`, `modResource`.`deletedby`, `modResource`.`publishedon`, `modResource`.`publishedby`, `modResource`.`menutitle`, `modResource`.`donthit`, `modResource`.`privateweb`, `modResource`.`privatemgr`, `modResource`.`content_dispo`, `modResource`.`hidemenu`, `modResource`.`class_key`, `modResource`.`context_key`, `modResource`.`content_type`, `modResource`.`uri`, `modResource`.`uri_override`, `modResource`.`hide_children_in_tree`, `modResource`.`show_in_tree`, `modResource`.`properties`, IFNULL(`TVactiondate`.`value`, '') AS `tv.actionDate`, IFNULL(`TVimageonmain`.`value`, '') AS `tv.imageOnMain`, IFNULL(`TVisaction`.`value`, '0') AS `tv.isAction`, IFNULL(`TVtextonmain`.`value`, '') AS `tv.textOnMain` FROM `modx_site_content` AS `modResource` LEFT JOIN `modx_site_tmplvar_contentvalues` `TVactiondate` ON `TVactiondate`.`contentid` = `modResource`.`id` AND `TVactiondate`.`tmplvarid` = 38 LEFT JOIN `modx_site_tmplvar_contentvalues` `TVimageonmain` ON `TVimageonmain`.`contentid` = `modResource`.`id` AND `TVimageonmain`.`tmplvarid` = 36 LEFT JOIN `modx_site_tmplvar_contentvalues` `TVisaction` ON `TVisaction`.`contentid` = `modResource`.`id` AND `TVisaction`.`tmplvarid` = 40 LEFT JOIN `modx_site_tmplvar_contentvalues` `TVtextonmain` ON `TVtextonmain`.`contentid` = `modResource`.`id` AND `TVtextonmain`.`tmplvarid` = 39 WHERE ( `TVisaction`.`value` = '0' AND `modResource`.`parent` IN (256,257,258) AND `modResource`.`published` = 1 AND `modResource`.`deleted` = 0 ) ORDER BY modResource.publishedon DESC LIMIT 1 "</small> 0.0005929: SQL executed 0.0000889: Total rows: <b>0</b> 0.0000119: Rows fetched 0.0000219: Prepared and processed TVs 0.0000012: Returning processed chunks 0.0122540: <b>Total time</b> 13 631 488: <b>Memory usage</b> Помогите, пожалуйста, разобраться в чем проблема. Спасибо!modx.pro
