Menus Menu Manager
From Joomla! Documentation
Revision as of 18:07, 26 December 2011 by Chris Davenport
In the backend of Joomla! use either Menus -> Menu Manager or the icon Menus from the controlpanel.
Menus allow a user to navigate through the site. A menu is an object which contains one or more menu items. Each menu item points to a logical page on the site. A menu module is required to place the menu on the page. One menu can have more than one module. For example, one module might show only the first level menu items and a second module might show the level 2 menu items.
The process for adding a menu to the site is normally as follows:
- Create a new menu (using this screen).
- Create one or more new menu items on the menu. Each menu item will have a specific menu item type.
- Create one or more menu modules to display the menu on the site. When you create the modules, you will select which menu items (pages) the modules will show on.
- Checkbox. Check this box to select one or more items. To select all items, check the box in the column heading. After one or more boxes are checked, click a toolbar button to take an action on the selected item or items. Many toolbar actions, such as Publish and Unpublish, can work with multiple items. Others, such as Edit, only work on one item at a time. If multiple items are checked and you press Edit, the first item will be opened for editing.
- Title. The name of the menu.
- # Published. Number of published menu items in this menu.
- # Unpublished. Number of unpublished menu items in this menu.
- # Trashed. Number of trashed menu items in this menu.
- Modules Linked to the Menu. Lists any menu modules associated with the menu. The column shows the module's name, access level, and position on template.
- ID. This is a unique identification number for this item assigned automatically by Joomla!. It is used to identify the item internally, and you cannot change this number. When creating a new item, this field displays 0 until you save the new entry, at which point a new ID is assigned to it.
- Display #. This list box shows at the bottom of the screen, below the list of items. You can select the number of items to display on one page. If there are more items than this number, you can use the page navigation buttons (Start, Prev, Next, End, and page numbers) to navigate between pages. Note that if you have a large number of items, it may be helpful to use the Filter options, located above the column headings, to limit which items display.
At the top right you will see the toolbar:
The functions are:
- New. Opens the editing screen to create a new menu.
- Edit. Opens the editing screen for the selected menu. If more than one menu is selected (where applicable), only the first menu will be opened. The editing screen can also be opened by clicking on the Title or Name of the menu.
- Delete. Deletes the selected menus. Works with one or multiple menus selected. Deleting a menu also deletes all the menu items it contains and any associated menu modules. On clicking Delete you will be asked to confirm that you want to delete the selected menus. Clicking OK button will delete the menus. Click Cancel to abort the deletion.
- Rebuild. Reconstructs and refreshes the menu table. Normally, you do not need to rebuild this table. This function is provided in case the data in the table becomes corrupted.
- Options. Opens the Options window where settings such as default parameters or permissions can be edited. See Menus Configuration.
- Help. Opens this help screen.
- It is expedient to give a descriptive title for new menus because, later, you will see it in the Backend Menus menu. It is a good idea to fill in the Description field with information about the menu. If you enter a short title in the Module title field, you can identify the menu's module using that title in the Module Manager.
- Though you can create a copy of a selected menu by clicking the Copy toolbar button, you can make another instance in the Module Manager as well.
- When you create a new menu, use only English alphanumeric characters without space in the Unique Name field. It is a good idea using only a-z, 0-9 and underscore (_) characters. Please read the tooltips as well.
- If you don't enter a Module title, no module will be created and the menu cannot be displayed in the front end. However you can use the Module Manager later to create a new mod_mainmenu module, and assign it to the menu.
- If you delete an existing menu, do not forget that all the menu items of the respective menu will be also deleted.
- The Main Menu has your default menu item, so it should not be deleted. The default menu item is your home page, and your site will not function if it is deleted. If you change the default menu item, make sure that you don't delete that menu item either! The menu with the default menu item is marked with an asterisk (*) in the Menus menu.