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:

• $web: the full name of the web, e.g. Main/Foo/Bar
• $qname: the full name of the web in quotes, e.g. "Main/Foo/Bar" (deprecated)
• $name: the name of the web without the leading parent webs, e.g. Bar
• $origname: the original name of the web despite any name mapping
• $parent: the name of the parent web of a sub web or the empty string if there's none
• $marker: marker text (see above) if the current item is selected, empty otherwise
• $depth: level of embedding of a subweb; main level web have depth 0 etc.
• $nrsubwebs: number of subwebs a current web has
• $indent: expands to three spaces for each level a web is embeded; main level webs get three spaces, subwebs on first level six spaces and so on.
• $indent(string): same as $indent but using string instead of three spaces
• $n: replaced with a newline char (\n)
• $percnt: replaced with a percent char (%)
• $dollar: replaced with a dollar char ($)
• $nop: removed from the format string before expanding common foswiki variables
• $url: link to homepage of web
• $sitemapuseto: content of the SITEMAPUSETO preference of the web
• $sitemapwhat: content of the SITEMAPWAT preference
• $color: content of the WEBBGCOLOR preference

The following picture illustrates when which format strings are used

Examples

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