Shortcut Organizer for Confluence - Systemadministration

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,

The shortcuts will be deleted after the "Save" button is clicked.

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

PositionPosition in "Links"-Grid – Position number can be seen in preview.
NameName of the service, you want to link.
LinkLink of the service.
IconInput field for icon code fragment. See "How to insert icons" on the configuration panel for instructions.
ColorClick onto the filled rectangle, to change the color of icon and text.
Image as iconBy activating the switch, you can set an image as a icon. See "How to use images as icons" for further information.


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.)
Note: If you want to use a Image from the web (URL/Link adress). Turn on the Switch "Image as icon" and enter the URL/Link adress into the "Icon" input field.


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".

If you turn on "exclude selected groups". The users with the chosen groups will not be able to click the shortcut.



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,

Die Shortcuts werden erst beim Drücken auf "Speichern" 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 

PositionPosition in "Links"-Raster - Positions Nummer kann in der Vorschau angezeigt werden.
NameName des Services, welcher verlinkt werden soll.
LinkLink des Services.
IconEingabefeld für das Symbolcodefragment. Weitere Informationen finden Sie unter "Einfügen von Symbolen" auf der Konfigurationsseite.
ColorDurch Klicken auf das ausgefüllte Rechteck kann die Farbe des Symbols und des Texts angepasst werden.
Bild als IconDurch das Aktivieren des Schalters können Bilder als Icons verwenden. Mehr informationen siehe Punkt "Setzen eines Bildes als Icon".

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.)
Info: Wenn Sie ein Bild aus dem Internet (URL/Link Adresse) verwenden möchten, schalten sie den Schalter "Bild als Icon" ein und fügen sie die URL/Link Adresse in das Eingabefeld in der Spalte "Icon" ein.


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.

Wenn sie den Schalter "Ausgewählte Gruppen exkludieren" einschalten, wird es den User mit den ausgewählten Gruppen nicht möglich sein, dieses Shortcut zu verwenden.



Beispiel Konfiguration: