%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: webs: a list of webs to be displayed and/or "public" - a list of all non-hidden webs, "webtemplate" - a list of all template webs; "publiccurrent" - a list of all non-hidden webs including the current one; (defaults to "public")
format: format string to render one item (defaults to "$web ")
header: format string prepended to the output result
footer: format string appended to the result; if the list of webs is empty neither header nor footer are added.
separator: text to be put between webs; can be none for no separators
subformat: format string to be used to format subwebs (defaults to format)
subheader: format string preceding the output of any subweb (defaults to header)
subfooter: format string following the output of any subweb; subheader and subfooter are only added if the list of subwebs of the current web is not empty (defaults to footer)
subseparator: text to be put between subwebs; can be none for no separators (defaults to separator)
subwebs: regular expression that subwebs must match to be listed; this can also be none, all, only to suppress subwebs, show all or only dispay explicitly mentioned subwebs (default is all)
selection: selected items in the list of webs
marker: text for $marker if the item maches the selection (see pseudo variables below)
markerformat: format string used instead of (sub)format string for selected items
exclude: regular expression of items excluded from the output
include: regular expressions of items that must match in order to be included in the output
adminwebs: a regular expression of webs that are considered to be only relevant for TWikiAdmins and are hiddend to non-admin users. In general it is recommended to hide webs by restricting access rights to it. There are however cases when you want to hide a web but still use it although the user is not aware of it. Best example is and Application web holding TWikiApplications. Users are using those applications but should not be bothered with their implementation.
map: list of key=value pairs to map the name of a web to a different value (e.g. map="TWiki=System,Main=Home" will expand the variable $name as "System" instead of TWiki and as "Home" instead "Main")
$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 TWiki variables
FlexWebListPlugin.zip in your twiki installation directory. Content: | File: | Description: |
|---|---|
data/TWiki/FlexWebListExamples.txt | |
data/TWiki/FlexWebListNavi.txt | |
data/TWiki/FlexWebListPlugin.txt | |
data/TWiki/FlexWebListTree.txt | |
lib/TWiki/Plugins/FlexWebListPlugin/Core.pm | |
lib/TWiki/Plugins/FlexWebListPlugin.pm |
configure in your TWiki installation, and enable the plugin in the {Plugins} section.
| Plugin Author: | TWiki:Main.MichaelDaum |
||||||
| Copyright ©: | 2006-2008, Michael Daum http://michaeldaumconsulting.com |
||||||
| License: | GPL (GNU General Public License  ) |
||||||
| Plugin Version: | v1.24 | ||||||
| Change History: | |||||||
| 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 TWiki:Plugins/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: |
|
||||||
| Perl Version: | 5.8 | ||||||
| TWiki:Plugins/Benchmark: |
GoodStyle nn%, FormattedSearch nn%, FlexWebListPlugin nn% | ||||||
| Plugin Home: | TWiki:Plugins/FlexWebListPlugin |
||||||
| Feedback: | TWiki:Plugins/FlexWebListPluginDev |
||||||
| Appraisal: | TWiki:Plugins/FlexWebListPluginAppraisal |
- 15 Feb 2008
|
Copyright © 1999-2024 by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Ideas, requests, problems regarding Daya Bay? Send feedback Note: Please contribute updates to this topic on TWiki.org at TWiki:TWiki.FlexWebListPlugin. |