Custom CSS Loader
osTicket-Plugin, das eigene CSS-Dateien aus assets/custom/css automatisch in Staff Panel und Client Portal einbindet. Der Dateiname mit staff oder client bestimmt den Bereich.
Custom CSS Loader
Diese Dokumentation beschreibt immer die aktuell veröffentlichte Version.
Live Demo: Teste alle Plugins für OXID eShop, Shopware und osTicket von Markus Michalski live, ohne Installation und ohne Risiko: demo.markus-michalski.net
Überblick
Das Plugin lädt eigene CSS-Dateien aus assets/custom/css/ automatisch in das Staff Panel und das Client Portal von osTicket. Welche Datei wo erscheint, bestimmt der Dateiname: Namen mit staff gehen ins Staff Panel, Namen mit client ins Client Portal.
Ohne dieses Plugin: Eigene Styles bedeuten Änderungen an Templates oder Core-Dateien, die bei Updates verloren gehen.
Mit diesem Plugin: Du legst CSS-Dateien in einen Ordner, das Plugin bindet sie vor dem ersten
</head>der Seite ein.
graph LR
A["Seitenaufruf"] --> B["Kontext: Staff oder Client"]
B --> C["CSS-Dateien in assets/custom/css suchen"]
C --> D["Link-Tags vor dem ersten head-Ende einfügen"]
D --> E["Seite mit eigenem CSS"]
Dokumentation
| Seite | Inhalt |
|---|---|
| Installation | ZIP oder Git, Composer-Autoloader, Aktivierung, CSS-Ordner, Update |
| Konfiguration | Die zwei Felder |
| Verwendung | Dateinamen-Regeln, Reihenfolge, Demo-Dateien, Beispiele |
| Technische Details | Ablauf, Klassen, Kontext-Erkennung, Sicherheitsprüfungen |
| Fehlerbehebung | CSS wird nicht geladen, Ordner, Demo-Dateien, häufige Fragen |
Funktionen
| Funktion | Beschreibung |
|---|---|
| Automatisches Laden | Alle passenden .css-Dateien im Ordner werden eingebunden, ohne Einzelkonfiguration |
| Kontext über Dateinamen | staff im Namen für das Staff Panel, client für das Client Portal (ohne Beachtung der Groß-/Kleinschreibung) |
| Cache-Busting | Jede URL erhält ?v= mit der Änderungszeit der Datei |
| Demo-Dateien | Beim ersten Aktivieren in ein leeres Verzeichnis kopiert |
| Sicherheitsprüfungen | Dateinamen-Allowlist, Schutz vor Symlinks außerhalb des Ordners, escaped URLs |
| Keine Core-Änderungen | Einbindung über Output-Buffering, es werden keine osTicket-Dateien verändert |
Anforderungen
| Anforderung | Version | Hinweise |
|---|---|---|
| osTicket | 1.17 oder neuer | Laut plugin.php |
| PHP | 8.1 oder neuer | Laut plugin.php und composer.json |
| Composer-Autoloader | im Release-ZIP enthalten | Bei einem Git-Clone musst du composer install ausführen |
Lizenz
GNU General Public License v2 oder neuer, siehe LICENSE.
Support
Fehler und Fragen im Issue Tracker. Gib dabei osTicket-Version, PHP-Version, Plugin-Version, Browser-Konsolenfehler und bei Bedarf den Inhalt der CSS-Datei an.