docs
TYPO3 v14
Erweitern  /  Fehlerbehebung

17 — Fehlerbehebung

Sortiert danach, wie oft der jeweilige Fall tatsächlich auftritt.

Die Site rendert ohne jede Gestaltung

Fast immer die Lizenz oder das Set.

  1. Lizenzschlüssel und Produktcode eingetragen? Yavi Theme → Licence. Beide Felder sind erforderlich — ein leerer Produktcode scheitert genau wie ein falscher Schlüssel.
  2. Ist das Set des Themes aktiv? Site-Management → Sites → Sets muss yavi-lucerne/full führen, nicht yavi-core/full.
  3. Cache geleert? vendor/bin/typo3 cache:flush.
  4. Kürzlich die Domain gewechselt? Die Lizenz ist an einen Host gebunden. Die Lizenzseite einmal öffnen und speichern, damit für die neue Domain neu geprüft wird.

Eine Einstellung im Backend-Modul bleibt wirkungslos

  1. Ist config/sites/<id>/settings.yaml beschreibbar? Wenn nicht, speichert das Formular ohne Fehler, es wird aber nichts abgelegt.
  2. Ist es ein Faktorfeld? Corner rounding (factor) und Button rounding (factor) nehmen einen Multiplikator entgegen (1, 0.5, 2), keine Länge. 12px wird dort verworfen — der Wert ergäbe calc(28px * 12px).
  3. Ist es eine SCSS-Variable? Die vier Markenfarben und die Statusfarben werden ins Stylesheet kompiliert. Cache leeren.
  4. Überschreibt das Theme sie? Das Set eines Themes gewinnt gegen die Vorgabe des Core; die eigene Site-Einstellung gewinnt gegen beide — aber nur, wenn sie auch wirklich abgelegt ist, und ein Wert, der der Vorgabe entspricht, wird bewusst nicht abgelegt.

Cache leeren. Nur die ausgewählte Variante wird ins CSS kompiliert; ohne Flush bekommt man das neue Markup mit dem alten Stylesheet.

Das Backend-Modul zeigt ein Feld ohne Beschriftung oder eine nackte LLL:-Zeichenkette

Eine Sprachreferenz zeigt auf einen Schlüssel, den es nicht gibt. Den Schlüssel in Resources/Private/Language/Backend.xlf prüfen. Wenn der TYPO3-Core eine Beschriftung umbenennt — v14 hat die Palettenbeschriftungen umbenannt —, laufen alte Referenzen ins Leere.

Deutsche Beschriftungen erscheinen in einem englischen Backend

Die Standard-XLIFF-Datei trägt eine deutsche Quelle. Die Quelle in Backend.xlf korrigieren und das Deutsche nach de.Backend.xlf legen.

Übersetzungsdateien müssen de.<datei>.xlf heißen, nicht <datei>.de.xlf. Mit dem falschen Namen wird die Datei stillschweigend ignoriert, und alles bleibt englisch.

Das JavaScript des Editors im Backend tut nach einem Update nichts

Die Importmap wird über einen Hash aus Projektpfad und Extension-Versionen cache-invalidiert — aber nur außerhalb des Development-Kontexts. In Production oder einem eigenen Kontext wie Testing/Stage ändert das Bearbeiten einer JavaScript-Datei den Parameter ?bust= nicht, und der Browser behält das alte Modul. Cache leeren und mit einem harten Neuladen aktualisieren (⇧⌘R / Strg+F5).

Abstand verschwindet, sobald eine Utility-Klasse verwendet wird

Der Rahmen des Bootstrap Package trägt ein negatives margin-top. Eine Utility, die das padding-top des Rahmens überschreibt, lässt diesen negativen Abstand den Zwischenraum auffressen. Den Rahmen anpassen, statt einen weiteren Abstand hinzuzufügen.

Ein Hintergrundbild ist nicht sichtbar

Prüfen, ob ein Vorfahre zwischen Rahmen und Hintergrundcontainer position: relative bekommen hat. Der Hintergrundcontainer ist absolut positioniert und hängt sich an den nächstgelegenen positionierten Vorfahren; ein neuer hängt ihn von dem Element weg, das die Höhe trägt.

Ein animiertes Element ragt nach rechts hinaus

slide--Animationen bewegen ein Element um seine eigene Breite und werden im Moment des Starts sichtbar. Im Karussell beschneidet das Theme das horizontal (overflow-x: clip, mit overflow-y: visible, damit die Scroll-Schaltfläche unter dem Slide überlebt). Anderswo ist fade- die bessere Wahl.

Karteneinträgen fehlen die Symbolfelder

Die Palette link des Karteneintrags wurde überschrieben. Die Symbolfelder liegen im Reiter Medien des Karteneintrags, nicht in der Link-Palette.

Schriften greifen nicht

Selbst gehostete Google-Schriften werden bei Bedarf heruntergeladen und unter fileadmin/ zwischengespeichert. Ist das Verzeichnis nicht beschreibbar oder hat der Server keine ausgehende Netzverbindung, fällt die Familie stillschweigend auf den Stapel aus Font family zurück.

Methodisch eingrenzen

bash
# 1. Sind die Extensions aktiv?
vendor/bin/typo3 extension:list | grep yavi

# 2. Liegt das kompilierte Stylesheet da?
ls -l typo3temp/assets/bootstrappackage/css/

# 3. Was liefert die Seite tatsaechlich aus?
curl -s https://example.com/ | grep -o 'theme-[a-f0-9]*\.css'

# 4. Alles neu bauen
vendor/bin/typo3 cache:flush

Behebt der vierte Schritt das Problem, war es ein zwischengespeicherter Zustand — und das ist eine gute Nachricht, denn es heißt, dass die Konfiguration selbst stimmt.