This documentation relates to an early version of Confluence.
View this page in the current documentation or visit the current documentation home.

Children Display Macro

Added by Vidya Madabushi, last edited by Vidya Madabushi on Nov 24, 2005  (view change)
All Versions
Click for all versions
Confluence 1.4 Documentation

Index

Use the Children Display Macro to display the children and the descendants of a page.

Note that only pages to which you have 'View' permission will be displayed.

Children Display Macro

What you need to type What you will get
{children}

Optional Parameters

Display all descendants of the page

What you need to type What you will get
{children:all=true}



Specify the page for which you want to display children

What you need to type What you will get
{children:page=children display macro}



Specify the depth of descendants

What you need to type What you will get
{children:depth=2}



Specify the style in which descendants are displayed

Choose from heading levels h1 to h6.

What you need to type What you will get
{children:depth=1|style=h3}

Child Page 1

Child Page 2



Display the child pages' excerpts, if they exist

What you need to type What you will get
{children:depth=2|excerpt=true}
If the page parameter is '/', then the macro will list all the current space's "top level" pages – those without parents. If the page parameter is a space key followed by a
colon (e.g {children:page=DOC:}), then the top level pages of that space will be listed.
RELATED TOPICS

Working with Page Families
Working with Macros

Take me back to Help Home
Enter labels to add to this page:
Please wait 
Looking for a label? Just start typing.

Comments (6)

 

  1. Aug 25, 2005

    Vidya Madabushi says:

    Dummy excerpts for the two child pages...

    Dummy excerpts for the two child pages...

  2. Feb 20, 2006

    Laks Krishnamoorthy says:

    Vidya, Where do I change the order of page display to display by title in every...

    Vidya,

    Where do I change the order of page display to display by title in every page in our confluence instance.

    Thanks

    Laks

     `

    1. Feb 21, 2006

      Guy Fraser says:

      I'll fill in some other missing info from this page then answer your question......

      I'll fill in some other missing info from this page then answer your question...

      There are three sort orders:

      • title (alphabetical, but gets confused by numbers)
      • created (date)
      • modified (date)
      {children:sort=title}
{children:sort=created}
{children:sort=modified}

      You can also reverse the sort:

      {children:sort=title|reverse=true}
etc..

      Sadly, there is currently no way to set a specific order for pages. The closest you can get is to number them like:

      1. Whatever
      2. Whatever
      3. Whatever

      The only problem is that this only works for 10 pages (0-9) – once you get over that, problems occur, eg:

      1. Whatever
      10. Oh dear
      2. Whatever
      etc

      Adaptavist are working on an updated page tree plugin that might solve that number sorting issue, but it's still a shame that pages can't be given a specific order.

  3. Feb 21, 2006

    Laks Krishnamoorthy says:

    Guy,  Thanks. What I want is to change the order of the children listed be...

    Guy,

     Thanks. What I want is to change the order of the children listed below on every page to be sorted by title. This is the listing of all children below the that says

    Children   Hide Children | View in hierarchy | Add Child Page

    Thanks

    Laks

  4. Apr 13, 2007

    Nana says:

    Is there a Parent macro to display parents on child pages?. Its only fair that t...

    Is there a Parent macro to display parents on child pages?. Its only fair that there should be.

  5. May 09, 2007

    Bovier Raphael says:

    Is there a marco to list the incoming links of a page and of all of it's childre...

    Is there a marco to list the incoming links of a page and of all of it's children page ? Something like a combination of the children macro and eht incoming-links macro ? Thanks for advice