Help16

Difference between revisions of "Extensions Module Manager Menu"

From Joomla! Documentation

 
Line 15: Line 15:
 
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.
 
** ''Legacy Vertical.'' Compatible with Joomla! 1.0 vertical style.
 
** ''Legacy Horizontal.'' Compatible with Joomla! 1.0 horizontal style.
 
** ''Legacy Flat List.'' Compatible with Joomla! 1.0 flat list style.
 
'''Start and End Levels'''
 
 
 
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).
+
 
 +
*'''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
 
{{colheader|Caching}}
 
{{colheader|Caching}}
{{colheader|Menu Tag ID}}
+
{{colheader|Cache Time}}
{{colheader|Menu Class Suffix}}
 
{{colheader|Module Class Suffix}}
 
*'''Maximum Menu Depth.'''
 
 
 
===Other Parameters===
 
 
 
[[Image:Menu_module_other_parameters.png|frame|center]]
 
*'''Show Menu Images.''' Whether or not to show Menu Images for the Menu Items.
 
*'''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:
 
**''Template.'' The Template will control the indenting images.
 
**''Joomla! default images.'' Joomla! default images for indenting will be used.
 
**''Use Parameters Below.'' Image file for each level 1 - 6 will be as indicated in the values below.
 
**''None.'' Images will not be indented.
 
*'''Indent Image 1 - 6.''' Select an image file from the drop-down list box for each of the sub-levels 1 - 6. The images are selected from the "images/M_images" folder.
 
*'''Spacer.''' Spacer for horizontal menu. Enter any characters here to display between Menu Items.
 
*'''End Spacer.''' End spacer for horizontal menu. Enter any characters here to display after the last Menu Item on a horizontal menu.
 
  
 
==Quick Tips==
 
==Quick Tips==
 
No tips have been added at this time.
 
No tips have been added at this time.

Latest revision as of 12:51, 17 May 2011

How to access[edit]

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[edit]

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[edit]

Help16 module menu.jpg

Outline[edit]

Basic Options[edit]

The Menu Module has the following Module Paramters:

Help16 mod menu basic.JPG
  • 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[edit]

Help16 mod menu advanced.JPG
  • 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.

Quick Tips[edit]

No tips have been added at this time.