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