Under Consruction
Description
The sorted-children macro can used for displaying lists of child pages...
Usage
{sorted-children}
Parameters
the "Ver" column shows which version of Theme Builder the parameter became available in.
| Property | Required | Default | Notes | Theme Panels Only | Ver |
|---|---|---|---|---|---|
| default |  |
@current | The page whose children should be shown Possible values:
|
||
| showRoot | |
false | Whether to show the root page or not | ||
| showSpaceSiblings | |
true | when displaying the path from @dashboard, list the space's siblings | ||
| showPageSiblings | |
true | when displaying the path from @dashboard, @parent, @parentparent, @space, @orphan, @root or @home, list the parent page's siblings | ||
| filter | |
all | only show spaces of type global/personal/all | ||
| depth | |
1 | the depth of children to be shown | ||
| countParentPages | |
false | include the parent pages in the depth count | ||
| countParentSpaces | |
false | include the parent spaces in the depth count | ||
| class | |
None | the css classname to apply to the list |
Examples
To follow
Basic Use
CSS Customisation
To follow
Hints and Tips
None at present.
Frequently Asked Questions
None at present.
Comments (12)
Aug 09, 2010
James Brown says:
I am using this to display all of the top level pages in my space. Is it possibl...I am using this to display all of the top level pages in my space. Is it possible to have the "Home" page always be at the top of the list? Is it also possible to have it automatically leave out the "Home" page?
Aug 09, 2010
Alain Moran says:
{sorted-children:@home} or {sorted-children:@home|showRoot=true}{sorted-children:@home} or {sorted-children:@home|showRoot=true}
Aug 09, 2010
James Brown says:
Right now, my pages are structured in my space like this: SPACE Home Documen...Right now, my pages are structured in my space like this:
SPACE
So when I have the tag with the parameters you suggest, I get nothing since nothing is under @home. And when I use @root, everything works fine except the list is output alphabetically, and Home ends up in the middle. So I want to either have it be at the top of the list, or not show up at all.
Should I be structuring my wiki so that everything is under home? I am a little new to Confluence.
Aug 09, 2010
Alain Moran says:
Go into browse-space (tree view) and drag the home page to the top of the list.Go into browse-space (tree view) and drag the home page to the top of the list.
Oct 16, 2010
Carol Smith says:
I was wondering if there was a way to apply the menubar macro to the sorted-chil...I was wondering if there was a way to apply the menubar macro to the sorted-children macro?
I've tried the following:
{menubar:id=testchildrenmenu} {sorted-children} {menubar}But it doesn't seem to be working. What am I doing incorrectly?
Thanks in advance for your help!
Oct 16, 2010
Alain Moran says:
You need to use the {wikimenu} macro to strip the outer unordered list, which sh...You need to use the {wikimenu} macro to strip the outer unordered list, which should enable you to use the output of the sorted-children macro in a menu, eg:
{menubar:id=testchildrenmenu} {wikimenu}{sorted-children}{wikimenu} {menubar}Which results in: (I actually pointed this at @root to give it something useful to display)
Oct 18, 2010
Steve McRoberts says:
Thanks for this handy macro. The Confluence Notation Guide mentions a sort opti...Thanks for this handy macro. The Confluence Notation Guide mentions a sort option. What sort methods are available?
Jun 15, 2011
Susan Hallwood says:
How do I get the siblings for every parent page to show in in the menu when not ...How do I get the siblings for every parent page to show in in the menu when not viewing the home page?
{menubar} {menuitem}{menulink:home}Home Page{menulink}{menuitem} {wikimenu}{sorted-children:@home|parent=Home|page=@home|showPageSiblings=true|depth=999}{wikimenu} {menubar}Jun 16, 2011
Susan Hallwood says:
i have found another issue with the menu of space pages that I am tryng to crete...i have found another issue with the menu of space pages that I am tryng to crete. It is not wrapping which does not look pretty. I need to be able to create a menu of all of the pages in a space, wrapp the menu, and I need the menu to work even if the Home page name has been changed. Is there any way to create this menu with the current macros or is it possible to get some one to develop this capability and how much would it cost?
Jun 16, 2011
Alain Moran says:
I'm not entirely sure what you are asking for, it's possible that a support cont...I'm not entirely sure what you are asking for, it's possible that a support contract is what you need rather than actual development since the sorted-children macro should be fine with spaces using non-standard homepage names ... although that depends greatly on what markup you are using - the support contract would enable us to assist you in choosing the correct markup for your task.
Jun 16, 2011
Susan Hallwood says:
Perhaps a developer in not in need. I am frustrated since I have been trying to ...Perhaps a developer in not in need. I am frustrated since I have been trying to solve this issue for a quite a while now. I started out using the pop-menu macro with the children macro to create a menus of the pages in each space. The children macro didn't work because the client's users have changed the name of some of their home pages. I also discovered that the popmenu macro is part of the popkong theme that is no longer being developed. The popkong theme is installed but when we upgrade the clients production wikis to Confluence 3.5 the popkong theme will be uninstalled and they will be using the new theme that i am creating uing the Builder theme which has to replicate the popkong theme as much as possible. The sorted children macro fixes the problem with the home page name changes but when viewing another page (not the home page) the siblings are only displayed in the a drop down menu for that page. Additionally, when viewing the menu in another space with long page names, the menu overlaps the navagation panel. This would be ok except the theme is a fixed width theme so the menu needs to wrap. I am working on trying wrap the menu using css but that does not fix the issuue with the siblings being displayed in the menu no matter what page you are viewing.
This is the wiki mark up i have tried:
{table:width=100%|cellpadding=0|cellspacing=0|border=1|bgcolor=#778899} {tr:bgcolor=#778899} {td:style=white-space:prewrap} {menubar:class=pagemenu} {wikimenu}{children:page=Home|all=true|sort=title} {wikimenu} {menubar} {td} {tr} {table} {table:width=100%|cellpadding=0|cellspacing=0|border=1|bgcolor=#778899} {tr:bgcolor=#778899} {td:style=white-space:prewrap} {menubar:class=pagemenu} {wikimenu} {sorted-children:@home|parent=Home|page=Home|countParentPages=true|showPageSiblings=true|depth=999} {wikimenu} {menubar} {td} {tr} {table}Jun 16, 2011
Susan Hallwood says:
Thanks Alain , i have sent a support request regarding this issue.Thanks Alain , i have sent a support request regarding this issue.