This Module allows you to place your Menus on the page. Every Joomla! website has at least one Menu that is created in the [[screen.menumanager.15|Menu Manager]] screen. The Menu Module allows you place all or part of the selected Menu at the desired position and on the desired web pages. The name for this Module is "mod_mainmenu".

+

You can access the Menu module by either opening an existing Menu module in the Module Manager or by creating a new Menu Module.

+

You can access the Module Manager by going to '''Extensions > Module Manager'''

−

'''Module Parameters'''

+

==Description==

+

This Module allows you to place your Menus on the page. Every Joomla! website has at least one Menu that is created in the [[screen.menumanager.15|Menu Manager]] screen. The Menu Module allows you place all or part of the selected Menu at the desired position and on the desired web pages.

+

+

==Screenshot==

+

[[Image:Help16_module_menu.jpg|frame|center]]

+

+

==Outline==

+

+

===Basic Options===

The Menu Module has the following Module Paramters:

The Menu Module has the following Module Paramters:

[[Image:help16_mod_menu_basic.JPG|frame|center]]

[[Image:help16_mod_menu_basic.JPG|frame|center]]

−

*'''Menu Name.''' The name of the Menu created in the [[screen.menumanager.15|Menu Manager]] screen. The default is "mainmenu". Note that you can have more than one Menu Module with the same Menu Name specified here (for example, if you are using Start and End Levels).

+

*'''Select Menu.''' Select a created menu to use for the module. The default is the menu with the lowest ID. Note that you can have more than one Menu Module with the same Menu Name

−

*'''Menu Style.''' The style of the menu. The options are as follows:

+

specified here (for example, if you are using Start and End Levels).

−

** ''List.'' Joomla! 1.5 List style. This is the style used by the menus in the Sample website.

Start and End Levels can be used to display different parts of one menu at different locations. For example, say you have one Menu with three levels as follows:

+

−

:Menu Item 1

+

−

:Menu Item 2

+

−

::Menu Item 2.1

+

−

:::Menu Item 2.1.1

+

−

:::Menu Item 2.1.2

+

−

::Menu Item 2.2

+

−

:Menu Item 3

+

−

Using Start Level and End Level, you could show this one Menu as three different small menus on your pages. To do this, you would:

+

−

#Create a "Main" menu with a Start Level of 0 and End Level of 1. This Module would display on all Menu Selections.

+

−

#Your "Middle" Menu Module would have Start Level of 1 and End Level of 2. It would only display Menu Items 2.1 and 2.2. It could be placed at a different Position than the "Main" menu and might only display on Menu Selection pages for Menu Items 2, 2.1, 2.1.1, 2.1.2, and 2.2.

+

−

#The "Third" Menu Module would have Start Level of 2 and End Level of 3, so it would only display Menu Items 2.1.1 and 2.1.2. It could be placed at a different Position from the other Menu Modules. It might only have a Menu Assignment for the Menu Items 2.1, 2.1.1, and 2.1.2.

+

−

In this way, you can have one large, multi-level Menu but break it up into separate Modules. Also, doing a Menu in this manner has the advantage of making the Breadcrumbs Module display in a hierarchical manner.

+

*'''Start Level.''' Optional level to start the display of the Menu. Default is 0 for the Top Level.

*'''Start Level.''' Optional level to start the display of the Menu. Default is 0 for the Top Level.

*'''End Level.''' Optional level to end the display of the Menu. Default is 0, which will display all levels of the menu.

*'''End Level.''' Optional level to end the display of the Menu. Default is 0, which will display all levels of the menu.

−

*'''Always show sub-menu Items.''' Whether or not to show sub-menu items when the parent is not active. If "No", a sub-menu Item will only display when the parent Item is clicked. If "Yes", sub-menu Items will always display in the menu.

+

*'''Show sub-menu Items.''' Whether or not to show sub-menu items when the parent is not active. If "No", a sub-menu Item will only display when the parent Item is clicked. If "Yes", sub-menu Items will always display in the menu.

