SimpleMenu is a plug-in that automatically generates menus, navigation
bars, and sitemaps for your website. It will generate menus in any of
the following formats:
To insert a menu into a page, use one of the following methods:
The vertical and horizontal menus can additionally be modified using the following submenu options:
The options to select these will also be available in the Web Application tool. In plain text mode, add the option to the main option with a comma. For example:
<!--&SimpleMenu(horizontal,submenu-only)-->
By default, SimpleMenu displays a menu for the current section.
To generate a menu for the parent section instead of the current section, add the "parent" parameter:
<!--&SimpleMenu(horizontal,parent)-->
To generate a menu for a child section instead of the current section, specigy the child's section ID:
<!--&SimpleMenu(horizontal,section=NNN)-->
You can also include child sections in the contents of a normal menu, (as if they were pages), by setting the following configuration setting:
show_subsections = 1
The subsections are shown after regular pages.
Menu links all have the CSS class "menu". Vertical submenu links have the CSS class "submenu". By default, horizontal and vertical menus are wrapped in <span class="menu">...</span> tags. These CSS classes can be used to apply special styles to your menus.
SimpleMenu uses HTML strings to space out menu items. The default HTML spacers are as follows:
Menu Type | Spacer HTML |
---|---|
vertical | <br> |
horizontal | | |
path | > |
In addition, SimpleMenu adds a prefix string in front of submenu items in vertical menus. By default the prefix string is a series of characters, to indent the submenu.
All of the above HTML strings can be customized in the SimpleMenu configuration file, cgi-bin/conf/SimpleMenu.conf.
Vertical menus can be further customized by adding three special content objects to your page or template:
These content items can be used to define HTML snippets to place your menus into a special table, or to insert divider graphics, for instance.
Horizontal menus can be styled the same way, using SimpleMenuTopH, SimpleMenuBotH, SimpleMenuMidH.