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
Answer accepted

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
Published Mar 12, 2019 in Confluence

Confluence Admin Certification now $150 for Community Members

More and more people are building their careers with Atlassian, and we want you to be at the front of this wave! Important Dates Start the Certification Prep Course by 2 April 2019 Take your e...

1,489 views 4 13
Read article

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