Magnolia 6.1 documentation

Magnolia 6.1 reached end of life on March 31, 2021. This branch is no longer supported, see End-of-life policy.

Page tree
Skip to end of metadata
  • Created on 2019-01-21, last edited by Martin Drápela on 2019-10-14
Go to start of metadata

The App launcher is a key navigation page in Magnolia you can access using the   icon at the top of every page (to the right of the Find Bar).

The App launcher layout organizes apps into groups and defines what the groups look like. You can find the layout configuration in /modules/ui-admincentral/config/appLauncherLayout.

Node name

Value

 modules


 ui-admincentral


 config


  appLaucherLayout


 groups


 edit


 apps


 pages


 assets


 ...


 defaultGroup

edit

 hiddenApps


 tasks

tasks-app


Properties:

groups

required

List of app groups.

<group‑name>

required

App group name. This internal name is not displayed to users. Users see the group label instead.

apps

required

List of apps in the group.

<app‑name>

required

Name of an app that belongs to the group. The name must match the name given in the app configuration, for example pages.

permissions

optional

Defines which users can see the app in the app launcher. This allows you to provision the app to a limited group of users in your organization. See App permissions.

clientGroup

optional, default is false

Moves the group to the bottom of the app launcher and sets the groups color to white. Set the property to true when you create your own app groups. This way they stand apart from the Magnolia native apps and editors can identify them as your company's apps.  

label

optional

Text displayed on the group tile. Use a label that says something common about the apps in the group such as Edit or Manage. The system transforms the case to ALL CAPS.

defaultGroup

optional, default is edit

Under the groups node, the property defines the group where a new app is added automatically, provided the app has not been added to another group of the layout.During installation, Magnolia sets the value of the defaultGroup property to edit. During an update, it is set to edit only if the property has not been set already.

hiddenApps

optional

List of apps to be hidden in the App launcher.

<app-name>

optional

Name of an app which should not be shown in the App launcher. The name of the property is arbitrary.