Confluence PageTree Plugin

Name AJAX PageTree
Vendor Atlassian
Authors Zohar Melamed, Alain Moran, Guy Fraser, Matthew Jensen, Ryan Talusan, Atlassian Developers, Matt Ryall (Atlassian), David Chui Wing Yen (Atlassian)
Homepage http://confluence.atlassian.com/display/CONFEXT/Confluence+PageTree+Plugin
Issue Management http://developer.atlassian.com/jira/secure/BrowseProject.jspa?id=10017
Continuous Integration n/a
Categories Content Macros
Most Recent Version 1.11
Availability Confluence v2.8.0 to v3.0.0_01
State Stable
Support Atlassian Supported Plugins
License Freeware / Open Source (BSD)
Price Free
Release Docs http://confluence.atlassian.com/display/CONFEXT/Confluence+PageTree+Plugin
Java API Docs n/a
Download Source http://svn.atlassian.com/fisheye/browse/public/contrib/confluence/pagetree-plugin/tags/pagetree-1.11
Download JAR pagetree-1.11.jar
You will need to use version 1.5 or earlier if you are using Confluence 2.7 (or earlier).

Compatibility With Confluence

Plugin Versions 2.7 2.8 2.9 2.10 3.0
1.11  
1.10.2    
1.10.1    

Confluence User Guide

For information on the Page Tree and Page Tree Search macros bundled with Confluence, please refer to the Confluence User Guide:€

Description

A macro that embeds the ajax page tree found in the browse space content page by william jones and zohar melamed, with extensions by adaptavist.com

Usage

{pagetree:root=PageName|sort=natural|excerpt=true|reverse=false|startDepth=3|expandCollapseAll=true|searchBox=true}

root defines the page which acts as the root of the tree. It can be the page name, or any of the following

  • @home - set the root page to the Home page (default)
  • @self - set the root to the current page
  • @parent - set the root to the parent of the current page
  • @none - pagetree shows all pages in the space, including Orphaned pages

sort may be one of the following

  • position - sort pages using the Confluence 2.8 sorting rules which uses the position if set, otherwise reverts to natural ordering (default for versions 1.7 onwards).
  • natural - sort pages in natural order, eg: title1, title2, title10 (default for versions before 1.7).
  • bitwise - sort pages using standard alphabetical sorting on the page title, eg:title1, title10, title2
  • creation - sort pages by creation date
  • modified - sort pages by modification date

excerpt is a true/false flag that states whether page excerpts should be included in the tree display (defaults to false)

reverse is a true/false flag that allows you to reverse the order of display (defaults to false)

searchBox is a true/false flag that allows you to add a search box that would allow searching within the page tree (defaults to false)

startDepth is any number greater than 0 that indicates how many levels of descendants to show initially. (defaults to 1)

expandCollapseAll is a true/false flag that allows you to add an expand all and collapse all feature (defaults to false)

If you just see a message "Loading..." and nothing else, make sure you have Base URL correctly set in your General Configuration settings.
Creating a navigation panel for your space

A popular usage of {pagetree} is to create a navigation panel showing a table of contents for your space. You can find the instructions in the Confluence User Guide.

Installation

Download the plugin jar (URL at top of this page) and upload via the Plugin Manager.

If you are upgrading from an earlier version, you will need to restart Confluence to clear the velocity cache in order to ensure the latest features are used.
This plugin now accessible through the Confluence Repository Client.

Plugin Versions

