Help15

Difference between revisions of "Screen.menumanager.15"

From Joomla! Documentation

m
m (→‎Related Information: correct category name, Menus Helps to Menus Help)
 
(33 intermediate revisions by 7 users not shown)
Line 1: Line 1:
 +
==Access==
 +
In the backend of Joomla! use either '''Menus -> Menus''' or the icon '''Menus''' from the controlcenter.
 +
 
==Description==
 
==Description==
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.
+
The Menu Manager controls how Joomla!'s menus will look and act.  
  
[[Image:Screen_menu_manager_15.png|center|thumb|800x396px]]
+
==Screenshot==
 
+
[[Image:Menu_manager.png]]
==Version Changes==
 
New in Joomla! 1.5:
 
* ''Type'' column
 
* ''ID'' column
 
  
 
==Column Headers==
 
==Column Headers==
{{colheader|Id}}
 
 
{{colheader|Title}}
 
{{colheader|Title}}
 
{{colheader|Menu Type}}
 
{{colheader|Menu Type}}
 
{{colheader|Menu items}}
 
{{colheader|Menu items}}
{{colheader|Published}}
+
*'''Published'''. Amount of the current included and published menu items.
{{colheader|Unpublished}}
+
*'''Unpublished'''. Amount of the current number of items that are not published or publicly available.
 +
*'''Trashed'''. Amount of the current number of items that have been deleted, but not purged from the trash manager
 +
{{colheader|Modules Column}}
 +
{{colheader|Id}}
  
==Typical Usage==
+
==Toolbar==
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.
+
At the top right you will see the toolbar:
  
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.
+
[[image:Menu-manager-toolbar.jpg]]
  
You can [[screen.menumanager.new.15|create]] a new menu by clicking the ''New'' toolbar button. You can [[screen.menumanager.new.15|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:
+
The functions are:
 
+
*'''Copy'''. To copy a menu (and all included menu items), select the radio button next to it and click the "Copy" button. You can than then enter in a new title and module name for the new menu.  The title is what the menu will be referred to as in the Menu Manager.  Module Name is what the menu will be referred to as in the [[Screen.modules.15|Module Manager]].<br />
[[Image:Screen_menu_manager_copy_15.png|center|thumb|800x340px]]
+
*'''Delete'''. To delete a menu (and all included menu items), select the radio button, and then the "Delete" button. You will be given one last chance to change your mind. If you're sure you want to delete the menu, click the delete button one last time.<br />
 
+
*'''Edit'''. The "Edit" button allows you to change the unique name, title, description, and module name for the selected menu.
As you see, the copied menu and its menu items are also listed on this screen.
+
*'''New'''. To create a new menu, click the "New" button. You can enter a unique name, a title, description, and the name for the module that will also be created with the menu.
 
 
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:
 
 
 
[[Image:Screen_menu_manager_delete_15.png|center|thumb|800x275px]]
 
 
 
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==
 
==Quick Tips==
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 [[screen.modules.15|Module Manager]] that belongs to the respective menu.
+
* 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 [[screen.modules.15|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.
'''Create a copy in the Module Manager'''
+
* 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.
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.
+
* 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. More information can be found at the [[Screen.menus.15|Menu Manager page]]
==Points to Watch==
 
'''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==
 
Each menu is a copy of the mod_mainmenu module. These modules are listed in the [[screen.modules.15|Module Manager]] and their details and parameters can be [[screen.modules.edit.15|customized]] by opening them.
 
 
 
The menu items belonging to a specific menu listed in the [[screen.menus.15|Menu Item Manager]] can be accessed by clicking the icon in the Menu Item(s) column of the Menu Manager.
 
  
 
==Related Information==
 
==Related Information==
* [[Screen.menumanager.new.15|Menu Manager New/Edit]]
+
* To add new Menus: [[Screen.menumanager.new.15|Menu Manager New/Edit]]
* [[Screen.cpanel.15|Control Panel]]
+
* To add or edit Menu Items: [[Screen.menus.15|Menu Item Manager]]
 +
* To add or edit Menu Modules: [[screen.modules.15|Module Manager]]
  
[[Category:DocCamp]]
+
<noinclude>{{cathelp|1.5|Menu Manager Help Screens|Menus Help Screens}}</noinclude>

Latest revision as of 21:47, 3 September 2012

Access[edit]

In the backend of Joomla! use either Menus -> Menus or the icon Menus from the controlcenter.

Description[edit]

The Menu Manager controls how Joomla!'s menus will look and act.

Screenshot[edit]

Menu manager.png

Column Headers[edit]

  • 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. Amount of the current included and published menu items.
  • Unpublished. Amount of the current number of items that are not published or publicly available.
  • Trashed. Amount of the current number of items that have been deleted, but not purged from the trash manager
  • Modules Column. Because all menus are also modules, and can have more than module associated with them, this column lists the number of modules associated with the menu.
  • 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.

Toolbar[edit]

At the top right you will see the toolbar:

Menu-manager-toolbar.jpg

The functions are:

  • Copy. To copy a menu (and all included menu items), select the radio button next to it and click the "Copy" button. You can than then enter in a new title and module name for the new menu. The title is what the menu will be referred to as in the Menu Manager. Module Name is what the menu will be referred to as in the Module Manager.
  • Delete. To delete a menu (and all included menu items), select the radio button, and then the "Delete" button. You will be given one last chance to change your mind. If you're sure you want to delete the menu, click the delete button one last time.
  • Edit. The "Edit" button allows you to change the unique name, title, description, and module name for the selected menu.
  • New. To create a new menu, click the "New" button. You can enter a unique name, a title, description, and the name for the module that will also be created with the menu.

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 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. More information can be found at the Menu Manager page

Related Information[edit]