Help15

Difference between revisions of "Screen.menumanager.15"

From Joomla! Documentation

m
Line 15: Line 15:
 
{{colheader|Menu items}}
 
{{colheader|Menu items}}
 
{{colheader|Published}}
 
{{colheader|Published}}
 +
{{colheader|Unpublished}}
  
 
==Typical Usage==
 
==Typical Usage==

Revision as of 18:30, 23 March 2008

Description[edit]

The Menu Manager controls the framework, or container of the menu(s) in Joomla!. The actual menu functionality and appearance of a menu is created automatically by Joomla! by triggering a new instance of [mainmenu] when a menu is first created. It is this, together with the menu item(s) selected, that creates the finished menu.

Version Changes[edit]

New in Joomla! 1.5:

  • Type column
  • ID column

Column Headers[edit]

  • ID. The ID number. This is a unique identification number for this item assigned automatically by Joomla!. It is used to identify the item internally, for example in internal links. You can not change this number.
  • Title. The name of the item. For a Menu Item, the Title will display in the Menu. For an Article, Section, or Category, the Title may optionally be displayed on the web page. This entry is required. You can open the item for editing by clicking on the Title.
  • Type. The type column in the menu manager will actually be the Unique Name of the menu.
  • Menu Items. An icon that links to the Menu Item Manager. Clicking this icon takes you directly to the Menu Items for the selected Menu, where you can add or edit Menu Items.
  • Published. Whether the item has been published or not. You can change the Published state by clicking on the icon in this column.
  • Unpublished. The unpublished column shows the the number of items that aren't published or publicly available.

Typical Usage[edit]

You can open the Menu Manager by clicking its quick icon in the Control Panel after logging in the administration back-end or you can access it from the Menus -> Menu Manager menu item.

Using the Menu Manager you can create your menus containing your menu items. This screen summarizes the details of the available menus by displaying the number of published/unpublished, trashed menus and the number of the modules.

You can create a new menu by clicking the New toolbar button. You can edit an existing one by selecting it and clicking the Edit button on the toolbar or by clicking its title. When you want to create a copy of a menu just select it and click the Copy toolbar button and the following screen will be displayed:

Screen menu manager copy 15.png

As you see, the copied menu and its menu items are also listed on this screen.

You should fill in two fields:

  • Enter the title in the New Menu Title field.
  • Type in the module name in the New Module Name field.

Click the Copy toolbar button to complete the process. If you decide not to create the copy of the menu, then click the Cancel button on the toolbar.

You can remove an unnecessary menu by selecting it and clicking the Delete toolbar button and the following screen will be loaded:

Screen menu manager delete 15.png

The details are summarized on this screen, so it easier for you to make your decision. Click the Delete toolbar button to complete the process. If you decide not to remove the copy of the menu, then click the Cancel button on the toolbar.

Quick Tips[edit]

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 where you can give some information about the menu. As well it is recommended to enter a short title in the Module title field, you can identify the module with this name in the Module Manager that belongs to the respective menu.

Create a copy 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 easier.

Points to Watch[edit]

Creating a new menu

When you want to create a new menu, in the Unique Name field use only english alphanumeric characters without space to identify a unique name. 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 later use the Module Manager to create a new mod_mainmenu module, and assign it to the menu.

Deleting an existing menu

If you delete an existing menu, do not forget that all the menu items of the respective menu will be also deleted.

Main Menu cannot be deleted

Main Menu is your default menu and cannot be deleted. That is why it is marked with an asterisk (*) in the Menus menu. It can be unpublished however, if you wish to do so.

Dependencies[edit]

Each menu is a copy of the mod_mainmenu module. These modules are listed in the Module Manager and their details and parameters can be customized by opening them.

The menu items belonging to a specific menu listed in the Menu Item Manager can be accessed by clicking the icon in the Menu Item(s) column of the Menu Manager.

Related Information[edit]