[All Adaptavist Apps]

Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

{builder-children} Macro

Description

This macro

Excerpt

defines where the list of child pages, if enabled, will be shown

within the theme layout.

...

Wiki Markup
First of all, check that the following wiki notation is included in one of the theme panels:

{code}
{builder-children}
{code}

If it's not, then add it ;)

Also, check that the panel which contains the macro is enabled - if the panel isn't shown, it's contents aren't shown.

If you have hidden the list of child pages (eg. using the "Hide Children" link), then they will not be shown on any pages until you re-display them again. There are a few ways you can display re-display them...

The best way is to use the [menulink macro] to display a link or menuitem that allows users to show/hide the list{footnote}This link is included as default on the View menu for pages that have child pages.{footnote}:

{code}
{menuitem:flat=true}{menulink:children}Show child pages (%count%){menulink}{menuitem}
{code}

{display-footnotes}

Which displays: {menuitem:flat=true}{menulink:children}Show child pages (%count%){menulink}{menuitem}

We've wrapped the link in the [menuitem macro] so that pages which do not have child pages will not display an inactive link.

Another approach is to include the showChildren=true setting on the page URL. For example, the URL to this page is:

{{http://www.adaptavist.com/display/USERGUIDEAtlassianConfluence/builder-children+macro}}

You would change that to:

{{http://www.adaptavist.com/display/USERGUIDEAtlassianConfluence/builder-children+macro?showChildren=true}}

Anyone accessing this link would automatically get the display of child pages switched on, regardless of what previous settings they had used.

...