| Parameter |
Required |
Default |
Notes |
Builder Version |
| default |
 |
@space |
Defines where the page tree should start from:
- SPACEKEY:pagename - a specific page in a specific space
- page title - a specific page (defined by it's title) in the current space
- @self - the current page
- @parent - the parent of the current page
- @space - the currently viewed space showing all top-level pages and also news items (default)
- @root - same as @space
- @home - the homepage of currently viewed space (does not include news items)
- @dashboard - the Confluence dashboard showing all spaces the user has access to
|
3.0 |
| space |
|
current space |
If you want to show a page tree for a different space, specify the space key of that space using this parameter. |
3.0 |
| page |
|
|
An alternate way to specify the page (by it's title) to use as the root node of the tree. |
3.0 |
| target |
|
|
The target window that links in the tree should be opened in (eg. _blank or _self). |
3.0 |
| showIcons |
|
true |
Should icons be shown in the tree?
- true - show icons (default)
- false - do not show icons
|
3.0 |
| selectionMode |
|
node |
When a node is selected in the tree, what should be highlighted?
- node - highlight the node caption (default)
- row - highlight the entire row
|
3.0 |
| autoCollapse |
|
false |
Only allow a single node to be expanded?
- false - allow any number of nodes to be expanded (default)
- true - when a node is opened, collapse all other nodes
|
3.0 |
| indent |
|
true |
Should different levels of the tree be indented?
- true - indent each level (default)
- false - left align all levels
|
3.0 |
| showRoot |
|
true |
Should the root node of the tree be shown?
- true - show the root node
- false - hide the root node
|
3.0 |
| branchStyle |
|
plus-lines |
Defines how the structure of the tree is visualised:
- plus-lines - +/- buttons, dotted lines (default)
- plus-nolines - +/- buttons, no lines
- ball-lines - yellow sphere buttons, dotted lines
- ball-nolines - yellow sphere buttons, no lines
- arrow - green arrow buttons, no lines
|
3.0 |
| iconStyle |
|
computer |
Which icon set should be used?
- computer - computer style icons (default)
- website - website style icons
- builder - Theme Builder style icons
- bookshelf - bookshelf style icons
|
3.0 |
| class |
|
|
An optional CSS class to assign to the outer wrapper of the page tree. |
3.0 |
| openpage |
|
true |
When a link is clicked, should the corresponding page be opened?
- true - open the link
- false - highlight the link, but don't open it
|
3.0 |
| allowdrag |
|
false |
Allow pages in the tree to be dragged to new locations?
- true - allow page moving
- false - do not allow page moving
|
3.0 |
| treename |
|
|
The name of the tree (for use with pagepanel macro)
 May be deprecated or changed in future versions |
3.0 |
| titletip |
|
false |
Should the page title be used as the tooltip when hovering over items in the tree?
- true - display the page title in the tooltip
- false - display the date and author of the item in the tooltip
|
3.0 |
| initialDepth |
|
1 |
The number of levels to automatically expand when the tree is displayed. |
3.0 |
This macro required Theme Builder 3 or above
Added by
Hi folks,
If I'm running standalone Confluence 2.6.2 with Page Manager 0.0.5-snapshot and Builder 2.0.5-snapshot installed on the system, should I expect pagetree2 to work? Browsers: Firefox 2 and IE7.
We just upgraded from Confluence 2.4.5 (with no changes to the Adaptavist bits) and now, the pagetree2 macro no longer works (we get the endlessly looping "Loading..." error instead of a tree). Should I be running a different Page Manager version?
Any help appreciated!
uninstall the page manager and builder 2.0.5 and install builder 3.0.0
Thanks, Alain. This fixed it. BTW: nice work on Builder 3! Kudos to the team.
the new icon sets for this macro look great. are there any plans to have matching options for the menus?
The icons are all available via the menuicon macro (and therefore also the compound-menuitem macro) - we've just not found a feasible method of documenting all the icons that are available yet as there are something like 800 icons in there now :o If you rename the plugin's ".jar" file to a ".zip" you should be able to extract it using something like WinZIP or StuffIt Expander - the icons are stored in /resources/icons
exactly what i needed. cheers!
I tossed some markup (in a text file) into the menuicons page that displays all of the Builder 3 icons. It's a large Wiki page when it renders, but it works...
Awesome! Thanks Chris! Builder 3.x Icons
Hi there,
Is there a way to use that macro to show two trees distinguished by space types: personal and global spaces ?
We want to show the spaces created by users (global) on top and then another tree at the bottom to show all the personal spaces created by each users. Otherwise everything gets mingled.
We are building up an intranet for our company.
Thanks
Yes, this would be a great feature. Without it, we can't use the (very useful) @dashboard setting.
Totally agree that this would be VERY useful, especially since Personal and Global spaces get mixed up when listed alphabetically. Perhaps need extra @global and @personal options, or @dashboardbytype that lists global spaces first then personal spaces.
How do you get these lower-case-characters into the pagetree? You don't seem to have the problem wie experience: we are using the pagetree2-macro to show the structure of a space, but all words in the page tree start with an upper-case-letter - even when the start with lower-case-letters in den page title.
Thanks,
Chris
Is there a way to set the pagetree2 macro to ignore case when sorting? I've got it set so that the top-level elements that are displayed in the tree are our space names. We have one space with a name that begins with a lowercase character, and that space shows up at the end of the list:
This space
Some other space
missorted space
On the dashboard, the space names are sorted regardless of case:
This space
missorted space
Some other space
It would be nice if there was an attribute to control the sort-type.
Thanks!
I know I can turn indenting on and off (indent=true), but am curious if there's a way to control the amount (width) of the indent. I checked out what I think was the right CSS and couldn't find it, but perhaps I'm looking in the wrong place.
TIA! Chris
Hi - How can I hide the News link in the pagetree?
Call me crazy but I am having trouble ordering my results. I am listing several children of the page using the pagetree command and would like them to show in reverse order, however cannot figure it out. I could do it with the order statement of the old pagetree, but this new version does not have it. My command is
{pagetree2:@self}The page shows up similar to below - I would like the newest date and version to be on top. Any help please... thanks in advance!
Security Agent Nightly Update Notes - Index
We like pagetree2 a lot, and have some spaces where it's placed in a collapsible Left Side Bar. This works fine unless another invocation of pagetree2 is done somewhere else in the content (some Space owners like having a space map in a section of their space home pages) and then all heck breaks loose.
Is there an ID parameter that can be used to allow two invocations of pagetree2 on the same page (one in the sidebar, one in the content) to play nicely with each other? I tried the treename parameter, but that didn't seem to do anything.
TIA! Chris
I'm using pagetree2 with confluence 2.8
I tried this setting:
{pagetree2:allowdrag=true|showRoot=false|initialDepth=3}All the subitems in the tree never stay open when clicked.
So if I have:
top
If I click on 'a' page 'a' loads fine, but the left nav is collapsed and I can't see 'a', just 'item 1'
Are there more settings I need to use?
Hi Mark,
try removing the initialDepth parameter (it seems not to work anyway, or does it in your case?). This solved the problem for me.
At first glance, the macro appears not to respect any custom page ordering I do in Confluence 2.8. Is this the case, or am I missing something?
Updated by Chris Paquin
Jun 23, 2008 18:27
Can I do a Div with Scrollbars for Pagetree2? Here's what I'm trying, but it's not respecting my "height" parameter:
{div:style=height:100px;width:100px;overflow:scroll;} {pagetree2} {div}Width works fine. Height is set, but no scrollbar appears...
*edit: it looks like this only malfunctions in the LSB.. in the content area, it works fine.
*edit 2: never mind! the issue was with my settings on the LSB width. For posterity: if you're doing a scrolling div in the leftsidebar, make sure the sidebar's height and width are both set to "auto".
Thanks...Chris
how do permissions work with this macro? i just set allowdrag to 'true', and was able to change the order of pages in a space with a user who only had "view" privileges.