Looking to customize the renderChildren() macro used near the bottom of each page


I need to slightly modify the renderChildren() macro that is being used in the default page layout: I need to display all pages, but with their children recursively.

The end effect being something around the output of this wiki markup:


Showing page excerpts and collapse|expand links is not really that critical. The most important aspect for me would be to include children's children in the output.

One of the considerations is that I want this customization made at the space leve. I don't want to mess around the site-wide configuration. Currently I've edited my space page layout and commented out the #renderChildren() invocation alltogether. The negative side of this approach is that now I need to edit every page and manually add the above snippet in order to have recursive children of the current page.

So I wondered if there was any other way to automatically get this effect for all pages of my space - may be the #renderChildren() macro accepts configuration arguments? Unfortunately I'm not conversant with the internal macro syntax, nor did I have any luck googling around regarding this toppic :(

1 answer

1 accepted

3 votes
Accepted answer

You could render the pagetree macro in the layout with $helper.renderConfluenceMacro():

<div id="children-section" class="pageSection children-showing group">
    <div class="section-header" style="padding-left: 0px;">
        <h2 id="children-section-title" class="section-title">Child Pages</h2>

Hope this helps

Thanks Remo! Worked like a charm. I wasn't familiar with the helper interface.

Suggest an answer

Log in or Sign up to answer
Community showcase
Posted Monday in Confluence

Organizing your space just got easier - Page Tree Drag & Drop is here

Hi Community! I’m Elaine, Confluence Product Manager. You may have read my earlier post about page tree in space navigation sidebar. I'm excited to share another improvement that helps you organize ...

69 views 3 3
Join discussion

Atlassian User Groups

Connect with like-minded Atlassian users at free events near you!

Find a group

Connect with like-minded Atlassian users at free events near you!

Find my local user group

Unfortunately there are no AUG chapters near you at the moment.

Start an AUG

You're one step closer to meeting fellow Atlassian users at your local meet up. Learn more about AUGs

Groups near you