%META:TOPICINFO{author="guest" date="1026830700" format="1.0" version="1.3"}%
%META:TOPICPARENT{name="TigerSkin"}%
__Related topics:__ WebMenu, GnuSkinPlugin, TigerSkinPlugin, %TWIKIWEB%.TWikiPlugins

---+ <nop>WebMenu format

---++ Introduction

The left hand menu used in both the <nop>GnuSkin and the <nop>TigerSkin themes for the TWiki is defined by the WebMenu topic. Its format can, at first glance, seem a bit complex. The following sections tries to explain the syntax.

When used with the [[http://twiki.org/cgi-bin/view/Plugins/TigerSkinPlugin][TigerSkin]] the left-hand menu bar is presented with advanced <nop>JavaScript features. Whereas the GnuSkin has an extremely simplified version enabled per default. As the <nop>JavaScript engine for presenting the WebMenu topic evolves more user agents, e.g., Mozilla, Netscape and Opera will get support for the more powerful <nop>JavaScript presentation. Currently only Internet Explorer is completely supported.

---++ Syntax

| %<nop>WEB{name="..." home="..." [expand="always or never"]}% | entry for Web |
| %<nop>ITEM{name="..." [topic="..."]}% | topic in Web, any number of these after %<nop>WEB% |
| %<nop>LINK{name="..." [url="..."]}% | Genric entry, an URL. |
| %<nop>DEFAULTITEMS% | default topics defined by using SET DEFAULTITEMS |

	* __Only put one <nop>WebMenu command per line__.

	* The WEB command creates a top-level menu item. Usually used to present a TWiki web with (possibly a different) name. Set the expand option to "always" if you always want this top-level item to be expanded (all sub-items displayed). Or set it to "never" to never expand it, not even when you are visiting that web.<br> __Example:__
		* %<nop>WEB{name="People" home="Main"}%

	* The ITEM command creates a sub-level item. Only two levels exist in the <nop>WebMenu, top-level and sub-top-level. The topic option denotes the actual web topic, with respect to the top-level web. The name option can be used to reference a topic with a different name. E.g., <nop>ChangeLog instead of <nop>WebChanges, for instance.<br> __Example:__
		* %<nop>ITEM{name="WebPreferences"}% &mdash; A sub-level item called <nop>WebPreferences which links to the same topic.

	* The LINK entry is a generic sub-level item. If you do not understand any of the others this one is for you. This can completely replace the ITEM above, if you like.

	* The DEFAULTITEMS is a set of sub-level items that are common for many webs. The setting is a comma separated list of items. Do _NOT_ put any spaces between the comma and the following item!<br> __Example:__
		* Set <nop>DEFAULTITEMS = %ITEM{name="Preferences" topic="WebPreferences"}%,%ITEM{name="ChangeLog" topic="WebChanges"}%,%ITEM{name="WebNotify"}%,%ITEM{name="WebStatistics"}%


__Please note:__ If you consult (as in copy-paste) the sources on this page, remove all &lt;nop&gt; statements in your text. Otherwise the settings will not work for you.
