Custom CSS Loader: Fehlerbehebung

Fehlerbehebung für Custom CSS Loader: Fatal Error ohne Autoloader, CSS wird nicht geladen, falscher Bereich, fehlender CSS-Ordner, Demo-Dateien und häufige Fragen.

English Version

Zurück zur Übersicht

Custom CSS Loader: Fehlerbehebung

Problem: Plugin lässt sich nicht laden (Fatal Error)

Ursache: vendor/autoload.php fehlt. Das passiert bei einem Git-Clone, weil vendor/ nicht im Repository liegt.

Lösung: Führe im Plugin-Ordner composer install --no-dev aus oder verwende das Release-ZIP (siehe Installation).

Problem: CSS wird nicht geladen

Symptome:

Die Styles greifen nicht.
Im Seitenquelltext steht kein Block .

Prüfung:

Ist das Plugin aktiviert und die Option Enable Custom CSS Loader eingeschaltet?
Liegt die Datei in <osTicket-Hauptverzeichnis>/assets/custom/css/ und endet sie auf .css (kleingeschrieben)?
Enthält der Name staff oder client? Ohne eines von beiden wird die Datei ignoriert.
Ist der Name gültig? Er beginnt mit Buchstabe oder Ziffer und enthält nur Buchstaben, Ziffern, _ und -. Blockierte Namen stehen im PHP-Error-Log als Invalid filename blocked.
Ist die Datei für den Webserver lesbar (zum Beispiel chmod 644)?
Hat die Seite ein </head>? Ohne dieses Tag wird nichts eingefügt.
Liegt die Datei in einem Unterordner oder ist sie ein Symlink nach außerhalb? Beides wird nicht geladen.

Problem: CSS wird geladen, wirkt aber nicht

Prüfe in den Entwicklertools des Browsers (F12), ob die Datei geladen wurde und ob Syntaxfehler gemeldet werden.
osTicket-Styles können eine höhere Spezifität haben. Ergänze !important oder einen genaueren Selektor.
Der Browser kann ältere Versionen zwischenspeichern, obwohl die URL ?v= mit der Änderungszeit enthält. Lade die Seite hart neu.
Mehrere Dateien werden alphabetisch geladen, spätere Dateien überschreiben frühere.

Problem: Die Datei erscheint im falschen Bereich

Der erste Treffer gewinnt, und staff wird vor client geprüft. Ein Name wie client-staff.css zählt deshalb als Staff-Datei. Nenne die Datei so um, dass nur ein Begriff vorkommt.

Problem: CSS-Ordner wird nicht angelegt

Der Webserver-Benutzer darf im osTicket-Hauptverzeichnis nicht schreiben. Lege den Ordner manuell an:

mkdir -p /pfad/zu/osticket/assets/custom/css
chmod 755 /pfad/zu/osticket/assets/custom/css

Problem: Demo-Dateien wurden nicht kopiert

Das Plugin kopiert nur beim Aktivieren und nur, wenn der Ordner noch keine .css-Datei enthält. Kopiere die gewünschten Dateien aus include/plugins/custom-css-loader/assets/demo/ von Hand.

Häufige Fragen

Ändert das Plugin osTicket-Dateien?

Nein. Die Link-Tags werden über Output-Buffering in die Seite eingefügt.

Gehen meine CSS-Dateien beim Deaktivieren verloren?

Nein. Deaktivieren und Update lassen den Ordner assets/custom/css/ unangetastet.

Beeinflusst das Plugin die API?

Nein, für Aufrufe unter /api/ wird kein CSS eingefügt.

Welche Versionen werden benötigt?

osTicket 1.17 oder neuer und PHP 8.1 oder neuer. Die CI führt die Tests mit PHP 8.1 bis 8.4 aus.