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