MODx/Встроенные сниппеты/UltimateParent

Материал из Викиучебника — открытых книг для открытого мира
Перейти к навигации Перейти к поиску

Что делает[править]

Следует вверх по дереву документов и возвращает Главный родительский документ. Принимает параметр top — ID документа на котором нужно остановиться, если вы не хотите следовать до самого корня дерева. Другой параметр id — ID документа ЧЕЙ родительский документ вы хотите узнать, если аргумент не указан будет использован ID текущего документа. Третий параметр topLevel — порядковый номер родительского документа начиная с самого верхнего в цепочке родительских документов, id которого нужно вернуть.

Использование[править]

Вызовите сниппет с или без следующих параметров:

[[UltimateParent? &id=`45` &top=`6`]]

вернёт родительский документ документа 45, до документа с айди 6.


[[UltimateParent? &id=`45` &topLevel=`3`]]

из цепочки родительских документов документа 45 вернет id третьего родителя сверху.


[[UltimateParent? &topLevel=`2`]]

из цепочки родительских документов, вернет id второго родителя сверху. Само-собой вызов сниппета должен происходить из документа находящего как минимум на третьем уровне вложенности. Если topLevel=3, то как минимум на четвертом уровне вложенности. Иначе будет возвращаться id самого верхнего родительского документа.

Версия[править]

текущая версия 2.0