Version Date State License Price
Show description 1.11 (#20) 06 Apr 2009 Stable Freeware / Open Source (BSD) Free

Release Notes
1.11 release notes

Contributors

  • Matt Ryall (Atlassian) — Developer
  • David Chui Wing Yen (Atlassian) — Developer

Show description 1.10.2 (#19) 02 Mar 2009 Stable Freeware / Open Source (BSD) Free

Release Notes
1.10.2 release notes

Contributors

  • Matt Ryall (Atlassian) — Developer

Show description 1.10.1 (#18) 22 Sep 2008 Stable Freeware / Open Source (BSD) Free

Release Notes
1.10.1 release notes

Contributors

  • Atlassian Developers — Developer

Show description 1.10 (#17) 22 Aug 2008 Stable Freeware / Open Source (BSD) Free

Release Notes
1.10 release notes

Contributors

Show description 1.9 (#16) 21 Jul 2008 Stable Freeware / Open Source (BSD) Free

Release Notes
1.9 release notes

Contributors

Show description 1.8 (#15) 08 Jul 2008 Stable Freeware / Open Source (BSD) Free

Release Notes
1.8 release notes

Contributors

Show description 1.7 (#14) 27 Mar 2008 Stable Freeware / Open Source (BSD) Free

Release Notes

  • CONF-11135: Updated sorting to use confluence's new natrual sorting to match this plugin

Contributors

Show description 1.6 (#13) 04 Feb 2008 Stable Freeware / Open Source (BSD) Free

Release Notes

  • PGTR-12: Properly configured with maven 2 pom
  • PGTR-13: Fixed up some issues caused by PGTR-12 fix
  • CONF-10609: Updated action to use 2.8 compatible API.

Contributors

Show description 1.3 (#11) 14 Jul 2006 Stable Freeware / Open Source (BSD) Free

Release Notes
Now extends BaseMacro to avoid breaking external image rendering

Contributors

Show description 1.2.7 (#10) 05 May 2006 Stable Freeware / Open Source (BSD) Free

Release Notes
Resolve NPE's caused by pagetree being used in the left-nav theme (does NOT resolve CSS styling issues)

Contributors

Show description 1.2.6 (#9) 04 May 2006 Stable Freeware / Open Source (BSD) Free

Release Notes

  • Removed the requirement for the domain name to be set in general configuration
  • Added defaulting the root page to the homepage of the current space
  • Added the ability to use the @parent and @self macro pagenames
  • Contributors

    Show description 1.2.5 (#8) 01 Apr 2006 Stable Freeware / Open Source (BSD) Free

    Release Notes
    Fixed issues with pagetree running within page.vmd on confluence 2.1.1

    Contributors

    Show description 1.2.4 (#7) 24 Mar 2006 Stable Freeware / Open Source (BSD) Free

    Release Notes
    Fixed pagetree for confluence installs with a base path, fixed JS error in branch-collapse routine which caused a page refresh.

    Contributors

    Show description 1.2.3 (#6) 02 Mar 2006 Stable Freeware / Open Source (BSD) Free

    Release Notes
    Fixed PGTR-2, and resolved issues with rendering links in excerpts

    Contributors

    Show description 1.2.2 (#5) 28 Feb 2006 Stable Freeware / Open Source (BSD) Free

    Release Notes
    Fixed PGTR-1, added scriptaculous effects and resolved issues with rendering wiki text in excerpts.

    Contributors

    Show description 1.2.1 (#4) 28 Feb 2006 Stable Freeware / Open Source (BSD) Free

    Release Notes
    Fixed sort-order selection issue

    Contributors

    Show description 1.2 (#3) 28 Feb 2006 Stable Freeware / Open Source (BSD) Free

    Release Notes
    Added some enhancements:

    • Ability to display excerpts
    • Ability to have more than one instance on a page
    • Natural Sorting by default (1, 2, ... 10 etc)
    • Ability to sort by natural, bitwise, creation, modified
    • Ability to reverse sort
    • Ability to display excerpts next to items in the tree

    Contributors

    Show description 1.0 (#1) 27 Dec 2005 Stable Freeware / Open Source (BSD) Free

    Release Notes
    The inital release.

    Contributors

    • Zohar Melamed — Developer

    Outstanding issues

    Labels

    plugin plugin Delete
    macro macro Delete
    confluence20 confluence20 Delete
    confluence21 confluence21 Delete
    repository_current repository_current Delete
    Enter labels to add to this page:
    Please wait 
    Looking for a label? Just start typing.
    1. Jan 05, 2006

      Anselm McClain says:

      Thanks for the plugin - it's helpful. It would be great if there were a way to ...

      Thanks for the plugin - it's helpful.

      It would be great if there were a way to have the menu expanded by default to x levels. As it is now, I need to click down to the page I wish to visit, then click the page itself. If the top levels were expanded it would save a click.

      Also - it doesn't seem to have any memory of how I've left the various trees. It would be nice if things would stay expanded / collapsed while I'm browsing through the site.

      Best of luck!

      1. Mar 08, 2006

        Bernard Durfee says:

        Same here, this would be a nice feature.

        Same here, this would be a nice feature.

        1. Mar 08, 2006

          Guy Fraser says:

          Which bit - the default expansion or the memory of what's been expanded?

          Which bit - the default expansion or the memory of what's been expanded?

    2. Jan 06, 2006

      James Matheson says:

      I am working with the 'left navigation' theme and I want to put the PageTree plu...

      I am working with the 'left navigation' theme and I want to put the PageTree plug in into the Navigation page.   
      I can get the PageTree macro working in the main page, but when I put it in the Navigation page, I get a NullPointerException (output in the Navigation area).   The Navigation page looks correct when I view it, it only has a problem when it is rendered as the side bar. 

      Has anyone had any success this plugin in the Navigation page?

      1. Apr 19, 2006

        Othman Alaoui says:

        No success here so far (see my comments below).

        No success here so far (see my comments below).

    3. Feb 15, 2006

      Mingyi Liu says:

      Excellent macro! I like it a lot. I made a slight modification so that users can...

      Excellent macro! I like it a lot. I made a slight modification so that users can hide the tree if they want to (and change 'display:inline' to 'display:none' if you want the tree menu to be hidden by default):

      #if ($action.isPrintableVersion() == false)
      <style>
      .spacetree * ul{
      padding-left:0px;
      margin-left: 0px;
      }
      .spacetree * li{
      margin-left: 5px;
      padding-left:5px;
      }
      </style>
      
      <script>
        function toggleNavTree()
        {
          var td = document.getElementById('treenavtd');
          if(td.style.display == 'none') td.style.display = 'inline';
          else td.style.display = 'none';
        }
      </script>
      
      <table>
      <tr><a href="javascript:toggleNavTree()">Toggle Space Navigation Tree</a></tr>
      <tr>
      <td id="treenavtd" style="display:inline;" valign="top" align="left" width="22%" >
      <div class="tabletitle">Space Map</div>
      <div class="spacetree">
      #includePage($helper.spaceKey "TreeNavigation")
      </div>
      </td>
      <td valign="top" align="left" width="78%">
      <div class="wiki-content">
      <blockquote>
      $body
      </blockquote>
      </div>
      </td>
      </tr>
      </table>
      #else
      <div class="wiki-content">
          $body
      </div>
      #end
      

      An important question is: Most of our pages in a space is not branced off "Home", but I would like the tree to include all pages in a space, is it possible to modify the macro to allow setting root to space name so that all pages of a space would display? Thanks!

    4. Feb 27, 2006

      Jonty Hurwitz says:

      Hi Zohar I'm coming into your 'little family owned bank' on Thursday - to discu...

      Hi Zohar

      I'm coming into your 'little family owned bank' on Thursday - to discuss our fund factsheet reporting technology.  Our new product version links directly in with Confluence.  Thought it might be nice for you and I to hook up.  I can't seem to get your email anywhere so I hope you're watching this page.  Give me a shout:  jonty.hurwitz@statpro.com

    5. Mar 02, 2006

      Guy Fraser says:

      Zohar & William - would it be possible to change the license of this plugin ...

      Zohar & William - would it be possible to change the license of this plugin to BSD (ie. a certified open source license)?

    6. Mar 03, 2006

      samuel halle says:

      If you dont want to create a page only for the tree navigation, you can put the ...

      If you dont want to create a page only for the tree navigation, you can put the macro directly in the page layout, just replace a line of the code of Mingyi Liu from

          #includePage($helper.spaceKey "TreeNavigation")
      

      to

      $helper.renderConfluenceMacro("{pagetree:root=$space.homePage.title|sort=natural|excerpt=true|reverse=false}")
      
      1. Mar 03, 2006

        Alain Moran says:

        You should already be able to simply insert a pagetree macro into any page ... t...

        You should already be able to simply insert a pagetree macro into any page ... there is no reason that it should go onto its own page, I think thats just one way of using it.

        Possibly the idea of creating it in its own page was a workaround for the fact that it didnt use to work correctly with server trees on a single page. That issue is now resolved though so you shouldnt have any problems using it like a standard macro (thats the way that we and our clients use it)

        1. Mar 03, 2006

          Guy Fraser says:

          Samiel is referring to a technique to embed the page tree in to a theme. The lef...

          Samiel is referring to a technique to embed the page tree in to a theme. The left nav theme has a "navigation page" which allows you to add your own content to the left nav bar and the conventional way of adding the page tree was to put it on that navigation page. However, with the modification shown above, you can remove the navigation page completely and embed the page tree directly in to the left nav theme.

    7. Mar 16, 2006

      Rune Stilling says:

      Hi - I get the same exception. Did you find a solution?

      Hi - I get the same exception. Did you find a solution?

      1. Jun 21, 2006

        John Russell says:

        Hi - after working for several weeks, we are also seeing this error.  No re...

        Hi - after working for several weeks, we are also seeing this error.  No resolution at this time. 

    8. Mar 27, 2006

      Troy McKinnon says:

      I used the plugin repository to update my PageTree plugin. Now all my pages are ...

      I used the plugin repository to update my PageTree plugin. Now all my pages are saying:

      "The page you were trying to reach does not exist. You may want to try a search, or browse the site to find the page you were looking for."

      I use the layout mod with the following:

      $helper.renderConfluenceMacro("{pagetree:root=$space.homePage.title|sort=natural|excerpt=true|reverse=false}")

      1. Mar 27, 2006

        Guy Fraser says:

        I'll get Alain to check this out tomorrow. Have you tried it without the sort/ex...

        I'll get Alain to check this out tomorrow. Have you tried it without the sort/excerpt/reverse parameters?

        Also, could you try restarting Confluence to see if that makes any difference?

        Do you get the same error when you place the pagetree on a normal page (ie. within the normal wiki markup of that page)?

        1. Mar 27, 2006

          Troy McKinnon says:

          Restart didn't matter. Removing params didn't matter. One a regular page it thr...

          Restart didn't matter.
          Removing params didn't matter.

          One a regular page it throws a NPE

          1. Mar 27, 2006

            Guy Fraser says:

            Which version of Confluence are you using? It might be worth using the "Downgra...

            Which version of Confluence are you using?

            It might be worth using the "Downgrade" link to revert to an earlier version of the plugin whilst we track down the bug.

            1. Mar 27, 2006

              Troy McKinnon says:

              Not sure on the download link? is it in the repository plugin? We are using Ver...

              Not sure on the download link? is it in the repository plugin?

              We are using Version: 2.1.1 Build:#406 Dec 23, 2005

              1. Mar 27, 2006

                Guy Fraser says:

                With the latest version of the repository plugin, you should be able to click on...

                With the latest version of the repository plugin, you should be able to click on the "AJAX Page Tree" plugin title in the list to go to the details page - on there it should list all versions and there should be "Downgrade" links next to the older versions.

                We've not had any error reports on Confluence 2.1.1 but we'll do more testing tomorrow to see if we can find what's causing the bug.

                Do you get any stack traces or other error messages in your log files?

                Also, which version of Java are you using and how were any previous versions of the plugin installed (manually, via Plugin Manager, via Plugin Repository, etc?)

                1. Mar 27, 2006

                  Troy McKinnon says:

                  Websphere 6 w/1.4.2 Installed via plugins admin not repository plugin. Had to ...

                  Websphere 6 w/1.4.2

                  Installed via plugins admin not repository plugin.

                  Had to roll back to 1.2.2 (#5) for it to work again.

                  1. Mar 27, 2006

                    Guy Fraser says:

                    Thanks for the info Troy - that should allow us to track down the bug far more q...

                    Thanks for the info Troy - that should allow us to track down the bug far more quickly as we'll be able to review all the changes that were made between 1.2.2 and 1.2.3 (which seems to have been the point at which it broke on your configuration).

          2. Mar 28, 2006

            Alain Moran says:

            Troy could you email a copy of the exception that pagetree throws when viewed on...

            Troy could you email a copy of the exception that pagetree throws when viewed on a normal page to amoran at adaptavist.com, that may shed some light as to why you are seeing this problem and others are not. So far I am unable to reproduce any errors when using pagetree as you have outlined above, however I am runing 2.1.2 through Tomcat for my immediate tests (2.1.1 is currently downloading)

            1. Mar 28, 2006

              Alain Moran says:

              I have found and fixed a couple of problems with running pagetree under 2.1.1, h...

              I have found and fixed a couple of problems with running pagetree under 2.1.1, however I'm still unsure as to the meaning of your initial error

              "The page you were trying to reach does not exist. You may want to try a search, or browse the site to find the page you were looking for."

              Did this happen when you clicked on a link within an otherise functional pagetree, or did this happen within the area on the page you were expecting the pagetree to be displayed?

              1. Mar 29, 2006

                Troy McKinnon says:

                Door number 2: "or did this happen within the area on the page you were expecti...

                Door number 2:

                "or did this happen within the area on the page you were expecting the pagetree to be displayed?"

                The area "navigation Tree" which was suppose to be produced by the layout's call to the page tree was replaced with the confluence (default?) page not found page.

    9. Apr 18, 2006

      Hellmut Adolphs says:

      guys, any clue why I would get this exception? Cause: com.opensymphony.xwor...

      guys, any clue why I would get this exception?

      Cause:

      com.opensymphony.xwork.config.ConfigurationException: There is no Action mapped for namespace /confluence/pages and action name naturalchildren
       at com.opensymphony.xwork.DefaultActionProxy.(DefaultActionProxy.java:72)

      Stack Trace: [hide]com.opensymphony.xwork.config.ConfigurationException: There is no Action mapped for namespace /confluence/pages and action name naturalchildren
      at com.opensymphony.xwork.DefaultActionProxy.(DefaultActionProxy.java:72)
      at com.opensymphony.xwork.DefaultActionProxyFactory.createActionProxy(DefaultActionProxyFactory.java:45)
      ....

      Thanks in advance! 

    10. Apr 18, 2006

      Hellmut Adolphs says:

      Ok, that error I reported just before this post, seems to be related to the serv...

      Ok, that error I reported just before this post, seems to be related to the server Base URL in my configuration which goes something like <server>/confluence

      When I use the page tree macro, it tries to create the URL like this:

      /confluence//confluence/pages/naturalchildren.action?decorator=none&excerpt=false&sort=natural&reverse=false&pageId=264&treeId=1

       If I remove the /confluence from the server base URL, then it messes up all the short URLs generated within confluence.  Any idea why the macro is looking to add /confluence to the base URL?

      1. Apr 19, 2006

        Dan Hardiker says:

        See http://jira.adaptavist.com/browse/PTP-2
    11. Apr 19, 2006

      Othman Alaoui says:

      Please change the "Download JAR" link to point to the latest 2.1.x-compatible ve...

      Please change the "Download JAR" link to point to the latest 2.1.x-compatible version of this plugin: 1.2.5. Thanks.

      1. Apr 19, 2006

        Othman Alaoui says:

        I take that back: i am still getting the same NPE I was getting with 1.2.4 with ...

        I take that back: i am still getting the same NPE I was getting with 1.2.4 with 1.2.5 as well:

        2006-04-19 22:43:49,395 ERROR [renderer.radeox.macros.AbstractHtmlGeneratingMacro] execute Error rendering macro with url: root=Table of Contents
        java.lang.NullPointerException
                at com.bnpparibas.confluence.extra.tree.PageTree.getHtml(PageTree.java:88)
                at com.atlassian.confluence.renderer.radeox.macros.AbstractHtmlGeneratingMacro.execute(AbstractHtmlGeneratingMacro.java:44)
                at com.atlassian.renderer.macro.RadeoxCompatibilityMacro.execute(RadeoxCompatibilityMacro.java:149)
                at com.atlassian.confluence.renderer.v2.macros.RadeoxCompatibilityMacro.execute(RadeoxCompatibilityMacro.java:26)
                at com.atlassian.renderer.v2.macro.ResourceAwareMacroDecorator.execute(ResourceAwareMacroDecorator.java:45)
                at com.atlassian.renderer.v2.components.MacroRendererComponent.processMacro(MacroRendererComponent.java:330)
                at com.atlassian.renderer.v2.components.MacroRendererComponent.makeMacro(MacroRendererComponent.java:231)
                at com.atlassian.renderer.v2.components.MacroRendererComponent.makeMacro(MacroRendererComponent.java:131)
                at com.atlassian.renderer.v2.components.MacroRendererComponent.handlePotentialMacro(MacroRendererComponent.java:116)
                at com.atlassian.renderer.v2.components.MacroRendererComponent.render(MacroRendererComponent.java:78)
                at com.atlassian.renderer.v2.V2Renderer.render(V2Renderer.java:54)
                at com.atlassian.renderer.v2.V2RendererFacade.convertWikiToXHtml(V2RendererFacade.java:57)
        
        1. Apr 19, 2006

          Othman Alaoui says:

          sorry should have given this info: I am using Confluence 2.1.4 I installed t...

          sorry should have given this info:

          • I am using Confluence 2.1.4
          • I installed the plugin through the built-in plugin manager
          • the page containing the pagetree macro displays "Loading ..." and never updates
          • I am using the built-in left navigation theme, which includes my Navigation page which uses pagetree. This left navigation side bar is where the NPE shows up: "Error rendering macro: java.lang.NullPointerException."
          1. Apr 19, 2006

            Othman Alaoui says:

            Just saw your note above: If you just see a message "Loading..." and nothing els...

            Just saw your note above:

            If you just see a message "Loading..." and nothing else, make sure you have Base URL correctly set in your General Configuration settings.

            That fixed the stuck "Loading..." problem. Thanks. Still getting NPE on leftnav however.

            1. Apr 28, 2006

              Guy Fraser says:

              We'll be looking in to this error shortly after we release Builder theme v1.6 (n...

              We'll be looking in to this error shortly after we release Builder theme v1.6 (next few days hopefully).

    12. Apr 24, 2006

      Brian Knorr says:

      Is there a way to set the pagetree so that by default the nodes are fully expand...

      Is there a way to set the pagetree so that by default the nodes are fully expanded?

       Thanks!

      1. Apr 28, 2006

        Guy Fraser says:

        Not at present - have you tried the {children} macro which can be set to list al...

        Not at present - have you tried the {children} macro which can be set to list all nodes initially (including excerpts, sorting, etc).

    13. Apr 28, 2006

      leung man chi says:

      I worry about the performance. if I have hundreds of pages on confluence, does i...

      I worry about the performance. if I have hundreds of pages on confluence, does it take very long to load PageTree. currently, i do have a slight performance decreased.

      if it is a AJAX based, it should be able to load in more wikis, only on-demand, if required

      1. Apr 28, 2006

        Guy Fraser says:

        It loads incrementally - that is to say, as you expand a branch, it goes to the ...

        It loads incrementally - that is to say, as you expand a branch, it goes to the server to load the next level without refreshing the page. It should be noted that the page tree waits until the page is loaded before loading the first level of content so placing it on a page does not impact performance of that page at all.

    14. May 13, 2006

      Christain Stovall says:

      The latest update is great (fixing the expand/collapse icon problem) however, th...

      The latest update is great (fixing the expand/collapse icon problem) however, the display in IE is a little wonky - there are huge gaps between the active page, the page beneath it and the next section in the tree (one level or more up than the section you're currently in). It almost appears as though pages are missing in the tree. Personally, I use Camino, but A LOT of people in our organization use IE - any ideas?

      Keep up the good work!
       

    15. Jun 06, 2006

      Graham Bakay says:

      The screenshot shows the Home page in the tree, but when I use the macro all the...

      The screenshot shows the Home page in the tree, but when I use the macro all the pages under the Home page appear as the top level of the tree. Is there any way to include the Home page as the top item in the tree?

      1. Jul 03, 2006

        Alain Moran says:

        The simplest option I can think of is to make your home page a child of another ...

        The simplest option I can think of is to make your home page a child of another page, and then point the pagetree at the root page.

    16. Jul 19, 2006

      Nikki Stokes says:

      Thank you for an excellent plugin.  Without this, I don't think we'd be con...

      Thank you for an excellent plugin.  Without this, I don't think we'd be considering moving to Confluence.

      I realise there's no way yet, but as suggested further up I would love to be able to set all to be expanded on load, or better yet to remember how the tree was last viewed.

      I would also like to be able to sort the children on a custom sort order - in my case, logical order. This might be difficult to implement, but I was thinking that one way might be to use the metadata plugin, with the appropriate values on each page. A bugger to maintain, though...

      1. Jul 20, 2006

        Alain Moran says:

        Its possible to do with a hack to the current codebase but will create horrific ...

        Its possible to do with a hack to the current codebase but will create horrific traffic-storms with the server.

        The way that pagetree works is that it loads the data for each 'level' from the client-side, only one level at a time is loaded (to cut down on the amount of data passed to/from the server). This will mean that a transaction between the client and the server would occur for each page in your site ... Not so much a problem when you have a 3 page site, but I dare say yours is probably going to be a little more extensive than that

        I would say that there is a better solution for that kind of application, probably something along the lines of pre-generating the <ul>/<li> lists that pagetree uses for retrieving/displaying the data, however I'd have to do some digging to find that out for sure.

    17. Jul 24, 2006

      Rajendra says:

      Alain, After installing Pagtree Plugin if you click on link "Ajax Pagetree" in ...

      Alain,

      After installing Pagtree Plugin if you click on link "Ajax Pagetree" in plugins listing, it displays following link under section "Installed Plugin Modules"

      This plugin is enabled (Disable) and is configurable.

      If I click on link "configurable", it displays alert "Enter URL here". Not sure how one can enter url here.

      Any suggestions ?

      -
      Rajendra 

      1. Jul 24, 2006

        Alain Moran says:

        Thats odd ... on my local box (confluence 2.2.4) there is no configure option in...

        Thats odd ... on my local box (confluence 2.2.4) there is no configure option in the standard plugins.action

        What version of confluence are you seeing this on?

        Are you seeing this in plugins.action, or in repository/plugins.action?

        AFAIK page-tree is only configurable through the macro, any other configure options should be ignored.

    18. Jul 26, 2006

      YangZD says:

      I love this Plugin,but it seem to have any bug working with chinese!pagetreeerro...

      I love this Plugin,but it seem to have any bug working with chinese!pagetreeerror.JPG!
       
      PageTreeError

      1. Jul 26, 2006

        Alain Moran says:

        You could try switching to using the bitwise sorting method, I'm guessing that i...

        You could try switching to using the bitwise sorting method, I'm guessing that it's a problem with the natural sort algorithm, and given that you are pre-fixing your numbers the traditional sort should work fine for you.

        1. Jul 27, 2006

          YangZD says:

          I had tried switching to bitwise and creation and modified,but it seem to keep e...

          I had tried switching to bitwise and creation and modified,but it seem to keep error also

          1. Jul 27, 2006

            Alain Moran says:

            Oooh, thats most odd ... could you please send a copy of the HTML source that it...

            Oooh, thats most odd ... could you please send a copy of the HTML source that it is generating to support at adaptavist dot com

      2. Jul 28, 2006

        Guy Fraser says:

        The bug appears to have been in Confluence: http://jira.atlassian.com/browse/CON...

        The bug appears to have been in Confluence: http://jira.atlassian.com/browse/CONF-5872

        Please upgrade to Confluence 2.2.7 and let us know if that solves the problem. If there is still a problem on the pagetree macro, could you let us know if browse space > site map works ok on Confluence 2.2.7

        1. Jul 31, 2006

          YangZD says:

          Great!!! I had upgraded to 2.2.7 and pagetree running fine,thank you...

          Great!!! I had upgraded to 2.2.7 and pagetree running fine,thank you very much

    19. Aug 26, 2006

      Bhavin Turakhia says:

      i tried this plugin out. i have two issues 1. when i specify root=Home ... the ...

      i tried this plugin out. i have two issues

      1. when i specify root=Home ... the "Home" page itself does not appear in the tree rendered. Our Home page may have content and so there should be a way to browse to it from the tree

      2. is there anyway to specify the "space" as the root instead of the home page? 

    20. Aug 27, 2006

      Bhavin Turakhia says:

      i am trying to improve the PageTree macro to show a tree for any page inside a S...

      i am trying to improve the PageTree macro to show a tree for any page inside a Space and not just the home page. For that i need a way in velocity to get all the ROOT level pages of the space of the current page that the user is browsing. i am using the routine below - however it is not too efficient because it needs to iterate through EVERY page in the space.

      #foreach ($child in $page.space.pages)
         #if ($child.isRootLevel())
           #callMyMacroHere($child)
        #end
      #end

      In the API docs I could not find a function called Space->getRootPages() or some equivalent. Can someone tell me if there is a BETTER way of getting all the root level pages of a space

      - Bhavin

      1. Sep 05, 2006

        Alain Moran says:

        thats a pretty scary piece of code ... in a space with thousands of pages you co...

        thats a pretty scary piece of code ... in a space with thousands of pages you could easily tie up the server for quite a while with that one!

        I'm not sure, but if you retrieve the SpaceDescription CEO, are the root pages of the site attached to that as children?

    21. Sep 20, 2006

      YangZD says:

      It seem to have any bug work with macro "section","column"

      It seem to have any bug work with macro "section","column"

      1. Sep 20, 2006

        Alain Moran says:

        Could you elaborate please? What happens when you use pagetree in conjunction w...

        Could you elaborate please?

        What happens when you use pagetree in conjunction with section & column macros that is giving you problems?

        1. Sep 20, 2006

          YangZD says:

          Conflunce 2.2.7 PrintScreen source {section} {column:width=30%}Some stuff goe...

          Conflunce 2.2.7
          PrintScreen

          source
          {section}
          {column:width=30%}Some stuff goes here
          {column}
          {column:width=70%}Some more stuff goes here
          {column}
          {section}
          
          page.vmd
          ## PAGE SPECIFIC DECORATOR
          ## Here the context is the page. Modes are 'view', 'edit', 'edit-preview', 'view-information', and 'view-attachments'.
          
          
          #set ($helper = $params.get("helper"))
          #set ($mode = $params.get("mode"))
          #set ($confPage = $helper.page)
          #set ($infoPanelWidth = $params.get("infopanel-width"))
          
          #infoPanelInitFromParams()
          ## GENERAL PAGE DECORATING BEGINS
          
          <table border="0" cellpadding="0" cellspacing="0" width="100%">
          
          #if ($action.isPrintableVersion() == false)
              <tr>
                  <td>
                      <div class="greynavbar">
                          <span style="float:right; padding: 6px 10px 4px 0px">
          					#spaceActionLinks()
          				</span>
          
          				<ul id="foldertab" style="margin-bottom: 0px; padding-top: 10px;">
          					#foreach ($item in $action.webInterfaceManager.getDisplayableItems("system.page", $action.remoteUser, $helper))
          						<li><a #if ($item.link.id) id="$item.link.id" #end href="$item.link.getDisplayableUrl($req, $helper)" #if ($mode == $item.key) class="current" #end #if ($mode == "edit") onClick="javascript:saveDraftOnPageChange(this); return false;" #end #if ($item.link.hasAccessKey()) accessKey="$item.link.getAccessKey($helper)"#end>$item.label.getDisplayableLabel($req, $helper)</a></li>
          					#end
          				</ul>
                      </div>
                  </td>
              </tr>
          #end
              <tr>
                  <td valign="top" class="pagebody">
          
                      ## MODE SPECIFIC DECORATING BEGINS
                      <table width="100%" cellpadding="0" cellspacing="0" border="0" style="clear: both">
                          <tr>
                              <td width='100%' class="pagecontent" valign="top">
          
                              #parse ("/template/includes/actionerrors.vm")
          
                              #*
                                  Display page based on mode: currently 'view', 'edit', 'preview-edit', 'info' and 'attachments.
                                  See the individual page templates (viewpage.vm, editpage.vm, etc.) for the setting of the mode parameter.
                              *#
                              ## VIEW
                              #if ($mode == "view")
                                      #set ($labelable = $page)
                                      #permitSearchEngines()
                                      <table width="100%" style="margin-bottom: 5px" cellspacing="0">
                                          <tr>
                                              <td align="left" valign="top">
                                                  <span class="smalltext">
                                                      #editReport()
                                                      #parse ("/labels/labels-include.vm")
                                                  </span>
                                              </td>
                                              <td align="right" valign="top">
                                                  #if(!$action.anonymousUser && !$action.isPrintableVersion())
                                                      <div style="padding: 5px; width: 40px; border: 1px solid #cccccc; margin: 0px"><center>#favouriteLink()#watchLink()</center></div>
                                                  #end
                                              </td>
                                          </tr>
                                      </table>
          
                                      #if ($helper.isHistoricalVersion())
                                          #versionInfo()
                                          <content tag="suppressPdfLink">true</content>
                                      #end
          
          #if ($action.isPrintableVersion() == false)
          <style>
          .spacetree * ul{
          padding-left:0px;
          margin-left: 0px;
          }
          .spacetree * li{
          margin-left: 5px;
          padding-left:5px;
          }
          
          </style>
          <table>
          <tr>
          <td valign="top" align="left" width="22%" >
          <div class="tabletitle">Space Map</div>
          <div class="spacetree">
          #includePage($helper.spaceKey "TreeNavigation")
          </div>
          </td>
          <td valign="top" align="left" width="78%">
          <div class="wiki-content">
          <blockquote>
          $body
          </blockquote>
          </div>
          </td>
          </tr>
          </table>
          #else
          <div class="wiki-content">
              $body
          </div>
          #end
                                      #trackbackRdf ($trackbackUtils.getContentIdentifier($page) $page.title $trackbackUtils.getPingUrl($page))
          
                                      #renderChildren()
          
                                      #renderComments()
          
                              ## EDIT || PREVIEW-EDIT
                              #elseif ($mode == "edit" || $mode == "edit-preview")
                                  $body
          
                              ## INFO
                              #elseif ($mode == "view-information")
                                  $body
          
                              ## ATTACHMENTS
                              #elseif ($mode == "view-attachments" || $mode == "move-attachments")
                                  $body
                              #end
                              </td>
          
          
                              ## INFO PANEL FOR ANY PAGE
                              #if ($infoPanelRequired == true)
                                  <td valign="top" id="helptd" style="display:block; width:$infoPanelWidth;">
                                      #infoPanel(true true true true)
                                  </td>
                              #end
                      </tr>
                  </table>
          
                  ## MODE SPECIFIC DECORATING ENDS
          
                  </td>
              </tr>
          </table>
          ## GENERAL PAGE DECORATING ENDS
          
          #set ($viewingPageInfo = $params.get('viewingPageInfo'))
          #parse ("/pages/page-breadcrumbs.vm")
          
          
          1. Sep 22, 2006

            Alain Moran says:

            And what is the nature of the problem? IE: What is the page supposed to look li...

            And what is the nature of the problem?

            IE: What is the page supposed to look like?

            1. Sep 24, 2006

              YangZD says:

              pagetree change the page layout PrintScreen  wiki {section} {column:width...

              pagetree change the page layout

              PrintScreen 

              wiki
              {section}
              {column:width=50%}Some stuff goes here
              {column}
              {column:width=50%}Some more stuff goes here
              {column}
              {section}
              1. Sep 25, 2006

                Alain Moran says:

                I highly reccomend using the Firefox CSSViewer which allows you to 'see' where t...

                I highly reccomend using the Firefox CSSViewer which allows you to 'see' where the borders of divs and tables are landing ... my guess is that this problem is less caused by pagetree and more caused by your changes to the page.vmd

                My best guess would be to add a width=100% to the wiki-content div, and remove the blockquote around the content itself.

                1. Sep 25, 2006

                  YangZD says:

                  My page.vmd is follow suggestion in this page,so how can I do for page.vmd Ser...

                  My page.vmd is follow suggestion in this page,so how can I do for page.vmd

                  Serving suggestion :

                  Make the following modification to the page decorator ( this is for v 1.4.4 ) - replace :

                  1. Sep 25, 2006

                    Alain Moran says:

                    That serving suggestion has nothing to do with me, and it should be noted that i...

                    That serving suggestion has nothing to do with me, and it should be noted that it was designed for modifying the decorators that came with confluence 1.4.4.

                    My own serving suggestion to achieve the same effect would be to install Builder 2.0, go into theme config, switch on the left sidebar and enter {pagetree} into it ... you edit your decorators entirely at your own risk!

                    I should be free for Velocity consultancy work some time in late september, however it's likely that purchasing the builder theme will prove to be the more cost-effective option.

    22. Oct 23, 2006

      Niko says:

      Hi, the PageTree plugin on my Confluence site looks perfect in Firefox, but in M...

      Hi, the PageTree plugin on my Confluence site looks perfect in Firefox, but in Microsoft Internet Explorer (IE) there are empty lines between some expanded nodes in the tree. Any idea how to solve this ? Thanks !

      1. Oct 23, 2006

        Alain Moran says:

        Which version of pagetree are you using, also which version of IE does this ocur...

        Which version of pagetree are you using, also which version of IE does this ocurr in?
        Do the lines appear randomly or do they always appear by the same items?

    23. Nov 07, 2006

      Kelsey Grant says:

      Running in only some Spaces In your TreeNavigation page in the spaces you want ...

      Running in only some Spaces

      In your TreeNavigation page in the spaces you want to enable the page tree, make it like this:

      {pagetree:root=Home}
      {html}
      <script>
      __spacetree.style.display = "block";
      __spacetree.style.visibility = "visible";
      __spacetree.width = "18em";
      </script>
      {html}
      

      Then, in the main decorator, do this:

      #if ($action.isPrintableVersion() == false)
      <style>
      .spacetree * ul{
      padding-left:0px;
      margin-left: 0px;
      }
      .spacetree * li{
      margin-left: 5px;
      padding-left:5px;
      }
      
      </style>
      <table>
      <tr>
      <td id="__spacetree" valign="top" align="left" width="22%" style="display: none; visibility: hidden; border-right: 1px black dotted; padding-right: 1em">
      <div class="tabletitle">Space Map</div>
      <div class="spacetree">
      #includePage($helper.spaceKey "TreeNavigation")
      </div>
      </td>
      <td id="__content" valign="top" align="left" width="78%">
      <div class="wiki-content">
      $body
      </div>
      </td>
      </tr>
      </table>
      
      #else
      <div class="wiki-content">
          $body
      </div>
      #end
      

      Now the space tree will only be shown in spaces that do have a TreeNavigation page!

      1. Nov 08, 2006

        Kelsey Grant says:

        Edit: __spacetree.width = (document.all) ? "22%" : "18em"; Makes it IE com...

        Edit:

        __spacetree.width = (document.all) ? "22%" : "18em";
        
        

        Makes it IE compatible!

      2. Jun 12

        Tim McDougall says:

        This doesn't seem to work for Firefox browsers (or at least Firefox 3).  As...

        This doesn't seem to work for Firefox browsers (or at least Firefox 3).  As far as I can tell, the page include macro gets loaded before the main decorator code, and it doesn't ever set the visibility parameters.

        The javascript error states:  __spacetree is not defined, which occurs on:

        <script type="text/javascript">
        myspacetree.style.display = "table-cell";
        myspacetree.width = "250px";
        </script>
        

        It works great for all the other browsers (IE, Chrome, Safari), but Firefox just doesn't want to play nice...

        Anyone have an idea what might be going on?

    24. Feb 19, 2007

      Chris Hegan says:

      Does anyone know how IBM made the Space Map appear on the right-hand side of the...

      Does anyone know how IBM made the Space Map appear on the right-hand side of the page?

      1. Feb 19, 2007

        Guy Fraser says:

        Builder Theme 2.1 allows you to do stuff like [this|http://www.adaptavist.c...

        Builder Theme 2.1 allows you to do stuff like [this|http://www.adaptavist.com/display/USERGUIDE] and [this|http://www.adaptavist.com/display/Dashboard].

      2. Feb 20, 2007

        Alain Moran says:

        Do you have a link to an example page?

        Do you have a link to an example page?

        1. Feb 20, 2007

          Chris Hegan says:

          Actually, IBM does not appear to use Builder but they have also moved their Spac...

          Actually, IBM does not appear to use Builder but they have also moved their Space Map back to the other side of the page. I am guessing that it caused them problems, which PageTree can do in many mysterious ways.

          (It's still a great plug-in and worth a bit of grief occasionally.)

          1. Feb 21, 2007

            Alain Moran says:

            Heh ... adaptavist will soon be dropping support of {pagetree} within their prod...

            Heh ... adaptavist will soon be dropping support of {pagetree} within their products, since in all honesty it is slow, clunky and lacks a significant number of features.

            This will happen when {pagetree2} is released some time in the coming months, most likely as a part of builder 2.1 - it contains licensed library code so cannot be released open-source, but the feature-set should offset that.

            New features in {pagetree2}:

            • Commercial grade DHTML tree (library code)
            • Highly configurable 'look'
            • Insanely fast DWR2 data transport
            • More default tree roots available (dashboard, space, homepage, self, parent etc..)
            • Now displays news in the correct hierarchy
            • Drag/Drop of pages inside and between spaces
            • Arbitary sort order for pages
            • Integratable, expandable {pagepanel} that allows editing of various aspects of pages/spaces/site (its like a properties sheet that's controlled by the pagetree selection)

            You can see an example of {pagetree2} in our userguide

    25. Mar 22, 2007

      Mark Otting says:

      I like pagetree. It looks smooth, it works smooth, it's just plain slick. Since ...

      I like pagetree. It looks smooth, it works smooth, it's just plain slick. Since we have a number of spaces that go rather deep, I've added it to the nagivation pane as an optional navigation tool.

      However, since the pane is in the same page, the tree folds away whenever you open a page. What would be great is if the openend branches of the tree could be stored in the user's session. That way, whenever you re-enter the page, you'd see the tree in the same state it was when you last left (or reloaded) the page.

      1. Mar 22, 2007

        Alain Moran says:

        Go for it ... it's all yours I dont expect to be making any further changes to...

        Go for it ... it's all yours

        I dont expect to be making any further changes to pagetree, since builder 2.1 will include a new, very much improved pagetree, inventively called pagetree2.

        You can find the source here: http://svn.atlassian.com/svn/public/contrib/confluence/pagetree-plugin/trunk/

        1. Apr 03, 2007

          Chris Hegan says:

          I'm confused. You write above that Adaptavist are dropping support of pagetree w...

          I'm confused. You write above that Adaptavist are dropping support of pagetree within their products. Is this significant for those of us who are happy with your excellent product Confluence on its own?

          Then: This will happen when pagetree2 is released some time in the coming months, most likely as a part of builder 2.1.

          "Is released". By whom?  Our situation is that we use Confluence + page-tree and although page-tree has its problems its benefits greatly outweigh those.

          You work for Atlassian, don't you? So why would you stop working on this plug-in because another company is going to release a possibly better product but one with some very large strings attached - like having to use Builder, which seems to have more problems than page-tree and costs money. 

          I'm probably missing something. Can you help me out? We are in the process of making a very big commitment to Confuence + page-tree as a platform and this is affecting our planning.

          1. Apr 03, 2007

            Alain Moran says:

            Heh ... I think the piece of the puzzle that you are missing is that I work for ...

            Heh ... I think the piece of the puzzle that you are missing is that I work for Adaptavist not Atlassian!

            Thank you very much though, I will take it as a compliment that you were under that misunderstanding, I very much admire Atlassian and their products and am very happy to be associated with them.

            Adaptavist took responsibility for bringing pagetree to the state it is currently in because some of our customers wanted the functionality that pagetree offers ... we have now however developed a very much improved version of pagetree which I will be releasing with Builder 2.1, which in itself is a VERY much improved version of Builder ... a sexy Ext backend which allows you to manipulate the theme configuration of all of your spaces en-masse, 300% speed improvement on menu rendering, support for clustering, pagetree2 ... much goodness

            In case you're interested, here are the parameters available to pagetree2

            • rootpage - The root of the pagetree (defaults to @space)
              • SPACEKEY:pagename - a specific page in a specific space
              • pagename - a specific page 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
              • @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
            • space - the space that should be used for the root of this pagetree (optional)
            • page - the name of the page that should be use for the root of this pagetree (optional)
            • target - the target window that the pages should open into (eg. _blank or _self)
            • showIcons - whether to show icons in the tree (default true)
            • selectionMode - the default click selection mode: node (default) or row
            • autoCollapse - automatically collapse other nodes when a node is expanded: false (default) or true
            • indent - indent each layer of the tree: true (default) or false
            • showRoot - display the root node: true (default) or false
            • branchStyle - the branch style (may be deprecated in future release)
              • plus-lines: +/- buttons, dotted lines
              • 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
            • iconStyle - the icon style:
              • computer - computer style icons
              • website - website style icons
              • builder - Adaptavist's Builder style icons
              • bookshelf - bookshelf style icons
            • class - the css class to attach to the pagetree
            • openpage - open the selected page on click: true (default) or false
            • allowdrag - allow pages to be moved in the space/site by dragging and dropping in the tree: false (default) or true
            • treename - the name of the tree (used with pagepanel macro)
            • titletip - use the page title as the tooltip
          2. Apr 03, 2007

            Guy Fraser says:

            Hi Chris, Just to elaborate, the pagetree plugin was originally developed by Zo...

            Hi Chris,

            Just to elaborate, the pagetree plugin was originally developed by Zohar Melamed at BNP Parbais bank and was only compatible with Confluence 1.x. Because a lot of our Theme Builder plugin clients were using it, and because it's open source, we decided to make some upgrades to it so that it could be used on more recent versions of Confluence (there were API changes, etc). However, the underlying architecture of the pagetree plugin is timeconsuming to maintain (primarily due to it being developed back in the days of Confluence 1.x) so we've now developed our own version from scratch as part of our Theme Builder 2.1 (not yet released) plugin. Because we're using a commercial tree component, we're unable to release our version as open source due to licensing issues.

            Guy

            1. Apr 05, 2007

              Chris Hegan says:

              Just a quick note to thank you for the attention you've given this. We have look...

              Just a quick note to thank you for the attention you've given this. We have looked pretty hard at the new pagetree and Builder and have decided to take advantage of this product to enhance our use of Confluence. Our customers deserve it.

    26. Apr 20, 2007

      Alan Mosely says:

      Hi, I was wondering if in the next version of pagetree to be released with Buil...

      Hi,

      I was wondering if in the next version of pagetree to be released with Builder 2.1 you could include the ability to increase the spacing between items listed in the page listings?

      Regards,

      1. Apr 20, 2007

        Alain Moran says:

        You should be able to do this with css in either the existing version or the new...

        You should be able to do this with css in either the existing version or the new one.

    27. Apr 23, 2007

      Alan Mosely says:

      Thx, I am new to CSS and was wondering what selector I had to use to modify the ...

      Thx, I am new to CSS and was wondering what selector I had to use to modify the pagetree. I have tried all the obvious ones (ie tree, pagetree, spacetree) but cannot find the correct value. It works if I use "li" but I do not want to affect all the lists on the page.

      Is there a list of all the selectors for Builder macros, elements available (other than the main layout elements)?

      1. Apr 23, 2007

        Alain Moran says:

        the old pagetree hasnt had so much attention to classnames as the new, but you c...

        the old pagetree hasnt had so much attention to classnames as the new, but you can work around that by wraping it in a div, eg:

        {style}
        .mypagetree li {
        margin-bottom:10px;
        }
        {style}
        
        {div:class=mypagetree}{pagetree}{div}
        
        1. Apr 23, 2007

          Alan Mosely says:

          Thanks alot for your help, I must say I'm looking forward to your next release

          Thanks alot for your help, I must say I'm looking forward to your next release

    28. Apr 25, 2007

      Bill Burge says:

      Is there a way to do a Pagetree of a different root then your own? I'm setting ...

      Is there a way to do a Pagetree of a different root then your own?

      I'm setting up a Home Page for my department, and there is another department's documentation in one hierarchy specifically that I would like to have listed on our home page.

       I assumed there would be some way for me to specify root at ..\ or Dashboard or something and list the full path.  This does not, however, appear to be the case.

      1. Apr 25, 2007

        Alain Moran says:

        This is not possible with the existing pagetree, you would need to use pagetree2...

        This is not possible with the existing pagetree, you would need to use pagetree2 for this.

        Pagetree2 will be released as part of builder 2.1 since it contains commercial (licensed) libraries, however we make it available to existing Builder license holders in the mean-time.

        1. Aug 28, 2007

          Robert Tosch says:

          I'm very interested in pagetree2. But I've seen that builder 2.1/3.0 has not bee...

          I'm very interested in pagetree2. But I've seen that builder 2.1/3.0 has not been released yet.

          Is there a possibility to get the pagetree2 macro now or do I have to wait for the 3.0 release?

          1. Aug 28, 2007

            Alain Moran says:

            You can sign-up for the 3.0 beta programme by creating an issue on support.adapt...

            You can sign-up for the 3.0 beta programme by creating an issue on support.adaptavist.com containing a copy of the license email that was sent out when you purchased builder.

            3.0 is getting fairly stable now, so we are opening the programme up to all of our existing licensees. If you arent already a license holder then depending on whether you are an enterprise scale customer or not you should either sign up now or wait until the licensing model changes when it's finally released

    29. May 13, 2007

      mabel hwa says:

      Hi all,  This is my first time using confluence and so i am pretty new to ...

      Hi all,

       This is my first time using confluence and so i am pretty new to the stuff here. I find that this feature is pretty useful as i have so many links to organise under different categories within one page. However, i don't have the admin rights to any of the confluence folder and so installing plugin is kind of impossible for me. Are there other alternatives such as coding using Wiki Markup rather than using the plugin?

       Thanks!

      1. May 14, 2007

        Guy Fraser says:

        You can use {children:all=true} to get a similar hierarchical list of links.

        You can use {children:all=true} to get a similar hierarchical list of links.

        1. May 14, 2007

          mabel hwa says:

          hi can i still expand and collapse the bullets when using this? Thanks!

          hi

          can i still expand and collapse the bullets when using this? Thanks!

          1. May 14, 2007

            NooN Yuki says:

            yes. And to beautify it, you can use this code in a panel. {panel:borderStyle...

            yes. And to beautify it, you can use this code in a panel.

            {panel:borderStyle='2px dashed'|borderColor=purple}
            {children:all=true}
            {panel}
            
    30. May 15, 2007

      mabel hwa says:

      sorry, i desperately need some help here....my adminstrator has this plugin inst...

      sorry, i desperately need some help here....my adminstrator has this plugin installed but i have no idea on how to use it...i am only using it to do a simple contents page which is a combination of different pages instead of all pages in a single space.

      for example:

      when it collapse
      +about us

      when it expands
      -about us
         Introduction
         Background

       anyone can help pls? thanks

      1. May 15, 2007

        NooN Yuki says:

        hi Mabel, This is really easy. {panel:borderStyle='2px dashed'|borderColor=b...

        hi Mabel,

        This is really easy.

        {panel:borderStyle='2px dashed'|borderColor=black}
        {pagetree:root=PageName}
        {panel}
        

        in pagename, you can either point to your space home page in this format 'spacekey:Home'
        However, this code will not show up anything if it has no child page under your space currently.
        if you are using your organization's confluence, usually the notation help is on the right panel when you are in Wiki Markup tab. Usually all the installed macros are there.

        1. May 15, 2007

          mabel hwa says:

          hi, greatly appreciate your help. i have tried to put name of the page i am wor...

          hi,

          greatly appreciate your help. i have tried to put name of the page i am working on in the PageName but nothing was displayed.

          pagetree:root=Contents Page

          I think i do have a few child pages linked to the contents page if my interpretation of child page is not wrong. my understanding of child page is that the contents page is link to other pages...am i right abt it? Thanks

    31. Jun 18, 2007

      hernan g says:

      sorry sorry sorry.. I am sure 1000's have asked and got answers before, I just c...

      sorry sorry sorry.. I am sure 1000's have asked and got answers before, I just couldn't find any.

      I am setting up confluence, and thought it would make it easier for new users to navigate the wiki if they had the tree in there face all the time. not just the Atlasian children list (I don't know why they can't make that a full tree).

      But the sample code you give is to put on the page, which makes the tree disapear of course the second the user click on a link and goes to that page. How or where do I put code to consistently have the tree *always* as long as the user is in a namesapce or even globally?

      thanks. 

      1. Jun 22, 2007

        Guy Fraser says:

        If using the Theme Builder plugin you can simply put the macro in to a sidebar o...

        If using the Theme Builder plugin you can simply put the macro in to a sidebar or footer panel. If using the default Confluence theme you can edit the velocity templates to get the pagetree to appear as shown near the top of this page.

    32. Jun 26, 2007

      Ben Nichols says:

      Hey guys,  I am using Confluence 2.5.4, and the Top and Left Sidebar navig...

      Hey guys,

       I am using Confluence 2.5.4, and the Top and Left Sidebar navigation (2nd version) theme. Whenever I use the
      pagetree tag in the Navigation page, it gives me a weird looking pagetree on the left bar. Each page name gets its own
      line, making it really hard to use. Check out the pic:

      1. Oct 23, 2007

        Mark says:

        I'm having the same issue, Top / Left Navigation theme. All my pagetree navs ar...

        I'm having the same issue, Top / Left Navigation theme.

        All my pagetree navs are hosed and look very bad. 

      2. Oct 26, 2007

        kxi says:

        I am using confluence 2.6.  Having the same issue.  The page tree does...

        I am using confluence 2.6.  Having the same issue.  The page tree doesn't display correctly.

        1. Oct 30, 2007

          Helene says:

          I get the same issue with this, and a similar formatting issue inconsi...

          I get the same issue with this, and a similar formatting issue inconsistency between left-nav and page view.

          For this, I've created a bug:  

          http://jira.atlassian.com/browse/CONF-9850

          Please vote for my bug, because I think that this issue is bigger than the pagetree plugin.

    33. Jul 24, 2007

      Brad Johnson says:

      After utilizing this plugin for about 6-8 months, yesterday I started receiving ...

      After utilizing this plugin for about 6-8 months, yesterday I started receiving an unknown macro error.   I then went into our confluence instance plugin repository to see if it had to be installed again or if something strange had happened. When I attempt to install this plugin, I receive the following error message:

       The following error(s) occurred:

          * Plugin [bnpparibas.confluence.pagetree] File Not Found: http://svn.atlassian.com/svn/public/contrib/confluence/pagetree-plugin/trunk/target/pagetree1.3.jar

      Any ideas? 

      1. Jul 24, 2007

        David Peterson [CustomWare] says:

        Sorry - that's my fault. I moved the jars and neglected to check in the updated ...

        Sorry - that's my fault. I moved the jars and neglected to check in the updated locations into the repository. It should update within an hour, but if you need the plugin in the meantime, download and install it manually from here:

        http://svn.atlassian.com/svn/public/contrib/confluence/pagetree-plugin/jars/pagetree1.3.jar

        1. Jul 24, 2007

          David Peterson [CustomWare] says:

          Although, I'm not sure why it would have uninstalled itself on your server - tha...

          Although, I'm not sure why it would have uninstalled itself on your server - that's not effected by changes in the repository...

          1. Jul 24, 2007

            Brad Johnson says:

            Well... not sure, but when I re-installed the plugin via the repository, it work...

            Well... not sure, but when I re-installed the plugin via the repository, it works fine again... Thanks.

    34. Dec 03, 2007

      Naima Shaikh says:

      This is a wonderful plugin.  I am having the same issue mentioned earlier o...

      This is a wonderful plugin.  I am having the same issue mentioned earlier of blank lines appearing after the selected node - but only in IE.  I've tried the suggestion of specifying the width, but no luck.  Has anyone resolved it?  I'm on 2.5.7.

       Thanks in advance.

      -naima 

    35. Dec 06, 2007

      Jon Hertzig says:

      We were wanting the pagetree to display in a navigation frame, the way Atlassian...

      We were wanting the pagetree to display in a navigation frame, the way Atlassian suggests here: http://confluence.atlassian.com/pages/viewpage.action?pageId=96076078 - Except have the tree and search box work only for a single document (hierarchical group of pages), when there are several documents in the same space (rather than having to make a single space for each document).

      The solution was a user macro, like this:

      {section}
      {column:width=20%}
      {panel:title=[$param0]}
      {pagetreesearch:root=$param0}
      {pagetree:root=$param0}
      {panel}
      {column}
      {column:width=80%}
      {scrollbar}
      $body
      {scrollbar}
      {column}
      {section}
      

      Then, for each page:

      {<macroname>:<root page>}
      
      
      <page content>
      
      {<macroname>}
      

      Works like a charm!

      1. Dec 12, 2007

        Jon Hertzig says:

        ... There is one issue, however: export to PDF. Need a way to prevent the colum...

        ... There is one issue, however: export to PDF. Need a way to prevent the column that includes the pagetree from exporting. I've tried the 'no-export' macro, to no avail. (screws up the formatting, whether the tree is in columns or a table)  The workaround is to temporarily edit the tree macro to get rid fo the tree part of it, when you export -- but it would be a lot nicer not to have to do that!

        Any suggestions??

    36. Jan 07, 2008

      Bob Swift says:

      Does this work on 2.7? It seems to be displaying properly, but, when re-indexed...

      Does this work on 2.7? It seems to be displaying properly, but, when re-indexed my site, there were some pagetree errors in the log.

      Plugin module com.atlassian.confluence.plugins.pagetreesearch:PageHierarchyExtractor is incompatible with this version of Confluence. You will need to upgrade to a newer version of the Pagetree Search plugin. java.lang.NoSuchMethodError: org.apache.lucene.document.Field.Text(Ljava/lang/String;Ljava/lang/String;)Lorg/apache/lucene/document/Field;
      

      What does such an error affect?

      Sorry - wrong plugin/page! See new comment

      1. Jan 06, 2008

        Roberto Dominguez says:

        Don't think is going to work on 2.7 yet... it will require a new binary. See htt...

        Don't think is going to work on 2.7 yet... it will require a new binary. See http://forums.atlassian.com/thread.jspa?threadID=21588&tstart=30

      2. Jan 06, 2008

        Shannon Krebs says:

        I think you meant to leave the comment on page tree search plugin page, not the ...

        I think you meant to leave the comment on page tree search plugin page, not the page tree plugin page...

        http://confluence.atlassian.com/display/CONFEXT/Pagetree+Search+Plugin

        But Roberto is correct, a new version of the search plugin is needed for conf 2.7 (and I believe the change has already been made in svn it just needs to be released properly).

    37. Mar 30, 2008

      gaurav says:

      Hi all, I hv just started to work on confluence . I m using {pagetree} m...

      Hi all,
      I hv just started to work on confluence . I m using

      {pagetree}

      macro it shows the tree. but it shows the page tree per page level wise then i hv to click on + sign to see the child pages . now i hv to show all page tree in expanded format at initial only . can you all guide me how to achive that.
      Thnks in advanced

      1. Mar 31, 2008

        Alain Moran says:

        Use the children macro and dress it up with css. {children:all=true} You...

        Use the children macro and dress it up with css.

        {children:all=true}
        

        You may wish to wrap that in a {cache} macro

        1. Mar 31, 2008

          Mark says:

          PS - if you use macro, when you navigate a sub-page of the tree, the tree wil...

          PS - if you use

          macro, when you navigate a sub-page of the tree, the tree will not stay open, so nested navigation on 2+ levels down becomes tedious as you have to keep opening back up (hitting + sign) the lower levels.

    38. Apr 08, 2008

      Mike says:

      Hi there, Sorry to interrupt you guys cos I gotta admit I'm a no...

      Hi there,

      Sorry to interrupt you guys cos I gotta admit I'm a noob in Confluence.

      I'm using Confluence 2.7 and have manually installed the pagetree plugin, created the Tree Navigation and changed the codes as shown in this page:

      http://confluence.atlassian.com/pages/viewpage.action?pageId=96076078.

      Instead of showing the normal pagetree, I encountered this problem:

       
      
       org.apache.velocity.exception.MethodInvocationException: Invocation of method 'getPermittedChildren' in
       class com.adaptavist.confluence.naturalchildren.NaturalChildrenAction threw exception class
      java.lang.NoClassDefFoundError : com/atlassian/confluence/pages/ChildPositionComparator
       at org.apache.velocity.runtime.parser.node.ASTMethod.execute(ASTMethod.java:309)
      caused by: java.lang.NoClassDefFoundError: com/atlassian/confluence/pages/ChildPositionComparator
       at com.adaptavist.confluence.naturalchildren.NaturalChildrenAction.getPermittedChildren(NaturalChildrenAction.java:94)
      

      and there are a lot of chunky codes beneath but I suspect the block of codes above is the main problem. I don't quite understand why the pagetree plugin doesn't work even though I've installed it successfully... is there a way to rectify it???

      Thanks

      1. Jun 18, 2008

        Liam Jones says:

        I experienced this error too when testing an upgrade of 2.6.0 to 2.8.1. An unins...

        I experienced this error too when testing an upgrade of 2.6.0 to 2.8.1. An uninstall and reinstall of the plugin fixed it for me.

    39. Apr 08, 2008

      Anitha Raghavan says:

      Hi, I'm using confluence 2.7 and would like to get a display of all spaces and ...

      Hi,

      I'm using confluence 2.7 and would like to get a display of all spaces and pages within that space as pagetree heirarchy. Is there any way, i can do that using pagetree macro?

      Space1

      • page 1
      • page 2

      Space 2

      • Page 1
      • page2

      Thanks,

      Anitha

    40. May 13, 2008

      Paul Csapo says:

      Dear Alain & developers, I tried viewing a page anonymously, and the page-tr...

      Dear Alain & developers,
      I tried viewing a page anonymously, and the page-tree still allowed me to move (re-locate) a page.

      Is this supposed to happen, and can it be prevented so that only people with edit permissions can move pages around?

      kind regards,
      Paul

      1. May 13, 2008

        Alain Moran says:

        I am no-longer involved in the maintenance of this plugin, IIRC atlassian have t...

        I am no-longer involved in the maintenance of this plugin, IIRC atlassian have taken over its development since we switched to using pagetree2

        1. May 20, 2008

          Mark says:

          Thanks Alain. I'm realizing how vital this plugin is now that it broke in 2.8...

          Thanks Alain. I'm realizing how vital this plugin is now that it broke in 2.8!
          Who is IIRC Atlassian, is there a new page or JIRA area where we can work with them on these issues.

          1. May 22, 2008

            Alain Moran says:

            This would be the correct location, or http://support.atlassian.com ... I only r...

            This would be the correct location, or http://support.atlassian.com ... I only replied because you mentioned me in your initial post

            One workaround might be to install the builder plugin (don't worry it doesn't need to be licensed for this to work), and use the pagetree2 macro instead.

            http://www.adaptavist.com/display/builder/pagetree2+macro

            I would generally recommend the following markup if you want to to drag/drop pages

            {pagetree2:openpage=false|allowdrag=true}

            1. May 26, 2008

              Mark says:

              Thanks Alain! I've done this and it appears to work (BT 3.0 with C 2.8) I'm...

              Thanks Alain!
              I've done this and it appears to work (BT 3.0 with C 2.8)

              I'm using:

              {pagetree2:allowdrag=true\|showRoot=false\|initialDepth=2}

              Only thing is that the tree won't stay open, it always defaults back to all collapsed and highlighing "Navigation" which is a page at the root which builds this left nav.
              Am I doing something wrong?

      2. May 27, 2008

        Paul Csapo says:

        Is anyone else able to try some anonymous tests to see if it lets them move page...

        Is anyone else able to try some anonymous tests to see if it lets them move pages?
        If someone is able to verify this, that would be great.

        At the moment, it seems as though any anonymous viewer can move pages around via this plugin, even when the Space only allows "anonymous viewing"?

        thanks,
        Paul

    41. Jun 18, 2008

      Colin J. Mann says:

      Great plugin, although the startDepth functionality doesn't appear to work. Is a...

      Great plugin, although the startDepth functionality doesn't appear to work. Is anyone aware of this, because I cannot see it being logged as an outstanding issue. We are using Confluence 2.8.0.

    42. Jun 29, 2008

      Wang Jinxing says:

      I have 2 questions. Please review the two picture. The pic1 from "http://conflue...

      I have 2 questions. Please review the two picture. The pic1 from "http://confluence.atlassian.com" and pic2 from my localhost.

      1. How to set interval between view page and coding page. Please refer to red rectangle in pic1 and pic2, pic1 has good effect of interval, but pic2's has no interval. I want to set interval of pic2 as same as pic1.
      2. How to set web width. No matter how long of the string in pic1, the width of pic1 does not change. However, the width of page in pic2 changes with the length of string in pic2. I want to solid the width of page in pic2 as same as pic1.

      1. Jul 06, 2008

        Andrew Townsend says:

        This one is pretty simple, you can find the answer by viewing the source of...

        This one is pretty simple, you can find the answer by viewing the source of the Confluence page. I also found the same thing after I installed so just figured it out =)

        In your page layout replace:

        <table cellspacing="0" cellspacing="0">

        With:

        <table cellspacing="2" cellpadding="5">

        I might propose an edit to the Confluence page, as it defines the spacing twice for no reason.

    43. Jul 09, 2008

      Shawn Stepper says:

      This plugin has apparently been hijacked in the repository by "BNP Paribas", at ...

      This plugin has apparently been hijacked in the repository by "BNP Paribas", at least for version 1.3. What's the deal? It's causing problems in the Plugin Repository.

    44. Jul 10, 2008

      Katherine Kahl says:

      Per the parameter description 'expandCollapseAll', I see that 'expand all', 'col...

      Per the parameter description 'expandCollapseAll', I see that 'expand all', 'collapse all' features are added but do not understand how to do this. Could you supply an example or more explanation.

      We need all nodes expanded initially for accessibility with screen readers.

    45. Jul 25, 2008

      David Jaramillo says:

      Hello, I am trying to make an offline copy of a complete wiki space as shown in ...

      Hello, I am trying to make an offline copy of a complete wiki space as shown in HTML. For this purpose I'm using httrack. The Problem I have is that the navigation tree, which is implemented with teh pagetree macro, is not displayed properly in the mirrored site. In httrack I use the travel mode option to "can go down". this because otherwise I get also other spaces and even the dashboard. Can anybody explain me which are the locations of all javascrips, ajax, etc, components that are required by the pagetree macro to work properly. Knowing the position of all required components I could possibly instruct httrack to mirror this components as well.

      Any help would be greatly appreciated.

      Kind regards,

      David

      1. Jul 31, 2008

        David Jaramillo says:

        .. still waiting.. hoping, that someone would help me on this matter.. no soluti...

        .. still waiting.. hoping, that someone would help me on this matter.. no solution has been found yet

    46. Jul 29, 2008

      Barbara Hass says:

      Hello, we have several spaces running wheras our 'wiki help pages' are kept in ...

      Hello,

      we have several spaces running wheras our 'wiki help pages' are kept in one space. We want the help pages to be seen in the navigation menu in all other spaces. How can we achieve this? How can we configure the pagetree macro to show page trees located in other spaces?

      We use this:

      {pagetree:root=Help}
      

      and get the page tree rendered:

      but this works only if the help pages are located in the same space. Any suggestions?
       
      Kind regards, 
      BArbara


      1. Aug 01, 2008

        Ming Giet Chong says:

        Hi Barbara, The PageTree plugin doesn't support this feature currently. However...

        Hi Barbara,

        The PageTree plugin doesn't support this feature currently. However, if you are keen to have this feature to be implemented, please feel free to raise a feature improvement request at the issue tracker here.

        Ideally, you can achieve this by using the Include Page Macro. It allows you to display the contents of one Confluence page in another.

        Hope this helps.

        Regards,
        MG