Skip to Content
0 Votes

Changes for page Children Macro

Last modified by Cyril Boillat on 02/06/2025
From version 1.1
edited by Cyril Boillat
on 12/03/2021
Change comment: Install extension [org.xwiki.platform:xwiki-platform-index-tree-macro/12.10.4]
To version 7.1
edited by Cyril Boillat
on 02/06/2025
Change comment: Install extension [org.xwiki.platform:xwiki-platform-index-tree-macro/16.10.8]

Summary

Details

XWiki.WikiMacroClass[0]
Macro code
... ... @@ -1,3 +1,10 @@
1 1  {{velocity}}
2 -{{documentTree root="document:" /}}
2 +## Escape special characters in the macro parameter value.
3 +#set ($sort = $xcontext.macro.params.sort.replaceAll('([~"])', '~$1'))
4 +#if ("$!xcontext.macro.params.root" != '')
5 + #set ($root = $xcontext.macro.params.root)
6 +#else
7 + #set ($root = 'document:')
8 +#end
9 +{{documentTree root="$root" sortDocumentsBy="$!sort" /}}
3 3  {{/velocity}}
Default category
... ... @@ -1,1 +1,0 @@
1 -Navigation
Cached
... ... @@ -1,0 +1,1 @@
1 +No
Asynchronous rendering
... ... @@ -1,0 +1,1 @@
1 +No
Default categories
... ... @@ -1,0 +1,1 @@
1 +Navigation
XWiki.WikiMacroParameterClass[0]
Parameter name
... ... @@ -1,0 +1,1 @@
1 +sort
Parameter description
... ... @@ -1,0 +1,1 @@
1 +The document field used to sort the child documents, followed optionally by the sort order. E.g.: 'title' or 'date:desc'.
Parameter type
... ... @@ -1,0 +1,1 @@
1 +org.xwiki.index.tree.internal.macro.DocumentSort
Parameter mandatory
... ... @@ -1,0 +1,1 @@
1 +No
XWiki.WikiMacroParameterClass[1]
Parameter name
... ... @@ -1,0 +1,1 @@
1 +root
Parameter description
... ... @@ -1,0 +1,1 @@
1 +The root node id. This is useful if you want to display only the descendants of a given node (which is the specified root). The tree displays the children of the root node on the first level, so the root node is not actually displayed. The entire tree is displayed if the root node is not specified. The format of a node identifier is entityType:entityReference, where the entity type can be for instance wiki, space, document. E.g.: wiki:xwiki, space:xwiki:Main, document:xwiki:Main.WebHome
Parameter mandatory
... ... @@ -1,0 +1,1 @@
1 +No