Custom Fonts Plugin

Zum Plugin

Das DmfCustomFonts Plugin ermöglicht die Verwendung benutzerdefinierter Schriftarten in deinem Shopware 6 Shop. Du kannst eigene Schriftdateien hochladen oder aus 16 vorinstallierten Google Fonts wählen.

Inhalt dieser Seite:

• Voraussetzungen
• Installation
• Features
• Konfiguration
  • Format für Schriftdateien
• Verwendung
  • Eigene Schriftarten hochladen
  • Vorinstallierte Google Fonts
• Console Commands
  • dmf:fonts:generate
• Technische Details
  • CSS-Generierung
  • Event Listener
• Troubleshooting
  • Schriftart wird nicht angezeigt
  • CSS wird nicht geladen

---

Voraussetzungen

• Shopware 6.7.0 oder höher
• PHP 8.2 oder höher

Installation

composer require dmf/plugin-custom-fonts
bin/console plugin:install --activate DmfCustomFonts
bin/console cache:clear

---

Features

• Zwei Schriftarten-Slots: Normal Font (Fließtext) und Headline Font (Überschriften)
• Eigene Schriftdateien: Unterstützung für .woff und .woff2 Formate
• Font-Weight Support: Definiere verschiedene Schriftgewichte pro Schriftart
• Automatische CSS-Generierung: CSS wird automatisch erstellt und eingebunden
• 16 Google Fonts: Vorinstallierte Auswahl beliebter Schriftarten
• Inline oder Datei: CSS kann inline oder als separate Datei eingebunden werden

---

Konfiguration

Pfad: Einstellungen → System → Plugins → Custom Fonts → Konfiguration

Option	Typ	Standard	Beschreibung
includeAsFile	Boolean	false	CSS als separate Datei einbinden (Standard: inline)
normalFontName	Text	-	Name der Schriftart für Fließtext
normalFontFiles	Textarea	-	Schriftdateien mit Gewichtung (Format: dateiname.woff2 400)
headlineFontName	Text	-	Name der Schriftart für Überschriften
headlineFontFiles	Textarea	-	Headline-Schriftdateien mit Gewichtung

Format für Schriftdateien

Gib pro Zeile eine Schriftdatei mit optionalem Font-Weight an:

OpenSans-Regular.woff2 400
OpenSans-Bold.woff2 700
OpenSans-Light.woff2 300

Ohne Angabe des Gewichts wird 400 (normal) verwendet.

---

Verwendung

Eigene Schriftarten hochladen

1. Lade deine Schriftdateien (.woff, .woff2) in den Ordner:

   public/bundles/dmfcustomfonts/fonts/

2. Öffne die Plugin-Konfiguration im Admin

3. Trage den Schriftartnamen ein (z.B. MyCustomFont)

4. Liste die Schriftdateien mit Gewichtung auf:

   MyCustomFont-Regular.woff2 400
   MyCustomFont-Bold.woff2 700

5. Speichere die Konfiguration

Vorinstallierte Google Fonts

Das Plugin enthält 16 vorinstallierte Google Fonts, die direkt verwendet werden können:

Schriftart	Gewichte	Stil
Open Sans	400, 700	Sans-Serif
Bodoni Moda	400, 700	Serif
Figtree	400, 700	Sans-Serif
Fira Sans	400, 700	Sans-Serif
Lato	400, 700	Sans-Serif
Noto Sans	400, 700	Sans-Serif
Nunito	400, 700	Sans-Serif
Playfair	400, 700	Serif
Poppins	400, 700	Sans-Serif
PT Sans	400, 700	Sans-Serif
Roboto	400, 700	Sans-Serif
Roboto Condensed	400, 700	Sans-Serif
Source Sans 3	400, 700	Sans-Serif
Source Serif 4	400, 700	Serif
Space Grotesk	400, 700	Sans-Serif
Work Sans	400, 700	Sans-Serif

---

Console Commands

dmf:fonts:generate

Generiert die Font-CSS-Datei manuell neu.

bin/console dmf:fonts:generate

Dieser Befehl wird automatisch ausgeführt bei:

• Plugin-Aktivierung
• Plugin-Update
• Änderung der Konfiguration

---

Technische Details

CSS-Generierung

Das Plugin generiert automatisch @font-face Regeln basierend auf deiner Konfiguration:

@font-face {
    font-family: 'MyCustomFont';
    src: url('/bundles/dmfcustomfonts/fonts/MyCustomFont-Regular.woff2') format('woff2');
    font-weight: 400;
    font-display: swap;
}

Event Listener

Das Plugin reagiert auf SystemConfigMultipleChangedEvent und regeneriert das CSS automatisch bei Konfigurationsänderungen.

---

Troubleshooting

Schriftart wird nicht angezeigt

1. Prüfe, ob die Schriftdateien im richtigen Ordner liegen
2. Führe bin/console assets:install aus
3. Leere den Cache: bin/console cache:clear
4. Regeneriere das CSS: bin/console dmf:fonts:generate

CSS wird nicht geladen

Stelle sicher, dass der Dateipfad korrekt ist:

public/bundles/dmfcustomfonts/fonts/[deine-schriftdatei].woff2