App launcher layout

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 launcher displays apps as boxes, also known as the app launcher tiles. Click a tile to launch the associated app. Each tile has an icon and a label. Apps that have something in common belong to the same group.

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.

Page tree

App launcher layout