Troubleshooting – Schriftarten-Manager

Hochgeladene Schrift wirkt nicht im Storefront

1. Plugin aktiv? Erweiterungen → Meine Erweiterungen → Schriftarten-Manager.
2. Schrift hat eine Zuweisung? Im Plugin-Admin die Schrift öffnen → Reiter „Zuweisungen" → muss mindestens eine aktive Regel da sein.
3. Cache leeren: bin/console cache:clear
4. Browser-Cache hart leeren (Ctrl/Cmd + Shift + R).
5. CSS-Spezifität: bei stark angepassten Themes kann das Theme-eigene font-family mit !important gesetzt sein. In der Konfig „Theme-Default überschreiben" aktivieren.

Browser zeigt Schrift, aber „Falscher Font" greift

Symptom: Die Schrift wird angezeigt, aber sieht „zu fett" oder „zu schmal" aus.

1. Variants prüfen: Hast Du Regular UND Bold hochgeladen? Sonst rendert der Browser Bold-Text mit „Faux Bold" (algorithmische Verdickung des Regular-Glyphs) – sieht schlechter aus.
2. Font-Weight im CSS-Selektor – falls Dein Theme font-weight: 600 setzt, brauchst Du Variant 600 (oder 700 als nächst-höhere).

Schrift lädt langsam oder verzögert

1. Preload-Hints aktivieren in der Konfig (default ein).
2. font-display auf swap (default) – Text wird sofort gerendert in Fallback-Schrift.
3. Schriftgröße prüfen: pro Variant sollte < 100 KB sein. Größer? → Subsetting aktivieren oder woff2 erzeugen falls ttf/otf.
4. HTTP/2 oder /3 auf Deinem Server? Mehrere Schriften parallel laden geht so schneller.

Google Fonts Import bricht ab

Symptom: „Google Fonts konnte nicht erreicht werden".

1. Server hat Internet-Zugang? Bei abgeschotteten Servern ohne ausgehende HTTPS-Verbindung scheitert der Import.
2. DNS funktioniert? Server muss fonts.googleapis.com und fonts.gstatic.com auflösen können.
3. Proxy/Firewall: ggf. Outgoing-Connections erlauben.
4. Alternative: Manuell von google-webfonts-helper.herokuapp.com runterladen und per Upload importieren.

Hochladen scheitert mit „Datei zu groß"

1. Plugin-Konfig „Maximale Dateigröße" prüfen – Default 500 KB.
2. PHP-Konfig upload_max_filesize prüfen – Default ist oft nur 2 MB.
3. Nginx/Apache client_max_body_size ggf. erhöhen.

Schrift sieht in manchen Browsern komisch aus

Symptom: In Chrome OK, in Safari schmäler/breiter.

1. Schrift-Format unterstützt? Safari < 14 versteht kein WOFF2 mit Variable Fonts. Lösung: Static-Font-Variants zusätzlich hochladen.
2. Schrift-Hinting (TrueType-Specific) – manche Schriften rendern in unterschiedlichen Engines anders. Im Zweifel mit anderer Schrift testen.
3. CSS-Override im Theme: Dev-Tools auf, prüfen, welches font-family tatsächlich greift.

Schrift wird sichtbar, aber Layout „springt"

Symptom: Beim Laden ist das Layout in Fallback-Schrift, dann „springt" auf die Zielschrift.

Ist normaler FOUT – kannst Du reduzieren durch:

1. Preload-Hints (default ein) – Browser fängt Lade-Prozess früher an
2. Schrift kleiner machen – durch Subsetting oder woff2
3. size-adjust CSS verwenden – Fallback-Schrift wird so gestreckt, dass kein Sprung passiert (modern, advanced)

Plugin-Admin lädt sehr langsam

Symptom: Schriften-Liste braucht 5+ Sekunden zu laden.

1. Anzahl Schriften > 50? Plugin paginiert dann; OK.
2. Vorschau-Generierung wiederholt für viele Variants → DB-Abfragen optimieren (kommt in nächster Version).

Hilfe holen

E-Mail an support@kommora.de mit:

• Shopware- und Plugin-Version
• Theme-Name + ungefähre Anpassungen
• Welche Schrift welches Verhalten zeigt
• Screenshot der DevTools-Network-Tab (welche Schrift-Requests werden gemacht?)
• Browser, in dem das Problem auftritt