AdminCentral configuration

Magnolia's user interface for authors and administrators is called "AdminCentral".

AdminCentral On the left hand side is the menu with which authors and administrators can select which task they want to perform in Magnolia. The title and details of the content are displayed in the content area on the right.

The menu

Configuring the menu Because AdminCentral is implemented in the adminInterface module, the menu is configured in the adminInterface module's configuration. (there is a shortcut to the menu configuration in the "Configuration" menu item) Each node under the menu node represents a menu item that can be customized by changing the configuration properties.

A menu item can be configured with four parameters (properties): The DMS menu item

Parameter Example Description
i18nBasename info.magnolia.module.dms.messages Basename of the resource bundle with translations of the label
icon /.resources/icons/24/folders.gif Path to the menu item's icon
label dms.menu Key for translation of the label. The key will be used as label if no translation is available
onclick MgnlAdminCentral.showTree('dms') Javascript action

Javascript actions

Magnolia provides two basic Javascript methods which can be used in the menu:

MgnlAdminCentral.showTree(tree,path);
MgnlAdminCentral.showContent(URL);
MgnlAdminCentral.showTree displays a tree in the content area. If the path is passed, then the node addressed by that path will be opened in the tree. Magnolia provides prepared trees for the most important repositories listed here:
  • users
  • config
  • groups
  • website
  • userroles
  • website-jcr, which is a detailed view in the JCR structure of the website repository
With MgnlAdminCentral.showContent you can pass the URL to a web page or a path to content in Magnolia (without servlet context). The page will then be displayed in the content area: Examples:
  • http://www.magnolia-cms.com
  • /.magnolia/pages/configuration.html

If you create sub nodes under a menu item, the sub nodes will be organized in groups under that menu item. Menu groups can be identified in the menu by the arrow on the right side of the menu entry:

If you click on this item, the group opens and all the child menu actions will be visible. If you have an onclick action specified, this action will be executed as well.