A functional skin that provides a customisable menu navigation system based on the JQuery Superfish plugin.
JQueryMenuSkin is a simple JQuery-based skin which utilises the Superfish menu plugin
(which is supplied with the JQueryPlugin
extension) to provide an alternative menu-based navigation system for Foswiki users.
This lightweight skin is designed to run on top of the default Pattern skin. (See Settings
section below for details)
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 Foswiki is running.
To activate the skin you can use the following settings just add them to Main.SitePreferences
, or your personal page.
The minimal requirement to use the skin is to set your SKIN
definition to include jqmenu
as shown: (Order is important!)
* Set SKIN = jqmenu,pattern
Typically this skin is used where the Web Left Bar is hidden. You should set the following in the same location as you defined the SKIN
setting above if you wish to hide the (details of how to do this can be found here: PatternSkinCssCookbookNoLeftBar
In order to be able to safely upgrade this skin it is recommended that you define your own menu by copying the topic System.JQueryMenuSkinBarDefault
to a new topic of your preference. You can define the name of the topic using a Preference
setting in Main.SitePreferences
, or your personal home topic as follows:
* Set JQUERYMENUSKINBAR = %USERSWEB%.MyMenuBar
WYSIWYG editing should be disabled on your personalised topic to ensure the menu does not get corrupted. You can do this as follows in your customised menu topic: (See TinyMCEPlugin
for full details)
* Set TINYMCEPLUGIN_DISABLE = 1
You can also customise the CSS applied to the menu by copying the default menu.css
and attaching it to your customised menu topic as follows:
* Set JQUERYMENUSKINCSS = %PUBURLPATH%/%USERSWEB%/MyMenuBar/menu.css
You can also simply overwrite CSS for the default menu definition JQueryMenuSkinBarDefault
with the above setting.
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
, then you can still install manually from the command-line. See http://foswiki.org/Support/ManuallyInstallingExtensions
for more help.