with-* macros

Description

The with-* macros allow to render a block of wiki markup in the context of another page (assuming the user has permissions to access the other page).

For instance, from the current page, you could call the {with-ancestors} macro to search for parent pages (up the page tree) matching the given criteria. The body of the {with-ancestors} macro would then be rendered, in the current page, using the page found by the macro as the context.

If several pages match the search parameters, then the with-* macro will use the first page found. For instance, using {with-ancestors:direction=up|label=test} will use the first ancestor page going up the page tree which is labeled 'test'.

The following with-* macros are available:

• {with-page}
• {with-ancestor} - same as {with-page:direction=up}
• {with-descendant} - same as {with-page:direction=down}
• {with-sibling} - same as {with-page:direction=sibling}

The macros include variables to refer to the resulting page's ID and title. For example, for the {with-page} macro, these are %withpageid% and %withpagetitle% respectively.

Please use the links above for specific information on each macro.