App Center - Access your external tools
Create your own set of apps to access external systems from within your intranet
See the documentation for your Release
Table of Contents
Confluence compatibility
| Plugin | 5.7 | 5.8 | 5.9 | 5.10 | 6.0 | 6.1 | 6.2 | 6.3 | 6.4 | 6.5 | Data Center |
|---|---|---|---|---|---|---|---|---|---|---|---|
| Release 1.4 |  | |  | | | | | | | | |
| Release 1.3 | | | | | | | | | | | |
| Release 1.2 | | | | | | | | | | | |
Admin Configuration
Within the General Configuration of Confluence please locate the section "App Center"
The administration view offers two views
| App Center Configuration | Including 3 tabs with further settings |
| Settings | Configure general settings |
App Label | Manage app labels |
Categories | Manage app categories |
Manage apps | Create, edit and remove apps |
Manage Apps
This view lists all the apps that have previously been defined. This is the place to add, edit or remove apps.
Above and below the table
Select all | Selects all apps for bulk edit view. |
|---|---|
Edit | Opens the bulk edit view for the selected apps. The button is disabled if no app is selected. |
Create new App | Opens the create new app view. |
Table
| Bulk edit | If checked, the app will be taken for bulk edit action. |
|---|---|
| Icon | The icon of the app |
| Title | A short name to identify the app, shown to the user. |
| Link | The URL where the external app is located. This can be any external or internal link. At this point, local applications cannot be linked, though. |
| Categories | Each app can be assigned to one or more categories. Especially useful if you offer a large number of apps. |
| App Label | Each app can be assigned to one or more labels. Especially useful if you offer a large number of apps. |
| Rec'd | A tick icon shows if the app is marked as a recommended app for some or all users. |
| Mand | A tick icon shows if the app is marked as a mandatory app for some or all users. |
| Vis | A tick icon shows if the app is marked to be only visible if the user profile matches a custom criteria (the column is only visible if at least one app has a restricted visibility) |
| Actions | Click these icons to edit or delete an app. Once deleted, the app cannot be restored. You'll have to add it again. |
Defining categories for apps
Switch to "App Center Configuration" and select the tab "Categories" to define as many categories as you need for sorting your apps. The more apps you offer, the more categories you should define to make it easier for users to find what's important for them.
To delete a category, simply click the trashcan icon. A deleted category cannot be restored and has to be added again, if you deleted it by mistake.
You may also define sub categories, this let's you sort your apps even better!
Defining labels for apps
Switch to the tab "App Label" to define as many labels as you need for labeling your apps. Labels can be used to show special use cases for apps (e.g. "mobile"). One label can be displayed on the app tile.
To delete a label, simply click the trashcan icon. A deleted label cannot be restored and has to be added again, if you deleted it by mistake.
Additional Settings
Display Settings
| Link to App Center | If your theme shows the standard Confluence application header, you'll find a new item "App Center" there. But maybe you already placed a list of apps or the users' favorite apps as macro on your dashboard or have other reasons for not wanting this link to show up there. In this case you'll find a checkbox on the "Settings" tab. Simply uncheck it, and the item inside the application header is gone. |
|---|---|
| Configuration of app details | If you want new apps to be highlighted in principle in the App Center check the "mark as new" checkbox. You can decide per app if you want to use this feature |
| Custom field | You may add a custom attribute to your app to provide further information. |
Configuration for profile based content
Create / Edit Apps
App Details
| URL | The URL where the external app is located. This can be any external or internal link. At this point, local applications cannot be linked, though. |
|---|---|
| Key | An optional identifier for an app. This is used to display hand-picked apps on a Confluence page, which is described below. |
| Title | The displayed title of your app. |
| Short description | A short description to provide further information for your app |
| Custom Field | The given custom field (int this case "Abteilung") |
| Tile Picture | The image icon of your app. |
| Labels | Each app can be assigned to one or more categories. Especially useful if you offer a large number of apps. One of the Label can be displayed for users in the app view, just select on label by clicking on it. |
| Contact | An optional information to tell users who to contact, if they have questions or problems with the app. |
| Category | Each app can be assigned to one or more categories. Especially useful if you offer a large number of apps. |
Visibility
| "Recommended app" settings | A tick icon shows if the app is marked as a recommended app for some or all users. |
|---|---|
| "Mandatory app" settings | A tick icon shows if the app is marked as a mandatory app for some or all users. |
| "Visibility" settings | A tick icon shows if the app is marked to be only visible if the user profile matches a custom criteria (the column is only visible if at least one app has a restricted visibility) |
Bulk edit apps
You are able to select several apps in the overview and change them all at once.
- Select the to be edited apps
- Click the edit button on top or bottom of the table
After clicking the edit button, the bulk edit view appears.
On top there's a list of the selected apps. By clicking "Change selection" you can change them.
When clicking the "Change selection" button, your values filled in bulk edit view will be lost
You can set the values like you do for a single app. Some fields (like "Title" and "Link") are hidden.
Every input has a further checkbox on the left. The values are only set for the selected apps, if the checkbox is checked.
If all apps share the same value for a field, it will be prefilled with this value.
Personalizing apps (only available with the Linchpin Manager Plugin)
You may define mandatory and recommended apps, as well as configuring visibilty of apps according to profile values.
Especially if you have a large number of users and apps, it's common that not all apps are equally important for every user. That's why we added the possibility to define recommend and mandatory apps, as well as general visibility only to certain users, based on their profile information. The first step to do this is to define, which profile fields are relevant. You can define up to three fields.
In a second step you define for each app, in which cases it should be shown as a recommended, mandatory app or if this app should only be visible for specific users. If you haven't configured any profile fields or leave them empty, the app will be recommended, mandatory or visible for every user.
In our example, all users who are member of the department "Marketing" will automatically have this app added to their "myApps" section (Mandatory app). Besides this, the app itself will be only visible if you are working in this or the financial department. Other users cannot see this app at the App Center.
You can use wildcards and logical operators for more complex filtering arguments. Please refer to the page Useful admin information for more information.