−

*'''Target Position.''' Optional Javascript values, in pixels, to position a Popup window (for example, "top=50,left=50,width=200,height=300"). This is used in some templates to specify the location of drop-down or pop-up menus.

+

−

'''Advanced Parameters'''

+

===Advanced Parameters===

[[Image:help16_mod_menu_advanced.JPG|frame|center]]

[[Image:help16_mod_menu_advanced.JPG|frame|center]]

−

*'''Show Whitespace.''' Whether or not to show whitespace in the rendered XHTML. Whitespace includes spaces, tabs, newlines, and other formatting characters that don't affect the XHTML content. Note that this setting does not affect the appearance of the page. It only affects the appearance of the XHTML source code (for example, if you look at the source code from your browser).

−

{{colheader|Caching}}

−

{{colheader|Menu Tag ID}}

−

{{colheader|Menu Class Suffix}}

−

{{colheader|Module Class Suffix}}

−

*'''Maximum Menu Depth.'''

−

'''Other Parameters'''

+

*'''Menu tag ID''' Assign an ID to the menu item's root tag; when you want to apply specific CSS styling.

+

*'''Menu Class Suffix''' Assign a suffix to the CSS class of the menu, to apply specific CSS styling.

+

*'''Target Position''' Define the position for a javascript-powered pop-up window.

*'''Show Menu Images.''' Whether or not to show Menu Images for the Menu Items.

+

No tips have been added at this time.

−

*'''Menu Image Alignment.''' Whether to align the images to the left or the right.

+

−

*'''Menu Image Link.''' Whether or not to have the image be a link to the Menu Item.

+

−

*'''Expand Menu.''' Whether or not to expand the menu so that all sub-menu items are always visible.

+

−

*'''Activate Parent.''' Whether or not to set the ID's of the parent Menu Items as active when a sub-menu choice is activated.

+

−

*'''Full Active Highlighting.''' Whether or not to enable activation of the Link - Article and Link - URL. Note that setting this to "Yes" can cause the loss of XHTML compliance if more than one item is active.

+

−

*'''Indent Image.''' What image will be shown for each indented sub-level of menu item. Options are:

Latest revision as of 11:51, 17 May 2011

Contents

How to access

You can access the Menu module by either opening an existing Menu module in the Module Manager or by creating a new Menu Module. You can access the Module Manager by going to Extensions > Module Manager

Description

This Module allows you to place your Menus on the page. Every Joomla! website has at least one Menu that is created in the Menu Manager screen. The Menu Module allows you place all or part of the selected Menu at the desired position and on the desired web pages.

Screenshot

Outline

Basic Options

The Menu Module has the following Module Paramters:

Select Menu. Select a created menu to use for the module. The default is the menu with the lowest ID. Note that you can have more than one Menu Module with the same Menu Name

specified here (for example, if you are using Start and End Levels).

Start Level. Optional level to start the display of the Menu. Default is 0 for the Top Level.

End Level. Optional level to end the display of the Menu. Default is 0, which will display all levels of the menu.

Show sub-menu Items. Whether or not to show sub-menu items when the parent is not active. If "No", a sub-menu Item will only display when the parent Item is clicked. If "Yes", sub-menu Items will always display in the menu.

Advanced Parameters

Menu tag ID Assign an ID to the menu item's root tag; when you want to apply specific CSS styling.

Menu Class Suffix Assign a suffix to the CSS class of the menu, to apply specific CSS styling.

Target Position Define the position for a javascript-powered pop-up window.

Alternative layout Apply an alternative layout or template override

Module Class Suffix Apply a CSS suffix to the module

Caching. Use Global/No Caching. Whether or not to cache the content of this Module. A setting of "Use Global" will use the Cache Settings from the Global Configuration screen.

Cache Time. The length of time, in minutes, before the Module is re-cached.