OTOBO Skins & Themes – Agent-Oberfläche anpassen

In diesem Guide: Erscheinungsbild der OTOBO-Agent-Oberfläche mit Skins und CSS anpassen.

Verwandte Themen: Kundenportal · OTOBO GUI · Systemkonfiguration

Es ist möglich das Aussehen des OTOBO Ticketsystems zu verändern, dafür kann man einen neuen Skin erstellen.

OTOBO Skin - Theme Einstellung ändern

Jeder Agent kann selbst auswählen welchen Skin er verwenden will. Nach der OTOBO Installation gibt es nur den Standard Skin. Der OTOBO Skin definiert das Design der Oberfläche. In seinen persönlichen Einstellungen, findet man die Option seinen aktuellen Skin durch einen anderen Skin zu ersetzen.

Neuen Skin erstellen

CSS verändern

Falls Sie eine Docker‑OTOBO‑Installation haben, finden sich die Agent‑Skins hier:

/var/lib/docker/volumes/otobo_opt_otobo/_data/var/httpd/htdocs/skins/Agent/

Bei einer Installation ohne Docker lautet der Pfad:

$OTOBO_HOME/var/httpd/htdocs/skins/Agent/$SKIN_NAME/

Neuer Ordner

Wenn noch kein Skin hinzugefügt wurde, dann findest sich in diesem Pfad nur der Ordner “default”. Um einen neuen Skin hinzuzufügen muss man zuerst einen neuen Ordner hinzufügen. Zum Beispiel “my_skin”.

Design Verändern

Um nun das Design zu verändern kann man in den Ordner “my_skin ” den Ordner “css ” erstellen. Die Skins funktionieren so, das immer der Standard CSS Skin geladen wird. In dem eigenem Skin kann man daraufhin, die Werte aus dem Standard Skin überschreiben. Indem man Beispielsweise CSS Klassen aus dem Default Skin überschreibt:

CSS aus dem Standard Skin: Skin/default/Core.css

.Navigation {
  height: 100px;
}

Könnte man zum Beispiel mit: /* Skin/my_skin/Core.css

.Navigation {
  height: 30px;
}

überschreiben.

Daraufhin muss man noch eine Konfigurations Datei im Ordner $OTOBO-HOME/Kernel/Config/Files/XML/{skinName}.xml. Diese sollte folgende Struktur haben:

<?xml version="1.0" encoding="utf-8" ?>
<otobo_config version="2.0" init="Changes">
    <ConfigItem Name="AgentLogo" Required="0" Valid="1">
        <Description Translatable="0">The logo shown in the header of the agent interface. The URL to the image must be
            a relative URL to the skin image directory.
        </Description>
        <Group>Framework</Group>
        <SubGroup>Frontend::Agent</SubGroup>
        <Setting>
            <Hash>
                <Item Key="URL">
                    https://softoft.de/Otobo_Wortmarke_Sub_Digital_Blau_156hoch-zugeschnitten-300x113.png
                </Item>
                <Item Key="StyleTop">13px</Item>
                <Item Key="StyleRight">75px</Item>
                <Item Key="StyleHeight">67px</Item>
                <Item Key="StyleWidth">244px</Item>
            </Hash>
        </Setting>
    </ConfigItem>

    <ConfigItem Name="Loader::Agent::Skin###001-softoftSkin" Required="0" Valid="1">
        <Description Translatable="0"></Description>
        <Group>Framework</Group>
        <SubGroup>Frontend::Agent</SubGroup>
        <Setting>
            <Hash>
                <Item Key="InternalName">softoftSkin</Item>
                <Item Key="VisibleName">softoftSkin</Item>
                <Item Key="Description"></Item>
                <Item Key="HomePage"></Item>
            </Hash>
        </Setting>
    </ConfigItem>
</otobo_config>

Verfügbare Skins / Themes

Es gibt bereits von anderen Firmen erstellte Skins.

OTOBO Dark Skin / Theme

Link zum Skin / Theme: Github Dark Skin

Modern Skin / Theme von Efflux

Github Link zum Skin / Theme: Efflux Modern Skin

FAQ: OTOBO Skins & Themes

Wo werden OTOBO-Agent-Skins gespeichert?

In einer Docker-Installation unter /var/lib/docker/volumes/otobo_opt_otobo/_data/var/httpd/htdocs/skins/Agent/, andernfalls unter $OTOBO_HOME/var/httpd/htdocs/skins/Agent/$SKIN_NAME/.

Wie erstelle ich einen eigenen OTOBO-Skin?

Legen Sie neben default einen neuen Ordner an (z. B. my_skin), erstellen Sie darin einen css-Ordner und überschreiben Sie die gewünschten CSS-Klassen. Registrieren Sie den Skin anschließend über eine XML-Konfigurationsdatei unter $OTOBO_HOME/Kernel/Config/Files/XML/{skinName}.xml.

Bleibt mein eigener Skin nach einem OTOBO-Update erhalten?

Damit Änderungen dauerhaft bleiben, sollten Sie Ihre Skin-Dateien in ein OPM-Paket verpacken, statt das Live-Dateisystem direkt zu bearbeiten. So wird der Skin nach Updates sauber neu installiert.

Kann jeder Agent seinen eigenen Skin wählen?

Ja. Jeder Agent kann in seinen persönlichen Einstellungen einen verfügbaren Skin auswählen. Neu installierte Skins erscheinen dort, sobald sie per SysConfig registriert wurden.

Gibt es ein Dark Theme für OTOBO?

Ja — siehe den Community-OTOBO Dark Skin und den oben genannten Efflux Modern Skin.

Häufig gestellte Fragen

Wie ändern Sie Skin oder Theme in OTOBO?

Agenten oder Admins wählen einen verfügbaren Skin/Theme; eigene Skins erstellen Sie mit CSS und registrieren sie für die Agent-Oberfläche.

Was braucht man für einen neuen OTOBO-Skin?

Ordnerstruktur anlegen, CSS anpassen und den Skin so konfigurieren, dass er als auswählbares Theme für Agenten erscheint.

Gibt es einen Dark Skin für OTOBO?

Ja. Ein Dark Skin/Theme gehört zu den verfügbaren Optionen für die Agent-Oberfläche.