%META:TOPICINFO{author="TaitCyrus" date="1062441060" format="1.0" version="1.3"}%
%META:TOPICPARENT{name="Kamm.WebPreferences"}%
---+ Floating Menu Skin

This skin uses Javascript to create a floating menu that provides similar functionality to that found in the default TWiki skin.  The menu stays at the top of the screen as a person scrolls down the page allowing them access to the main menu at all times.

The Javascript code to create the floating menus was obtained at http://www.dhtmlcentral.com/projects/coolmenus

NOTE: This skin requires PHP.

---++ Screen Shot

| %ATTACHURL%/FloatingMenuSkin1.gif |
| %ATTACHURL%/FloatingMenuSkin2.gif |

---++ Installation

*Note:* You do not need to install anything on the browser to use this skin. The following instructions are for the administrator who installs the skin on the server where TWiki is running.

	* Download the ZIP file from the Skin Home page (see below)
	* Unzip ==%TOPIC%.zip== in your twiki installation directory
	* Test if installed: %SCRIPTURL%/view%SCRIPTSUFFIX%/%WEB%/%TOPIC%?skin=FloatingMenuSkin
	* For skin activation see %TWIKIWEB%.TWikiSkins

---++ Configuration

This skin uses the following TWiki variables to help define colors and content of the floating menu.

| *Variable* | *Description* | *Defaults* |
| =MENU_BGCOLOR= | Define the background color for the menu. | 00FF00 |
| =MENU_FGCOLOR= | Define the forground color (text color) for the menu. | 000000 |
| =MENU_ROLLOVER_BGCOLOR= | Define the background color to use when the mouse is moved over a menu item. | 3A60C0 |
| =MENU_ROLLOVER_FGCOLOR= | Define the forgrond color (text color) to use when the mouse is moved over a menu item. | FFFFFF |
| =MENU_WEBTOPICLIST= | Define the list of topics to include in the menu. *NOTE*: It is assumed that the pages to link to have =Web= prefixed to the list.  Using the sample values shown to the right, the web pages linked to would be =WebChanges=, =WebIndex=, and =WebSearch=.  *NOTE*: there should NOT be any spaces in the value of this variable. | Changes&#124;Index&#124;Search |
| =MENU_WIKIWEBLIST= | Define the list of TWiki webs to include in drop down menu. *NOTE*: there should NOT be any spaces in the value of this variable. | Know&#124;Main&#124;Sandbox&#124;TWiki |

Sample of what a <nop>WebPreferences file might contain
	* Set the new skin to used
		* Set SKIN = FloatingMenuSkin
	* Set various variables used by the TWiki.FloatingMenuSkin.  Note, for setting the web bg color, you must NOT specify a # as this will cause things to not work correctly.
		* *Define the topic menu colors*
		* Set MENU_BGCOLOR = 00FF00
		* Set MENU_FGCOLOR = 000000
		* Set MENU_ROLLOVER_BGCOLOR = 3A60C0
		* Set MENU_ROLLOVER_FGCOLOR = FFFFFF
		* *Define the contents of the web topic list*
		* Set MENU_WEBTOPICLIST = Changes|Index|Search
		* *Define the contents of the drop down menu listing available wiki webs*
		* Set MENU_WIKIWEBLIST = %<nop>WEBLIST{"$name" separator="|"}%

---++ Skin Info

|  Skin Author: | TWiki:Main/Tait.cyrus |
|  Skin Version: | 01 Sep 2003 (v1.000) |
|  Change History: | <!-- specify latest version first -->&nbsp; |
|  01 Sep 2003: | Initial version (v1.000) |
|  Dependencies: | PHP support in the web server<br>JavaScript support in your web browser |
|  Tested with: | Netscape 7.x and IE 6.0 |
|  Skin Home: | http://TWiki.org/cgi-bin/view/Plugins/%TOPIC% |
|  Feedback: | http://TWiki.org/cgi-bin/view/Plugins/%TOPIC%Dev |

__Related topic:__ %TWIKIWEB%.TWikiSkins

-- TWiki:Main/TaitCyrus - 01 Sep 2003
%META:FILEATTACHMENT{attr="h" comment=""}%
