SimpleMenu

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:

  1. In the HTML editor, place your cursor where you want the menu to appear. Click on the Web Application tool in the editor toolbar. Select SimpleMenu from the list of Web Applications. Then, select the type of menu to insert.
  2. In plain text mode, add the following tag into your HTML: <!--&SimpleMenu(TYPE)-->. "TYPE" should be one of the above menu types.

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)-->

Sections

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 Styles

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.

Spacer Strings

SimpleMenu uses HTML strings to space out menu items. The default HTML spacers are as follows:

Menu TypeSpacer HTML
vertical<br>
horizontal&nbsp;|&nbsp;
path&nbsp;&gt;&nbsp;

In addition, SimpleMenu adds a prefix string in front of submenu items in vertical menus. By default the prefix string is a series of &nbsp; characters, to indent the submenu.

All of the above HTML strings can be customized in the SimpleMenu configuration file, cgi-bin/conf/SimpleMenu.conf.

Customizing Menus with CMS objects

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.