App launcher layout

The App launcher is the first page you see when you log into Magnolia. The launcher displays apps as boxes – also known as the app launcher tiles. A click on a tile will launch the associated app. Each tile has an icon and a label. The 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
...
color	#9A3332
permanent	true
defaultGroup	edit
hiddenApps
buggy	cookieEditor2

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.
`color`	optional, default is #3e5900 Color of the group box. You can use any valid hex code, RBG value or color name. See Choose a safe app group color.
`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.
`permanent`	optional, default is `false` (at the bottom) Defines whether the group is displayed at the top (`true`) or bottom (`false`) in the app launcher layout.
`defaultGroup`	optional Defines the group (one from underneath the `groups` node) where a new app will be added automatically if this information is not given explicitly,
`hiddenApps`	optional List of apps to be hidden in the App launcher.
`<app-name>`	optional The value is the 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