Access Keys:
Skip to content (Access Key - 0)
Home (Access Key - 1)
All spaces... (Access Key - 3)
Log in (Access Key - 5)
Sign up (Access Key - 6)
Toggle Sidebar

pagetree2 macro

(None)

{pagetree2} macro

This macro required Theme Builder 3 or above

Overview

Usage

{pagetree2:@space|selectionMode=node}

Parameters

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

Examples

Hints and Tips

CSS Customisation

FAQs

See Also

Toggle Sidebar

See Also

Incoming Links


Outgoing Links


Added by Guy Fraser on Nov 15, 2007 23:40, last edited by Guy Fraser on Jan 30, 2008 13:49

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...

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

  • TTC Security Agent - 2006.10.03 - v6.01.00 Release
  • TTC Security Agent - 2006.11.08 - v6.01.04 Release
  • TTC Security Agent - 2007.01.19 - v6.01.07 Release
  • TTC Security Agent - 2007.02.27 - v6.01.08 Release
  • TTC Security Agent - 2007.04.26 - v6.01.10 Release

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

  • item 1
  • a
  • b
  • c
  • item 2

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.


Adaptavist Theme Builder Powered by Atlassian Confluence