create new tag
, view all tags

TreeBrowserPluginDev Discussion: Page for developer collaboration, enhancement requests, patches and improved versions on TreeBrowserPlugin contributed by the TWikiCommunity.
• Please let us know what you think of this extension.
• For support, check the existing questions, or ask a new support question in the Support web!
• Please report bugs below
• See TreeBrowserPluginDevArchive for older discussions

TreeBrowserPlugin development

Known issues

Here we list the know issues not worth showing on the TreeBrowserPlugin page. See also TreeBrowserPlugin#Known_issues

NatSkin popup menu cursor focus bug when using overflow:hidden for natMainContents in FF2

Make sure overflow:hidden is not defined for natMainContents:

.natMainContents {

Root status management problem

When doing something like:

%TREEBROWSER{"thread" title="Root" shared="menudemo" noindent="on" autotoggle="on" style="dmenu"}%

The root shows and one can fold/unfold the entire tree from the root thanks to autotoggle. Yet since dtree was not designed for the root to be foldable it does not manage its status properly as with any other node.

Development discussion for TreeBrowserPlugin

-- ColeBeck - 25 Mar 2005

Uploaded a new release from SVN with 4.0.2 support, thanks for the patch Pavel smile

If there's problems with this in Cairo, r1.5 of TreeBrowserPlugin.zip can be used instead.

-- SteffenPoulsen - 12 Apr 2006

Steffen, thanks for updating the Plugin.

Any chance of coding it in a way to have one and the same package that works on Cairo and Dakar?

-- PeterThoeny - 14 Apr 2006

I had a play with TreeBrowserPlugin see TreePluginDev. I find it would be nice to have it fully themeable from the plugin topic. Right now one can only customize root icon, file icon, closed folder icon and open folder icon. The rest (+,-,lines... )being hard coded in the JavaScript.

-- StephaneLenclud - 30 Aug 2006

What would be really great too is to have optional buttons to collapse/expand all entries. It's part of the dtree API, just do something like that:

<a href="javascript: d.openAll();">open all</a> | <a href="javascript: d.closeAll();">close all</a>

-- StephaneLenclud - 31 Aug 2006

I find I have also minor rendering issues in FireFox. The original dtree implementation has no problem with FireFox. It seems like it's due to pattern skin CSS since it displays just fine when rendering using plain skin. I wonder what that can be?

-- StephaneLenclud - 31 Aug 2006

Ok it was due to line-height property. Patch soon to come.

-- StephaneLenclud - 01 Sep 2006

Here is a patch fixing line-height and empty anchor after node icon. It also enables uselines and closesamelevel parameter. See dtree documentation. dTree functionalities such as useStatusText, folderLinks, useSelection are broken due to the way TreeBrowserPlugin uses dTree. Therefore the Javascript could be simplified and/or slightly refactored to offer similar functionality in some other way. I will need to update the documentation.

Keep in mind when altering the Javascript that we don't use and don't want to use the url, title and target parameter from the dTree::add function. Instead we just pass raw html/twiki code using the name parameter. That's the reason why dTree's useStatusText, folderLinks, useSelection are broken.

-- StephaneLenclud - 02 Sep 2006

- file View.pm.patch cann't be found inside TreeBrowserPlugin.zip or inside ziptgz TreeBrowserPlugin.tgz - should dTree plugin a prerequisite ?

-- HaggaiST - 07 Sep 2006

Maybe View.pm.patch should be removed from the file list. I had no need to patch view.pm to get that plugin working.

-- StephaneLenclud - 08 Sep 2006

Hi, great plugin - I get lots of these messages filling up my apache log :

[Tue Sep 12 11:00:29 2006] view: Use of uninitialized value in substitution (s///) at /design/TWiki/twiki/lib/TWiki/Plugins/TreeBrowserPlugin.pm line 124.
[Tue Sep 12 11:00:29 2006] view: Use of uninitialized value in substitution (s///) at /design/TWiki/twiki/lib/TWiki/Plugins/TreeBrowserPlugin.pm line 126.
[Tue Sep 12 11:00:29 2006] view: Use of uninitialized value in substitution (s///) at /design/TWiki/twiki/lib/TWiki/Plugins/TreeBrowserPlugin.pm line 127.
[Tue Sep 12 11:00:29 2006] view: Use of uninitialized value in substitution (s///) at /design/TWiki/twiki/lib/TWiki/Plugins/TreeBrowserPlugin.pm line 128.
[Tue Sep 12 11:00:29 2006] view: Use of uninitialized value in substitution (s///) at /design/TWiki/twiki/lib/TWiki/Plugins/TreeBrowserPlugin.pm line 129.
[Tue Sep 12 11:00:29 2006] view: Use of uninitialized value in split at /design/TWiki/twiki/lib/TWiki/Plugins/TreeBrowserPlugin.pm line 130.

If it's not too much trouble, can these be cleaned up before the next release ? Many thanks, Steve.

-- SteveJonesST - 12 Sep 2006

Thanks Steve for reporting that. I think I just fixed them last weekend actually I just have to do a new release. I'll do my best to get it done soon. Just trying to get as much changes as I can in one release.

-- StephaneLenclud - 13 Sep 2006

When TreeBrowserPlugin sees a blank line between two items in a list, it stops parsing (and rendering).

One could argue "doon't put blank lines between list elements when feeding the list to TREEBROWSER". Unfortunately, I have n o control ovver TREEVIEW (TreePlugin) and it does occasionally insert blank lines.

Personally, I believe that TREEBROWSER should continue as long as the list continues. RenderListPlugin will continue through a list containing blank lines. And blank lines in a bullet list are useful for spacing and making the list easier to read..

Here is the example:

%TREEVIEW{web="%WEB%"  formatting="outline" format="* $topic" levelprefix="   "}%

  • output from TREEVIEW:

%TREEBROWSER{"file" title="%WEB%"}%
%TREEVIEW{web="%WEB%"  formatting="outline" format="* $topic" levelprefix="   "}%

  • Output from TREEVIEW passed through TREEBROWSER:
Note where the rendering stops.

-- VickiBrown - 14 Sep 2006

See my comments about that on TreePluginDev. One could argue that there is something wrong with those not rendered topics since their parents belong to another web. Moreover they don't show in alphabetical order as the others do. So maybe it's a good thing that they stand out; fixing the parent property of those topics should have them properly rendered by TreeBrowserPlugin.

I'm not planning to implement a fix for that any time soon. Although having an "ignore blank line" option in TreeBrowserPlugin would be nice to have. I still have to do a release for TreeBrowserPlugin.

-- StephaneLenclud - 15 Sep 2006

Check out the latest development of TreeBrowserPlugin on TreeBrowserDemoMenu The interresting tree is the one in the left bar. It renders without icons, lines or minus/plus signs and a simple click expands the node. In other words it behaves like your standard left bar menu on so many web sites.

-- StephaneLenclud - 18 Sep 2006

Hi all, I needed to display icons not only attached to this plugin topic, but also from other topics. So I made a patch to the icon: handling code
- if there is a "/" char in the icon name, the plugin leaves it alone, other it behaves as before. So now you can write

  • somefile.xls
Feel free to (or not to) include this patch to your (very useful) plugin.

-- JanFilipsky - 22 Sep 2006

Warning, important Sounds like a very useful patch Jan. I'll try to include that in a release at some point. Thanks for contributing. Patch for v0.7: v0.7patch.txt.

-- StephaneLenclud - 01 Oct 2006

Thanks to the developers for this wonderful plugin. However, it seems that there are many people (including me) who didn't successfully install this plugin's last version. ... /edit: Problem solved. Lesson: don't forget to turn the plugin on from configure ;). It's working now. Great!!

-- MikkoLaakso - 30 Oct 2006

Good to know someone has been trying out the latest version. Did many people forgot to configure ?!? wink

-- StephaneLenclud - 31 Oct 2006

The plugin was easy to install for me and works great. But... wink I want to use it in my WebLeftBar. All works fine until I close the browser. After reopen I expected the tree state to be saved in cookie and have tree expanded as it was before. Insdead I get the tree closed and need 1 to 3 extra clicks to get to the interesting link. I found out that cookie expires at end of session. Is it possible to set the expiration date different that cookie does not expire after closing the browser?

-- JacekZapotoczny - 09 Nov 2006

If the tree browser in my left navigation bar overshoots the width of the sidebar, the tree browser view is truncated. See the attached graphic:
How can I add a scrollbar in the sidebar so that users clicking the tree browser nodes can scroll right when the tree nodes are not visible full?

-- AlokNarula - 09 Nov 2006

How can I add all the tree browser code into a template and include the template in the WebLeftBar.txt. If I add the tree browser code into WebLeftBarWebsList.txt and include this file into my WebLeftBar.txt, the links don't work.

-- AlokNarula - 09 Nov 2006

I put tree browser code into one WebLeftBar topic and include it to the other webs WebLeftBar topics if needed. All works fine and there are no problems with links. AlokNarula, maybe your problem is with link definitions itself? BTW if you use the tree browser in leftmenu. Is the state of your tree remembered after closing the browser or the tree is closed after reopening it?

-- JacekZapotoczny - 09 Nov 2006

I don't think you can have scroll bar in the left bar since it's not a frame. Consider using "noindent". I wonder if it's possible to give children a different style and combine that with "noindent".

Have a look at that demo. You can't edit that page but you can see the code.

Warning, important Investigate and see if nodes and leafs have different CSS class name.

-- StephaneLenclud - 10 Nov 2006

Warning, important I'll be looking at the cookie thing as soon as I get a chance and see if I can add that as an option. In the meantime you should be able to use Firefox to save your session.

For your problem with the links not working you should be able to workaround that by doing something like: $web.$topic

Are you using that plug-in in combination with TreePlugin?

-- StephaneLenclud - 10 Nov 2006

I found an excellent way of creating a tree of all Webs via the FlexWebListPlugin. I use the following code in my WebLeftBarWebsList.txt and include this file into my WebLeftBar.txt. Each time I create a new Web, the web is shown in my Web tree.

   * *%MAKETEXT{"Webs"}%*
%TREEBROWSER{"file" title="" uselines="on" useplusminus="on" shared="y" noindent="off" nocss="off"}%
%FLEXWEBLIST{format="$indent   * [[$web.WebHome][$name]]$n"}%
<a href="javascript: y.openAll();">open all</a> | <a href="javascript: y.closeAll();">close all</a>

-- AlokNarula - 13 Dec 2006

SteveStark: Thanks for enhancing the plugin. This plugin is maintained in SVN. Please make sure the changes get rolled back into svn. Attach a diff here, or get involved with SVN (see ReadmeFirst and PluginsInSubversion.)

-- PeterThoeny - 19 Dec 2006

Ok, peter, i will study that when i have a bit of free time. right now i am trying to track a bug in this plugin

-- SteveStark - 19 Dec 2006

If %TREEBROWSER{...}% is placed before blanks (i.e. no list could be generated) the variable is displayed in the topic text. Is there a way to hide this code when there are no bullets?

-- MarijanaPrusina - 20 Dec 2006

Warning, important MarijanaPrusina: I can reproduce that bug this ought to be fixed. In the meantime you could possibly workaround that problem using some clever %IF%.

-- StephaneLenclud - 21 Dec 2006

I have installed TreeBrowserPlugin . It works fine when I construct a list manually, but will not work with % TOC % or with TreePlugin . It seems to have the problem with the theme. If I put in the parameter "tree" it will list a TOC fine but not with "file" or "org" or "dir". All of these same parameters work fine with a manual list. With a list generated from one of the above plugins, TreeBrowserPlugin supresses the entire list and nothing appears. I downloaded and reinstalled both TreePlugin and TreeBrowserPlugin and still the same results.

-- XochipalaValdez - 02 Feb 2007

XochipalaValdez: Interesting feedback. I just had a quick look at that for you. I got it working with TreePlugin and "file" theme on that demo page see the demo code and look at the last tree.

I'm not using the latest TreeBrowserPlugin on that server though but the latest I published which must be the second latest. Was something broken in the latest publish?

On IE7 it's also shows an extra blank line at the bottom of the tree?!?

-- StephaneLenclud - 16 Feb 2007

I tried all of the above including changing the script and still the TREEBROWSER command suppresses the list. It works fine when I manually create a list. I am in the process of upgrading to the latest version of TWiki. Maybe that will solve the problem.

-- XochipalaValdez - 20 Feb 2007

I'd think it should work on any of the 4.x What TWiki version were you using so far?

-- StephaneLenclud - 20 Feb 2007

I am using 4.0.5. I just tried it with a new installation of 4.1. Same results with both TREEVIEW and TOC.

-- XochipalaValdez - 20 Feb 2007

Weird! I'm afraid I don't have much time to look at that right now but I'm definitely planning to do a new release for that plug-in at some point. It's just low priority. Be patient.

Did you try using this version? I guess you did already smile

-- StephaneLenclud - 21 Feb 2007

I believe I did. I have tried both the zip and tgz packages on the main plugin page. Is this an older version?

-- XochipalaValdez - 22 Feb 2007

Yep the TGZ is the one I'm using successfully. The ZIP was posted by SteveStark and I never used it so far. In theory both should always be the same version but that's not the case at the moment. Some more demo of TREEBROWSER/TREEVIEW/TOC usage here. As you can see I got it working with %TOC% too. I still don't understand why I can't reproduce your problem. We must be using different version of the plugins or there is something wrong with your installation. Did you check your SettingFileAccessRightsLinuxUnix after installing the plugins?

-- StephaneLenclud - 23 Feb 2007

I tried to use the tar file and this is the message I get when I try to unpack it

tar: This does not look like a tar archive
tar: Skipping to next header
tar: Archive contains obsolescent base-64 headers
tar: Read 7768 bytes from TreeBrowserPlugin.tgz
tar: Error exit delayed from previous errors

I think that maybe I have tried this before, so instead used the zip file. Normally I always choose the tar file first.

-- XochipalaValdez - 23 Feb 2007

Ooops funny that smile I always use the ZIP myself then use the ZIP revision 10 instead and see if it help.

-- StephaneLenclud - 25 Feb 2007

XochipalaValdez : I'm having some problems too with TOC on 4.1.2 when using NatSkin. PatternSkin is ok though. Images are not being displayed in TOC with NatSkin/clean, that prevents you from unfolding nodes :(.

-- StephaneLenclud - 07 Mar 2007

I downloaded revision 10 and does not work with 4.0.5 but is working fine with 4.1. So this is incentive for me to complete my upgrading efforts. I am by the way using PatternSkin. Thanks for your help Stephane and for this really great plugin.

-- XochipalaValdez - 07 Mar 2007

Ok good to know. Actually I've never been running that plugin on 4.0.5. Was fine on 4.0.4 though. And it's fine on 4.1.2.

-- StephaneLenclud - 08 Mar 2007

Just published v0.8. Have a look at the release notes.

On the task list for the next release (v0.9):

  • Warning, important replace my $script="\n"; with my $script=""; to get ride of an extra paragraph.
  • Review and document CSS.
  • Define the CSS class according to the depth of the item.
  • Have different CSS class for node and leaf.
  • Have a style parameter defining the CSS file to use.
  • Review icon path management: I tried to work on that already but got totally confused - See JanFilipsky comments above.
  • Find a way to use alternative images for each node. That's implemented already. BTW JanFilipsky was about improving that I think.
  • Refactor Javascript.

  • Omissions:
    • Continue rendering tree after empty line - See VickiBrown comment's above.
-- StephaneLenclud - 08 Mar 2007

Just published v0.9. Have a look at the release notes. Was tested on IE7 and FF2.

On the task list for the next release (v1.0):

  • Review icon path management for specific node. - See JanFilipsky suggestion's above.
  • Further improve CSS:
    • Have unique class for each node?
    • Sort out issues with multiple trees of different style on one page. - See known issues.
  • Study pop up menu feasibility.
Check out the menu demo.

-- StephaneLenclud - 09 Mar 2007

Just published v1.0. Have a look at the release notes. Was tested on IE7 and FF2. Mind you early v1.0 would not have support for full path in icon:. I was too lazy to change the version number smile Thanks JanFilipsky for suggesting that improvement.

On the task list for the next release (v1.1):

  • Further improve CSS: Have unique class for each node?
  • Study pop up menu feasibility.
-- StephaneLenclud - 10 Mar 2007

Just published v1.2. Have a look at the release notes. Was tested on IE7 and FF2.

On the task list for the next release (v1.3):

  • Further improve CSS: Have unique class for each node?
  • Pop up menu.
  • Javascript animations.
-- StephaneLenclud - 11 Mar 2007

Just published v1.5. Have a look at the release notes. Was tested on IE7, FF2 and Opera.

On the task list for the next release, by priority (v1.6):

  • Warning, important Fix IE pop-up sub-menus.
  • Manage pop-up menu cursor persistence with JavaScript. (Not just :hover)
  • Horizontal pop up menu.
  • Javascript animations.
  • Further improve CSS: Have unique class for each node?
-- StephaneLenclud - 18 Mar 2007

Just published v1.6. Have a look at the release notes. Was tested on IE7, FF2 and Opera9.

On the task list for the next release (v1.7), by priority :

  • Close parent children when hovering on a leaf. Use onmouseover.
  • FF2 z-index issue with HTML form.
  • Create %POPUPMENU% tag to simplify tag syntax.
  • Test image rendering in pop-up menu.
  • Manage pop-up menu cursor persistence with JavaScript. (Not just :hover)
  • Horizontal pop up menu.
  • Javascript animations.
  • Further improve CSS: Have unique class for each node?
  • Support variable width sub-menu. Might be a problem with IE.
-- StephaneLenclud - 18 Mar 2007

Just published v1.7. Have a look at the release notes. Was tested on IE7, FF2 and Opera9.

On the task list for the next release (v1.8), by priority :

  • Use dtreeNodeOpened and CSS to highlight opened popup root
  • FF2 z-index issue with HTML form.
  • Create %POPUPMENU% tag to simplify tag syntax.
  • Test image rendering in pop-up menu.
  • Horizontal pop up menu.
  • Javascript animations.
  • Further improve CSS: Have unique class for each node?
  • Support variable width sub-menu. Might be a problem with IE.
  • Optimization. Disable cookies for popup?
-- StephaneLenclud - 19 Mar 2007

Just downloaded v1.7. Works good, but we are getting the following error when our cron job runs for WebNotify:

From: Cron Daemon [mailto:root@wiki.com]
Sent: Monday, March 26, 2007 2:30 PM
To: apache@wiki.com
Subject: Cron <apache@wiki> perl -I /u01/www/html/bin -I /u01/www/html/lib/TWiki/Contrib -I /u01/www/html/lib -I /u01/www/html/lib/CPAN/lib /u01/www/html/tools/mailnotify -q Main

Unquoted string "dtree" may clash with future reserved word at /u01/www/html/lib/TWiki/Plugins/TreeBrowserPlugin.pm line 129.

If this is not the correct place for this type of question please let me know.

-- DariusLinder - 28 Mar 2007

Thanks for reporting that. I can see that warning too. I'll fix it in 1.8.

-- StephaneLenclud - 29 Mar 2007

THANKS! That would be GREAT.

-- DariusLinder - 29 Mar 2007

Just published v1.8. Have a look at the release notes. Was tested on IE7, FF2 and Opera9.

On the task list for the next release (v1.8), by priority :

  • FF2 z-index issue with HTML form.
  • Create %POPUPMENU% tag to simplify tag syntax.
  • Try adding short delay before popup for better user experience.
  • Test image rendering in pop-up menu.
  • Horizontal pop up menu.
  • Pop up on the left.
  • Javascript animations.
  • Further improve CSS: Have unique class for each node?
  • Support variable width sub-menu. Might be a problem with IE.
  • Optimization. Disable cookies for popup?
-- StephaneLenclud - 29 Mar 2007

can anyone help with TreeBrowserPluginScriptWordDisplay ??

-- SvenDowideit - 28 Apr 2007

There appears to be a negative interaction between TreeBrowserPlugin and WorkflowPlugin, in that as soon as I enabled TreeBrowserPlugin the state transistions stop working in WorkflowPlugin. Being neither a perl nor css program, I have no idea were to start looking. Both are great plugins and I want them both.

-- KenLockhart - 04 May 2007

Interesting, first thing you can try is change the plug-in order in configure and see if it helps. I'll have to take a look at the WorkflowPlugin to tell you more.

-- StephaneLenclud - 07 May 2007

Warning, important autotoggle breaks the folder open/close mechanism when used without popup. I reckon autotoggle should be disabled if popup is off. Thanks to KenLockhart for helping out with that issue.

-- StephaneLenclud - 16 May 2007

Thanks for the very nice extension! A comment, however (feature request?). In the present form, the regex in sub preRenderingHandler is, at my taste, a bit too greedy :). The plugin absolutely wants to render a bulleted list, and skips whatever precedes bullets (not just empty lines). This gives a problem, when it is used to render lists generated by other plugins. Consider the following:

*Further info:*
%TREEBROWSER{"file" noroot="true" warn="none"}%
%TREEVIEW{topic="%BASETOPIC%" web="%BASEWEB%" startlevel="1" stoplevel="3" formatting="outline" format="* $topic" levelprefix="   "}%
%INCLUDE{ "%TWIKIWEB%.WebLeftBarWebsList" }%

If TREEVIEW returns no children, the list of webs is rendered by TREEBROWSER, which is not what is intended, and there is nothing I can put before the list of webs that would stop TREEBROWSER processing.

In order to fix that, added a little patch to the module, introducing the new tag - TREEBROWSEREND. It is a rather ugly hack, but I tried not to deviate too much from the original behaviour of the plugin.

diff TreeBrowserPlugin.pm TreeBrowserPlugin.pm.original
<     my $afterEnd = '';
<         if ($_[0] =~ s/%TREEBROWSER(.+)%TREEBROWSEREND%(.*)/%TREEBROWSER$1/s) {
<             $afterEnd = $2;
<         }
<         $_[0] =~ s/%TREEBROWSER{(.*?)}%(([\n\r]+[^\t]{1}[^\n\r]*)*?)(([\n\r]+\t[^\n\r]*)+)/&handleTreeView($1, $2, $4).$afterEnd/ges; #original
>           $_[0] =~ s/%TREEBROWSER{(.*?)}%(([\n\r]+[^\t]{1}[^\n\r]*)*?)(([\n\r]+\t[^\n\r]*)+)/&handleTreeView($1, $2, $4)/ges; #original
<         $_[0] =~ s/%TREEBROWSER{(.*?)}%/&handleLonelyTreeView($1).$afterEnd/ges;
>         $_[0] =~ s/%TREEBROWSER{(.*?)}%/&handleLonelyTreeView($1)/ges;


-- AlexandreTrofimov - 09 Jul 2007

That's a genuine problem, thanks for reporting that. However I don't like the TREEBROWSEREND solution either. Did you try to use some HTML comments to prevent rendering your web list? I'll see what I can do to fix it in the next release.

-- StephaneLenclud - 10 Jul 2007

> Did you try to use some HTML comments to prevent rendering your web list?
Yep. But logically enough it does not have any effect: the regexp in sub preRenderingHandler skips everything before a \t on a new line.

-- AlexandreTrofimov - 10 Jul 2007

I haven't tried your changes yet. So I have just another stupid question for you Alex. Does it still works without TREEBROWSEREND ? It probably does in which case it sounds like an appropriate solution to me.

-- StephaneLenclud - 11 Jul 2007


Yes it does. No, it is buggy.

1. It only works for one TREEBROWSER section per page, a second, third, etc. mess up the page completely. 2. It messes up other things (e.g. TREEBROWSER of TOC makes TOC change the presentation of totally unrelated bullet list later in the topic).

I will have it fixed, and will post a patch.

Update: sorry, I am an incredible cretin, misread your comment and done exactly the opposite of what you were expecting, that is - made the TREEBROWSEREND closing var mandatory.

TreeBrowserPlugin.pm-patched-TREEBROWSEREND.tar.gz: Plugin of 10 Apr 2007 patched to stop rendering on TREEBROWSEREND

Will re-write that to stop processing on non non-empty line not starting with three spaces, and containing something else besides html formatting tags. (Some list-rendering plugins, such as TreePlugin insert html tags ( div) upon variable expansion. These tags are received by TreeBrowserPlugin as part of the list to be rendered.)

Grepping each and every topic displayed for TREEBROWSER tags is sub-optimal, to say the least. I was wondering if we could register a handler for TREEBROWSER var using TWiki::Func::registerTagHandler, then feed the list to be rendered as part of the var's arguments (something like TREEBROWSER{... tree="TREEVIEW{}"}) We could then force-expand the argument for processing. On the other hand, it would be a syntaxic nightmare to render static lists (force INCLUDE?), or deal with non-javascript enabled browsers.

-- AlexandreTrofimov - 12-13 Jul 2007

There is a lot to consider and test. Unfortunately it's very time consuming since we don't have unit test.

Possibly what we could do is introduce a new tag like TREEBROWSERNG (non greedy) that would use a slightly different regular expression. Thus we guaranty not to introduce regressions in the existing TREEBROWSER.

As far as I can remember TreeBrowserPlugin was initial based on RenderListPlugin especially all the mechanics for extracting the list. It might be that RenderListPlugin is already capable of doing what you trying to achieve in which case we could just do the same with TreeBrowserPlugin.

-- StephaneLenclud - 13 Jul 2007

TreeBrowserPlugin should handle the same icon specification syntax as RenderListPlugin. That is

   * icon:myicon

without the requirement for the .gif suffix

-- VickiBrown - 19 Jul 2007

I realize that TreeBrowserPlugin was based on RenderListPlugin and doesn't actually use the same module but... it would be Very Convenient if TREEBROWSER would look for the RenderListPlugin page and, if present, be willing to use those icons too. It's redundant (and subject to error) that I have to attach the identical icon set in two places :(

-- VickiBrown - 19 Jul 2007

Some fair points.

-- StephaneLenclud - 20 Jul 2007

Hi all, Thanks for all your efforts with the TreePlugin, it is amazing! I was wondering if anyone could take a look at the problem I am having. Support.VariableExecution Your help is greatly appreciated

-- BrianMahoney - 07 Aug 2007

To remove the red background color from the images, add:

.dtree a:hover {background-color:transparent;}
.dtree a.twikiLink:hover {background-color:#d6000f;} /* pattern skin red background */

It would be better though if the images had a separate CSS class.

-- ArthurClemens - 22 Aug 2007

Nice plugin - unfortunately when I put any kind of link (BumpyWord, Hello type link, etc.) anywhere in the list, it breaks and treebrowser fails to display the entire list. I'm using a near basic TWiki - the Debian based TWiki VM, and I haven't changed much of anything really. Am I missing some dependencies or something?

-- AndyFrench - 17 Oct 2007

That's odd Andy. Can you post your failing example here? I have that plug-in working as a menu on several TWiki installations and menus mostly provide links.

-- StephaneLenclud - 10 Feb 2008

The next step forward for that plug-in is probably to make use of some nice animation tricks from JQueryPlugin and other AJAX magics.

-- StephaneLenclud - 16 Feb 2008

Btw. JQueryPlugin comes bundled with the jquery.treeview plugin that does most of what the TreeBrowserPlugin does, I think.

-- MichaelDaum - 18 Feb 2008

Good to know, it looks like JQueryPlugin is going to make TreeBrowserPlugin more or less obsolete.

-- StephaneLenclud - 19 Feb 2008

Well, there is ongoing development on the jquery.treeview plugin to have ajax and stuff. And it still lacks some commonly used themes and a good TWiki integration.

-- MichaelDaum - 19 Feb 2008

So I'm using...

%TREEBROWSER{"web" title="" uselines="off" useplusminus="on" shared="y" noindent="off" nocss="off" autotoggle="on" noroot="on"}%
%FLEXWEBLIST{format="$indent   * [[$web.WebHome][$name]]$n"}%

...to render my webs. The title and noroot parameters conveniently remove the title & root line from the top of my tree but there is an annoying icon-sized column gap (with no icons in it) between the left margin and the first column of tree browser icons frown Presumably this is the gap where the root icon would go... but I've switched the root off. So how can I get rid of the gap? Thanks.

-- SimonHardyFrancis - 14 Mar 2008

I really like the TREEBROWSER plugin and have several hundred pages that use it on release 4.1. I am trying to port the pages to a new site on release 4.2 and am having 2 problems. First, on install I get the message Can't locate object method "findUser" via package "TWiki::Users" at /homepages/6/d238659003/htdocs/twiki420/TreeBrowserPlugin_installer.pl line 713. I am not sure if this is a fatal error or not??? I activated the plugin and it seems to render the list and fold and unfold OK.

-- JimCrum - 20 Mar 2008

I'm also trying to use TREEBROWSER on 4.2, but it doesn't seem to recognize my TreeView-generated tree at all. Here's what I have:

%TREEBROWSER{title="Underwriting Table of Contents" openAll="on" warn="no tree"}% %TREE{excludetopic="Web*" formatting="ollist"}%

Which simply generates the "no tree" warning.

-- GarySprague - 21 Mar 2008

Never tested those plugins on 4.2. Try not having a new line between the plugins variables. Jim, I would not worry about error message during installation as long has the plugin works. Simon, thanks for reporting that problem. I'll try to look at it next month, I'm out of the office until next week.

-- StephaneLenclud - 23 Mar 2008

Broken file link in tree item see TreeBrowserFileLink

-- StephaneLenclud - 27 Mar 2008

Gary, I think TREEBROWSER only recognizes TML however ollist generates HTML I believe. Take a look at TreePlugin#Combination_with_TreeBrowserPlug. I should have spotted that earlier really, I had an excuse though I was on vacation smile

-- StephaneLenclud - 11 Apr 2008

A performance hint: If you add the dtree.css include to css.pattern.tmpl, the browser can handle sites better.

-- SaschaVetter - 19 May 2008

I also get the findUsers error during install, but plugin does not work with 4.2. I get a Javascript error. I filed Bugs:Item5660 with more details.

-- DaveThompsonAnother - 27 May 2008

Three comments: Only visited links are underlined...

  1. Only visited links are underlined, those that aren't in the browser history are displayed differently (see example at right). That isn't appropriate for a navigation tool: can we have an option to disable that?
  2. SaschaVetter, how does adding the dtree.css include to css.pattern.tmpl help performance?
  3. Contrary to some the comments above, it does work in TWiki 4.2. But the settings are a bit sensitive, so here's an example of how to set up a site map:
    <a href="javascript: tree.openAll();">open all</a> | <a href="javascript: tree.closeAll();">close all</a>
    %TREEBROWSER{theme="file" shared="tree" title="" openTo="1" noroot="true"}%
       format="   * [[$web.$topic][$topic]]" levelprefix="   "
    I put that in WebTopicList of my TWiki web so that it appeared in all webs.
-- SeanCMorgan - 02 Jun 2008

Thanks Sean. Accordingly, I added 4.2 to the TestedOnTWiki form field.

-- PeterThoeny - 02 Jun 2008

If you are using this with TreePlugin version 1.6, there's a critical code fix. See my comments of this date, at TreePluginDev. (In hindsight, it may have been that bug which created the impression that TreeBrowserPlugin was broken on 4.2).

P.S. thanks for that reminder Peter.

-- SeanCMorgan - 03 Jun 2008

Vicki: I have seen that you uploaded an updated dmenu.css to the plugin topic. I only see difference in white-space. Anything that should go into SVN for next plugin release?

-- Peter Thoeny - 2013-02-27

Thanks for this plugin !

I would like to use it with TreePlugin but it doesn't work. I tried almost everything without success. My TWiki install is 5.1.4 and I tried both the last TreeBrowserPlugin and patched_TREEBROWSEREND versions.

any help please

-- Bastien Giraud - 2013-05-23

I use this plugin with several TWiki-5.1.4 installations. Please ask support questions in the Support forum.

-- Peter Thoeny - 2013-05-24


I am using TreeBrowser version 2013-01-23 with Twiki 4.1.2 and I have some very basic issues.

Anchors immediately before or after a bullet item (and even with a blank line) break the tree list rendering. How can I get an anchor into a long list of bullet items?

Twiki links, using the nested square brackets, do not appear as links even though they are clickable. Is this a bug?

I tried doing my own underline, italics, or bold in the Twiki links mentioned above but inside the square brackets, the aforementioned twiki codes are presented literally. Is this a bug?

Speaking of appearance, the default font for treebrowser is smaller and less dense than the default text for normal bullet list text, how do I make the treebrowser text look like the default Twiki text?

Literal text that appears in a bullet item using <verbatim>...</verbatim> stop the tree list rendering. Is this a feature? Any workaround?

Thanks for a great plug-in.

Gerald Justice

-- Gerald Justice - 2013-09-18

Topic attachments
I Attachment History Action Size Date Who Comment
JPEGjpg Picture1.jpg r1 manage 47.2 K 2006-09-14 - 19:23 VickiBrown output from TREEVIEW
JPEGjpg Picture2.jpg r1 manage 41.5 K 2006-09-14 - 19:23 VickiBrown Output from TREEVIEW passed through TREEBROWSER
Unknown file formatgz TreeBrowserPlugin.pm-patched-TREEBROWSEREND.tar.gz r1 manage 4.5 K 2007-07-12 - 16:22 AlexandreTrofimov Plugin of 10 Apr 2007 patched to stop rendering on TREEBROWSEREND
Compressed Zip archivezip TreeBrowserPlugin.zip r1 manage 3.1 K 2006-09-22 - 09:57 JanFilipsky Patched plugin for displaying icons from other destinations (e.g. TWikiDocGraphics)
Texttxt tbppatch.txt r1 manage 27.3 K 2006-09-02 - 11:16 StephaneLenclud Patch suggestion
Unknown file formatJPG treeview_truncated.JPG r1 manage 8.1 K 2006-11-09 - 11:53 AlokNarula Truncated tree view
Texttxt v0.7patch.txt r1 manage 15.2 K 2006-10-01 - 19:48 StephaneLenclud Patch for v0.7
Edit | Attach | Watch | Print version | History: r137 < r136 < r135 < r134 < r133 | Backlinks | Raw View | Raw edit | More topic actions
Topic revision: r137 - 2013-09-19 - GeraldJustice
  • Learn about TWiki  
  • Download TWiki
This site is powered by the TWiki collaboration platform Powered by Perl Hosted by OICcam.com Ideas, requests, problems regarding TWiki? Send feedback. Ask community in the support forum.
Copyright © 1999-2018 by the contributing authors. All material on this collaboration platform is the property of the contributing authors.