key Log In or Register to edit

Quick Menu Skin

A functional skin that replaces the left bar with a customizable Javascript menu system.

Screen Shot

Click for full screen image

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.

Settings

The menu can behave in two ways. When CLICKMENU is set to 0 then the menu automatically shows when you hover the mouse over the menu. When it is set to 1 then the menu is activated by clicking on it. By default CLICKMENU is set to 0.

To add different menus to the menubar you can set QUICKMENUBAR to the topic containing the javascript for your own custom menus. By default QUICKMENUBAR is set to TWiki.QuickMenuBar, have a look at that topic to see how the menus are created.

To change settings just add them to T Wiki Preferences, Web Preferences, or your personal page.
Eg:

   * Set CLICKMENU = 1
   * Set QUICKMENUBAR = %TWIKIWEB%.QuickMenuBar

Modifying Menus

The menu bar is built by default from TWiki.QuickMenuBar, which in turn includes TWiki.QuickMenuBarWebs (if login is enabled) and TWiki.QuickMenuBarWebs and TWiki.QuickMenuBarUtilities. These files contain javascript commands that are included by the skin's templates. You can edit these files to customize the menu, but be sure to avoid unwanted linking by enclosing your code in <noautolink> ... </noautolink> tags.

Note: In a future release, it will be possible to add icons to the menus in the menubar. When this is done the QuickMenu.Menu function will change! This will make the arguments similar to the QuickMenu.Menu.Add function in that the argument for an icon will be inserted before the "menu tip information" argument.

QuickMenu Javascript Reference

  • To create a new menu
    Note: This may change! See above.
    mymenu = new QuickMenu.Menu(menuBar, "Menu Text", "", "Menu Tip Information");
    or just a link:
    new QuickMenu.Menu(menuBar, "TWiki.org", "http://twiki.org/");
    or a javascript function:
    new QuickMenu.Menu(menuBar, "Say Hello", "js:alert('Hello')");

  • Add items to the menu
    mymenu.Add("Item Text", "%SCRIPTURLPATH{"view"}%/PageToView", "", "Item Tip");
    mymenu.Add("Text Formatting", "%SCRIPTURLPATH{"view"}%/TextFormattingRules", "%ICONURLPATH{"help"}%", "More formatting help");
    mymenu.Add("Disabled item");

  • Add a submenu
    mymenu.Add("Choose Colour", ":Colour");
    mymenu.Colour.Add(...

Skin Info

Description: Functional skin that replaces the left bar with a customizable Javascript menu system
Screenshot: Click for full screen image
Preview: Preview with this topic
Base Name: quickmenu
Skin Author: TWiki:Main/VernonLyon
Skin Version: 4 Jul 2006 (v1.02)
Change History:  
4 Jul 2006: Added QUICKMENUBAR setting (v1.02)
21 Jun 2006: Added "Account" menu (v1.01)
13 Jun 2006: Initial version (v1.00)
Dependencies:  
Skin Home: http://TWiki.org/cgi-bin/view/Plugins/QuickMenuSkin
Feedback: http://TWiki.org/cgi-bin/view/Plugins/QuickMenuSkinDev
Appraisal: http://TWiki.org/cgi-bin/view/Plugins/QuickMenuSkinAppraisal

Note: The Description, Screenshot and Base Name rows are needed by the T Wiki Skin Browser

Related topic: T Wiki Skins, T Wiki Skin Browser, User Documentation Category, Admin Documentation Category

-- TWiki:Main/VernonLyon - 13 Jun 2006

toggleopenShow attachmentstogglecloseHide attachments
Topic attachments
I Attachment Action Size Date Who Comment
gifgif arrow_over.gif manage 0.2 K 05 Jul 2006 - 03:43 Unknown User  
gifgif menu_over.gif manage 0.2 K 05 Jul 2006 - 03:43 Unknown User  
gifgif menuitem_over.gif manage 0.1 K 05 Jul 2006 - 03:43 Unknown User  
gifgif menuitem_bg.gif manage 0.3 K 05 Jul 2006 - 03:43 Unknown User  
gifgif fullscreen.gif manage 24.4 K 05 Jul 2006 - 03:43 Unknown User  
gifgif menubaritem_bg.gif manage 0.1 K 05 Jul 2006 - 03:43 Unknown User  
gifgif menu_bg.gif manage 0.8 K 05 Jul 2006 - 03:43 Unknown User  
gifgif screenshot.gif manage 8.6 K 05 Jul 2006 - 03:43 Unknown User  
gifgif menubar.gif manage 0.9 K 05 Jul 2006 - 03:43 Unknown User  
elsecss qmenu.css manage 2.5 K 05 Jul 2006 - 03:43 Unknown User  
jsjs qmenu.js manage 10.7 K 05 Jul 2006 - 03:43 Unknown User  
elsecss style.css manage 6.5 K 05 Jul 2006 - 03:43 Unknown User  
gifgif arrow.gif manage 0.1 K 05 Jul 2006 - 03:43 Unknown User  
 
Ad Sponsor
Back to Redbourn
Copyright © We make no guarantee of the correctness of the content of this site. All material on this collaboration platform is the property of Martin Cleaver and the contributing authors.