FlexWebListPlugin

Description

This is a replacement for Foswiki's standard WEBLIST variable. It is extended to improve the display of hierarchical web structures, a feature added to later wikis and adds more flexibility when used in WikiApplications. The FLEXWEBLIST can be used for example to generate a hierarchical navigatio scheme or a nested sitemap.

Syntax

%FLEXWEBLIST{...}%

This tag iterates over all specified webs and all of their subwebs recursively while using the specified format strings to produce the output.

Parameters:

Parameters default to the emtpy string if not mentioned otherwise. Note, that some of them although similar to WEBLIST have different default values.

Pseudo-variables: Each of the above format strings (format, header, footer, subformat, subheader, subfooter and markerformat) may contain special variables that are replaced with a current value:

The following picture illustrates when which format strings are used

header
format
separator
format
subheader
subformat
subheader
subformat
subseparator
...
subseparator
subformat
separator
...
subseparator
format

Examples

See the FlexWebListExamples.

Plugin Installation Instructions

You do not need to install anything in the browser to use this extension. The following instructions are for the administrator who installs the extension on the server.

Open configure, and open the "Extensions" section. Use "Find More Extensions" to get a list of available extensions. Select "Install".

If you have any problems, or if the extension isn't available in configure, then you can still install manually from the command-line. See http://foswiki.org/Support/ManuallyInstallingExtensions for more help.

Plugin Info

Plugin Author: Foswiki:Main.MichaelDaum
Copyright ©: 2006-2009, Michael Daum http://michaeldaumconsulting.com
License: GPL (GNU General Public License)
Release: v1.51
Version: 5698 (2009-12-02)
Change History:  
02 Dec 2009: fixed regexing for subwebs
17 Nov 2009: fixed processing subwebs and marker format
02 Jul 2009: added $color, $sitemapuseto, $sitemapwhat and $url; fixed examples
17 Apr 2009: converted to foswiki
03 Jul 2008: don't blat if there's a subweb with no parent web, habbens in Trash from time to time
15 Feb 2008: explicitly disable unwanted webs
17 Jan 2008: added treeview example based on Foswiki:Extensions/JQueryPlugin
03 Jan 2008: fixed hiding of subwebs
13 Sep 2007: added adminwebs feature
21 May 2007: added FlexWebListNavi
08 May 2007: docu fixes, respect HOMETOPIC in the examples
10 Mar 2007: fixed expansion of $n and $nop
13 Oct 2006: don't bail out entering a non-existing web
31 Aug 2006: added NO_PREFS_IN_TOPIC; removed commonTagsHandler thus dropping support for cairo
03 Aug 2006: fixed use of uninitialized value
  start counting $indent at zero, not one; fixed the examples accordingly
02 Aug 2006: added publiccurrent pseudo-web which is the sorted list of all public webs including the current one; fixed $indent not to assume multiples of 3 items to indent
31 Jul 2006: don't filter webs that have been added explicitly added to webs
  more fixes related to web filtering; fixed some testcases
28 Jul 2006: preserve order in webs parameter
26 Jul 2006: first release
05 Jul 2006: initial version
Dependencies: None
Perl Version: 5.8
Plugin Home: Foswiki:Extensions/FlexWebListPlugin
Support: Foswiki:Support/FlexWebListPlugin
spacer