English Version 

Englische Version

1. Log into your Confluence instance as an admin.
   
   

2. Click the admin dropdown menu (Cogwheel) and choose "Manage apps".

   

   The Manage add-ons screen loads. Enter your admin password if you are promted to.

   ---

3. Click on the Configuration of "Quick Navigation and Search". 

   
   

   
   

Configuration

Preview

After clicking onto the "Save"-Button you can see a preview of the "Link"-Button-Grid. If no content is defined for the specific button, the position number will be shown.

Use of dynamic shortcuts

9 Shortcuts are created by default. By clicking the following two Buttons, you can add new or remove existing shortcuts:

To add new shortcuts: Press the button "Add three more shortcuts". Im Anschluss erscheinen drei neue Zeilen, welche Sie nun konfigurieren können.

To delete existing shortcuts: Press the button "Remove last three shortcuts". A warning dialog appears. You can confirm the deletion here,

How to insert icons

In this section of the configuration panel, you can find instructions on how to insert icons or images into the links grid.

Link Configuration

How to insert icons:

1. Please visit the following link: Font Awesome
2. Use the search/grid to choose an icon. Click onto the icon.
   Please do not enable "Pro"-Icons, since these are not included within this app.
3. Copy the code fragment beginning with "<i" and ending with "</i>" below the icon preview.
   E.g.: This is the code fragment for a phone icon: <i class="fas fa-phone"></i>

4. Insert the copied code fragment into the icon input field.

How to use images as icons:

1. The image needs to be in one of these formats: .img/.png/.jpeg/.gif.
2. Turn on the Switch "Image als icon". (This also happens automatically if a image is dropped onto the button.)
3. Press the button "Select image" and select an image. Or just Drag-and-Drop the image onto the button.
4. The image will now be uploaded and configured. (The preview will refresh when "Save" is clicked.)

Managing permissions with the link group manager

The group manager can be opend by clicking the highlighted button in the link config table.

You can select groups in the dropdown. Only selected groups will be able to click the shortcut. This applies if you do not enable the switch "exclude selected groups".

Example configuration:

Deutsche Version 

Deutsche Version

1. Loggen Sie sich mit Administrator Berechtigung in das Confluence ein.
   
   

2. Klicken sie auf das DropDown-Menü and wählen Sie "Apps verwalten" aus.

   

   Das "Add-On Verwaltungsmenü" öffnet sich. In einigen fällen muss das Admin Passwort erneut eingegeben werden.

   ---

   3. Mit Klick auf "Quick Navigation and Search Configuration" öffnet sich die Konfiguration. 
   
   

Konfiguration

Vorschau 

Nachdem die "Save"-Schaltfläche angeklickt wurde erscheint eine Vorschau von dem "Link-Schaltflächen-Raster".

Falls kein Inhalt festgelegt wurde, wird eine Nummer als Positions-Halter angezeigt.

Dynamische Shortcuts verwenden

Standartmäßig sind 9 Shortcuts eingestellt. Über folgende zwei Buttons können sie neue Shortcuts hinzufügen oder bestehende löschen:

Zum Hinzufügen neuer Shortcuts: Drücken sie den Button "3 neue Shortcuts hinzufügen". Im Anschluss erscheinen drei neue Zeilen, welche Sie nun konfigurieren können.

Zum Löschen bestehender Shortcuts: Drücken sie den Button "Die letzten 3 Shortcuts löschen". Im Anschluss erscheint ein Dialog mit einer Warnung. Nun können sie den Löschvorgang bestätigen und die letzten 3 Zeiten werden gelöscht,

Symbole einfügen 

In diesem Teil des Menüs sind die Schritte zum Hinzufügen eines Symbols oder Bildes in das Raster beschrieben. 

Link Konfiguration 

Setzen eines icons:

1. Bitte diesem Link folgen: Font Awesome
2. Auf der Seite können Symbole ausgewählt werden. 
   Bitte keine Pro-Symbole benutzen, da diese nicht unterstützt werden. 
3. Auf der Symbol-Vorschau die zeile mit   "</i>" kopieren.
   Z.b. ein Telefonsymbol würde lauten :  <i class="fas fa-phone"></i>
4. Der kopierte Text kann nun in dem Icon Feld eingefügt werden.

Setzen eines Bildes als Icon:

1. Das Bild muss eines dieser Formate haben: .img/.png/.jpeg/.gif.
2. Den Schalter in der Spalte "Bild als Icon" einschalten. (Dies passiert auch Automatisch, wenn ein Bild auf den Button gedroppt wird.)
3. Den Button "Bild auswählen" drücken und das Bild auswählen. Oder das Bild einfach per Drag-and-Drop auf den Button ziehen.
4. Das Bild wird hochgeladen und automatisch konfiguriert. (Die Vorschau wird beim Drücken von "Speichern" aktualisiert.)

Verwalten von Berechtigungen mit dem link group manager

Der Gruppen Manager kann mit einem Klick auf den Gruppen Button geöffent werden.

Sie können nun im Dropdown Menü Gruppen auswählen. Nur die ausgewählten Gruppen werden den Shortcut anklicken können. Diese Regel wird Angewand wenn sie den Schalter "Ausgewählte Gruppen exkludieren" nicht eingeschaltet haben.

Beispiel Konfiguration: