Joomla! Documentation™

Description

The Components Menu Container is used to show a component container in the Administrator interface. Quick Tips: A use case.

How to Access

Add a new menu item 'Componets Menu Container'

• Select from the dropdown menu at the top ' Administrator'

• Select Menus → [name of the menu] → Add New Menu Item from the dropdown menu of the Administrator Panel

• Click the 'Menu Item Type' Select button

• Select System Links → Componets Menu Container in the modal popup window.

Edit an existing menu item 'Componets Menu Container'

• Click on the menu item's Title in Menu items.

Screenshot

Form Fields

The Component Container has the following settings:

• Menu Title. The title that will display for this menu item.

• Alias. The internal name of the menu item. Normally, you can leave this blank and Joomla will fill in a default value. The default value is the Title in lower case and with dashes instead of spaces. You may enter the Alias manually. Learn more about Aliases.

Details

• Menu Item Type. The Menu Item Type selected when this menu item was created. This can be one of the core menu item types or a menu item type provided by an installed extension.
• Show or Hide Menu Items. Select the menu items that should or should not be shown under this container. If there are no items to show, then this container will also be hidden.
  Note: When you install a new component it will be displayed by default until you come back here and hide it too.

---

• Menu. Shows which menu the menu item will appear in.

• Parent Item. The parent menu item for this menu item. Used to determine whether a Menu Item is a top-level item or a submenu item.
  • Menu Item Root: Select the default value if this is a top-level Menu Item.
  • [menu item title]: Select the Menu Item that is this menu item's parent.

• Ordering. Indicates the order of this Menu Item in the Menu. The default Order is to add the Menu Item to the end of the Menu. This Menu Item will moved to the order position just after the Menu Item selected from the dropdown list. Note: The Order can also be changed in Menu Items.

• Status. (Published/Unpublished/Trashed) The published status of the menu item.

• Note. Menu item note. This is normally for the site administrator's use (for example, to document information about this menu item) and does not show in the Frontend of the site.

Toolbar

At the top left you will see the toolbar.

The functions are:

• Save. Saves the menu item and stays in the current screen.

• Save & Close. Saves the menu item and closes the current screen.

• Save & New. Saves the menu item and keeps the editing screen open and ready to create another menu item.

• Save as Copy. Saves your changes to a copy of the current menu item. Does not affect the current menu item.
  Note: This toolbar icon is only shown if you edit an existing menu item.

• Close. Closes the current screen and returns to the previous screen without saving any modifications you may have made.

• Help. Opens this help screen.

Quick Tips

Suppose you only wish to show certain users links to a subset of the Components on your site. Super Users will see links to everything of course. You can do this as follows:

• Create a new User Group named, say Branch, with Public as parent.

• Set the Global Permissions for this group to Allow Administrator Login.

• Create a new menu named, say, Branch Menu with no imported presets.

• Create a linked Module named, say, Branch Menu with menu to show as Branch Menu. Set Check Menu to No and Access to Public.

• Create a Components Menu Container menu item for the Branch Menu named, say, Branch Components.
  • Hide any components that you do not wish the Branch users to see.
  • Show those to which they should have access.

• Set the Component Permissions for the Branch Group to allowed for all except Configure ACL and Configure Options.

For a Super User the Administrator menu will have an obvious duplication of links. However, a Branch user will only see the Branch Components menu and the Home Dashboard. You will need to adjust the Access permissions of the Quick Icon modules there too! And you really need to create a Dashboard module for any components Branch users have access to.

For users who need access to Articles you can add more menu items to the Branch Menu. In this way you can build a complete custom menu for Branch users.

Related Information

Adding a Custom Administrator Menu : Suppose you have a user who you wish to allow to perform one task only on your website. Take the case of an organisation that has branches all over the world and the only task each branch is allowed to perform is to place locations on a map for display on the site. The component for this task is Ffmap but that will not be covered here other than the Administrator menu items involved.