Konfigurationsschema
Vollständige Referenz aller Felder aus theme.json des DmfGuppyTheme, gruppiert nach Bereich. Zugriff im Admin: Inhalte → Themes → Guppy Theme → Konfigurieren.
Layout & Container
Container-Breiten
| Konfiguration | Typ | Default | Beschreibung |
|---|---|---|---|
guppy-container-width-default | text | 1400px | Standard-Container |
guppy-container-width-fluid | text | 100% | Fluid-Container |
guppy-container-width-sm | text | 1230px | kleine Container |
Container-Padding
| Breakpoint | Konfiguration | Default |
|---|---|---|
| XXL | guppy-container-default-padding-x-xxl | 48px |
| XL | guppy-container-default-padding-x-xl | 48px |
| LG | guppy-container-default-padding-x-lg | 48px |
| MD | guppy-container-default-padding-x-md | 48px |
| SM | guppy-container-default-padding-x-sm | 24px |
| Mobile | guppy-container-default-padding-x-mobile | 10px |
Allgemeine Einstellungen
Tab Layout, Block Allgemeine Einstellungen:
| Konfiguration | Typ | Default | Wirkung |
|---|---|---|---|
guppy-border-radius | text | 4px | Basis-Eckenradius des Themes (seit 2.9.0) |
guppy-slider-arrows-round | switch | aus | runde Slider-Pfeile (seit 2.9.0) |
guppy-ui-icons-phosphor | switch | aus | Phosphor-Glyphen für Formular- und Bedienelemente (seit 2.9.0) |
Eckenradius (guppy-border-radius): Ein px-Wert wird in rem umgerechnet (4px = 0.25rem), ein rem-Wert bleibt, wie er ist, und ein Wert ohne Einheit zählt als px (0 ergibt eckige Ecken, 8 entspricht 8px). Ein leeres Feld oder eine andere Einheit fällt auf 0.25rem zurück. Das Feld setzt Bootstraps $border-radius (--bs-border-radius) für Cards, das Account-Menü, .btn-close, Galerie-Thumbnails, Filter-Elemente und die übrigen Komponenten, die den Basisradius nutzen. Die kleinen, großen und extragroßen Radien werden daraus mit festen Faktoren abgeleitet (×0.6, ×1.5, ×3, ×6), daher folgen auch Footer-Logos und Slider-Pfeile. Mit dem Default 4px ist die Ausgabe dieselbe wie vor 2.9.0. Inputs und Buttons behalten Input & Button-Eckenradius (sw-input-btn-border-radius), Produktboxen den Radius aus dem Tab Guppy Cards (guppy-cards-border-radius).
Runde Slider-Pfeile (guppy-slider-arrows-round): Wenn aktiv, sind die Vor-/Zurück- und Play-/Pause-Buttons der Elemente Bild-Slider, Bildergalerie und Splide-Slider Kreise, unabhängig vom Eckenradius. Produkt- und Cross-Selling-Slider behalten ihre Pfeile. Wenn inaktiv, behalten die Pfeile den Basisradius × 2 (abgerundete Quadrate).
Phosphor-Icons für Formular- und Bedienelemente (guppy-ui-icons-phosphor): Wenn aktiv, nutzen das X des Schließen-Buttons, der Select-Pfeil, der Checkbox-Haken, der Accordion-Pfeil und die Validierungs-Icons von Formularfeldern Phosphor-Glyphen in der Stärke Bold statt der Bootstrap-Glyphen. Farben, Größen und Positionen bleiben. Guppy blendet die Validierungs-Icons aus, diese beiden erscheinen daher nur in einem Child-Theme, das sie aktiviert. Radio-Punkt, unbestimmte Checkbox, Switch-Knopf und der dunkle Farbmodus behalten die Bootstrap-Glyphen. Die zugehörigen SCSS-Variablen stehen unter Theme-Variablen → Icons.
CMS-Section-Padding
Erweitert Erlebniswelten-Sections um zusätzliche Padding-Optionen, direkt im Section-Settings-Modal:
| Konfiguration | Typ | Default | Beschreibung |
|---|---|---|---|
guppy-cms-section-padding-x | text | 48px | horizontales Padding |
guppy-cms-section-padding-y | text | 48px | vertikales Standard-Padding |
guppy-cms-section-padding-y-2x | text | 96px | extra vertikales Padding (2x) |
Section-Optionen im Editor:
| Option | Wirkung |
|---|---|
| Horizontales Padding | aktivieren/deaktivieren |
| Padding Oben & Unten | Standard-Y-Padding |
| Extra Groß (2x) | doppeltes Y-Padding |
| Padding Oben | nur oben (mit Option Kein Abstand) |
| Padding Unten | nur unten (mit Option Kein Abstand) |
Anpassung im Child-Theme:
$guppy-cms-section-padding-x: 32px;
$guppy-cms-section-padding-y: 64px;
$guppy-cms-section-padding-y-2x: 128px;Header
Header-Variante
| Konfiguration | Typ | Optionen | Default |
|---|---|---|---|
guppy-header | select | default, compact, extended, simple | extended |
| Variante | Beschreibung |
|---|---|
default | Shopware-Standard-Header |
compact | Guppy Standard, kompakt |
extended | mit Top-Bar |
simple | minimalistisch |
Header-Optionen
| Konfiguration | Typ | Default | Wirkung |
|---|---|---|---|
guppy-header-max-height | text | 22px | maximale Logo-Höhe |
guppy-topbar-background-color | color | #EEEEEE | Hintergrundfarbe der Top-Bar |
guppy-header-skip-to-main-content | bool | false | Skip-Link zum Hauptinhalt |
guppy-header-skip-to-main-nav | bool | false | Skip-Link zur Navigation |
guppy-header-skip-to-search | bool | false | Skip-Link zur Suche |
Skip-Links ab 3.0.0 standardmäßig aktiv
Guppy 3.0.0 ändert den Default der drei Skip-Link-Felder auf true, die Storefront rendert also mit Default-Konfiguration Skip-Links, wie der Shopware-Core. Bis dahin rendert die Default-Konfiguration keine. Wenn sie nach 3.0.0 aus bleiben sollen, speichere für die drei Felder jetzt false. Die Theme-Verwaltung speichert nur Werte, die sich seit dem Laden der Seite geändert haben: Schalte jedes Feld ein, speichere, schalte es wieder aus und speichere noch einmal.
Footer
Footer-Variante
| Konfiguration | Typ | Optionen | Default |
|---|---|---|---|
guppy-footer | select | default, guppy-default | guppy-default |
Footer-Konfiguration
| Konfiguration | Typ | Default | Wirkung |
|---|---|---|---|
guppy-footer-border-top-color | text | default-border | obere Rahmenfarbe |
guppy-footer-show-payment-methods | bool | false | Zahlungsarten anzeigen |
guppy-footer-show-shipping-methods | bool | false | Versandarten anzeigen |
Zusatzfelder für Versand-/Zahlungsarten
DmfGuppyTheme legt das Custom-Field-Set guppy_footer_options an:
| Feld | Typ | Wirkung |
|---|---|---|
guppy_hide_in_footer | bool | wenn aktiv: Methode nicht im Footer anzeigen |
guppy_alternative_label | text | überschreibt den Tooltip-Namen beim Hover |
Social-Media-Links
Seit 2.7.12 keine Theme-Konfiguration mehr, sondern das Custom-Field-Set guppy_social_media_links an der Entität sales_channel. Damit gelten die Links pro Verkaufskanal und pro Sprache. Alle Felder sind vom Typ text und erwarten die vollständige URL.
| Feld | Plattform |
|---|---|
guppy_social_media_instagram_threads | Instagram-Threads |
guppy_social_media_instagram | |
guppy_social_media_linkedin | |
guppy_social_media_youtube | YouTube |
guppy_social_media_x | X (Twitter) |
guppy_social_media_facebook | |
guppy_social_media_tiktok | TikTok |
guppy_social_media_xing |
Die früheren Theme-Felder guppy-footer-social-media-* wurden in 2.8.0 aus der theme.json entfernt. Details zum Umzug und zur Migration: Footer → Social-Media-Links.
Custom-Section-Bilder (1–4)
| Konfiguration | Typ |
|---|---|
guppy-footer-custom-section-image-1 | media |
guppy-footer-custom-section-image-1-link | text |
guppy-footer-custom-section-image-2 | media |
guppy-footer-custom-section-image-2-link | text |
| (bis Bild 4) | … |
USP-Banner
Das USP-Banner steckt seit Guppy 2.8.0 nicht mehr in der Theme-Konfiguration, sondern im Plugin DmfUspBanner. Die guppy-usp-*-Konfigurationen sind entfallen, ihre Werte räumt eine Migration aus der Theme-Konfiguration ab.
Gepflegt wird das Banner im Admin unter Inhalte → USP-Banner, dort pro Verkaufskanal und pro Sprache. Die Hintergrundfarbe der Top-Bar bleibt im Theme und heißt jetzt guppy-topbar-background-color.
Productcards
| Konfiguration | Typ | Optionen | Default |
|---|---|---|---|
guppy-productcard-config | select | default, guppy-default | guppy-default |
guppy-productcard-protective-frame | bool | – | true |
guppy-productcard-image-object-fit | select | contain, cover | contain |
Productdetail
Buybox
| Konfiguration | Typ | Default | Wirkung |
|---|---|---|---|
guppy-detail-buybox-styling | select | default | default, border, background |
guppy-detail-headline-buybox | bool | true | Produktname in Buybox |
guppy-detail-buybox-contact | bool | false | Kontaktinfo anzeigen |
guppy-detail-buybox-contact-hotline | bool | false | Hotline anzeigen |
guppy-detail-buybox-hide-quantity-buttons | bool | false | Mengen-Buttons ausblenden |
guppy-detail-mobile-title-above-gallery | bool | false | Produkttitel über der Galerie auf Mobile |
Galerie und Tabs
| Konfiguration | Typ | Default | Wirkung |
|---|---|---|---|
guppy-detail-gallery-scroll | bool | false | Galerie scrollt mit Inhalt |
guppy-detail-display-properties-as-tab | bool | false | Eigenschaften als separater Tab |
Login & Registrierung
| Konfiguration | Typ | Optionen | Default |
|---|---|---|---|
guppy-login-register | select | default, compact | compact |
Veraltet seit 2.9.0
guppy-login-register und sein Tab Login & Registrierung haben seit 2.7.0 keine Wirkung: Login- und Registrierungsseite rendern die Shopware-Templates, egal welchen Wert das Feld hat. Seit 2.9.0 sagen Label und Hilfetext das auch ("ohne Wirkung seit 2.7.0, entfällt in 3.0.0"). Guppy 3.0.0 entfernt Feld und Tab, eine Migration entfernt den gespeicherten Wert. Entferne vorher theme_config('guppy-login-register') aus Child-Theme-Templates und das Feld aus der theme.json eines Child-Themes.
Das Checkout-Feld guppy-checkout wurde in 2.7.0 entfernt. Seit 2.9.0 entfernt die Migration Migration1792627200RemoveRetiredCheckoutThemeConfigKey auch seinen gespeicherten Wert, den manche Shops im Theme-Manager noch als loses Feld unter "Allgemein" anzeigten. Sie läuft mit bin/console plugin:update DmfGuppyTheme.
Badges
Basis
| Konfiguration | Typ | Default |
|---|---|---|
guppy-badges-show-outline | bool | false |
Neu-Badge
| Konfiguration | Typ | Default |
|---|---|---|
guppy-badges-new-background-color | color | #22C087 |
guppy-badges-new-color | color | #FFFFFF |
guppy-badges-new-outline-color | color | #FFFFFF |
Top-Seller-Badge
| Konfiguration | Typ | Default |
|---|---|---|
guppy-badges-top-seller-background-color | color | #F89C00 |
guppy-badges-top-seller-color | color | #FFFFFF |
guppy-badges-top-seller-outline-color | color | #FFFFFF |
Discount-Badge
| Konfiguration | Typ | Default |
|---|---|---|
guppy-badges-discount-background-color | color | #E10036 |
guppy-badges-discount-color | color | #FFFFFF |
guppy-badges-discount-outline-color | color | #FFFFFF |
Ausverkauft-Badge
| Konfiguration | Typ | Default |
|---|---|---|
guppy-badges-show-out-of-stock | bool | false |
guppy-badges-out-of-stock-background-color | color | #EEEEEE |
guppy-badges-out-of-stock-color | color | #303030 |
guppy-badges-out-of-stock-outline-color | color | #303030 |
Ein Produkt gilt als ausverkauft, wenn im Produkt die Option "Abverkauf" aktiviert ist und der Bestand unter der Mindestbestellmenge liegt.
Wird das Ausverkauft-Badge auf einer Produktkarte angezeigt (weil das Produkt ausverkauft ist), verdrängt es die anderen Badges (Neu, Top-Seller, Discount) auf dieser Karte. Bei Produkten, die nicht ausverkauft sind, ändert sich nichts.
Alerts
Farben
| Konfiguration | Typ | Default | Wirkung |
|---|---|---|---|
guppy-alert-color-success | color | #D3F2E7 | Erfolg-Hintergrund |
guppy-alert-color-success-text | select | dark | Erfolg-Textfarbe |
guppy-alert-color-info | color | #CEEDFE | Info-Hintergrund |
guppy-alert-color-info-text | select | dark | Info-Textfarbe |
guppy-alert-color-warning | color | #FFEFD4 | Warnung-Hintergrund |
guppy-alert-color-warning-text | select | dark | Warnung-Textfarbe |
guppy-alert-color-danger | color | #FDE2E7 | Fehler-Hintergrund |
guppy-alert-color-danger-text | select | dark | Fehler-Textfarbe |
Optionen
| Konfiguration | Typ | Default | Wirkung |
|---|---|---|---|
guppy-alert-alert-outline-active | bool | false | Outline-Rahmen für Alerts |
Farbsystem
Brand
| Konfiguration | Typ | Default | Verwendung |
|---|---|---|---|
sw-color-brand-primary | color | #215AFF | Primärfarbe |
sw-color-brand-secondary | color | #0B1845 | Sekundärfarbe |
Graustufen
| Konfiguration | Default |
|---|---|
sw-color-gray-100 | #F9F9F9 |
sw-color-gray-200 | #EEEEEE |
sw-color-gray-300 | #BCC1C7 |
sw-color-gray-400 | #CED4DA |
sw-color-gray-500 | #ADB5BD |
sw-color-gray-600 | #798490 |
sw-color-gray-700 | #495057 |
sw-color-gray-800 | #4A545B |
sw-color-gray-900 | #212529 |
Fokus und Rahmen Formularfelder
Block Theme-Farben, beide standardmäßig leer:
| Konfiguration | Typ | Leer bedeutet | Wirkung |
|---|---|---|---|
guppy-focus-color | color | Primärfarbe (sw-color-brand-primary) | Tastatur-Fokusindikator (seit 2.9.0) |
guppy-input-border-color | color | Rahmenfarbe (sw-border-color) | Rahmen von Formularfeldern und Dropdown-Menüs (seit 2.9.0) |
Fokusfarbe (guppy-focus-color): färbt die Fokus-Outline des Guppy-Mixins focus-style() und der Buttons, Bootstraps Focus-Ring (:focus-visible, .form-select, .form-check-input, .nav-link, .pagination, .btn-close), den Fokus-Schatten von Formularfeldern und Buttons und den Fokus-Rahmen von Formularfeldern, auch des Suchfelds im Header. Nutze sie, wenn die Primärfarbe zu hell ist: Der Fokusindikator braucht mindestens 3:1 Kontrast zu angrenzenden Farben (WCAG 1.4.11). Die Fokus-Schatten der Validierungszustände behalten ihre Success- und Danger-Farben.
Rahmen Formularfelder (guppy-input-border-color): färbt die Rahmen von Eingabefeldern, Selects, Checkboxen und Radios und von Dropdown-Menüs (.form-control, .form-select, .form-check-input, .dropdown-menu) und darüber das Addon der Input-Group, die Buttons der Header-Suche, die Toggles des Filter-Panels und die Trenner der Dropdowns, auch des dunklen Dropdowns. Nutze das Feld, um den Kontrast von 3:1 zum Hintergrund zu erreichen, den WCAG 1.4.11 für Formularelemente verlangt, ohne die allgemeine Rahmenfarbe zu ändern.
Sind beide Felder leer, ist die Ausgabe dieselbe wie vor 2.9.0.
Typografie
Schriftgrößen
| Konfiguration | Typ | Default |
|---|---|---|
sw-font-size-base | text | 1rem |
sw-h1-font-size | text | 32px |
sw-h2-font-size | text | 24px |
sw-h3-font-size | text | 20px |
sw-h4-font-size | text | 18px |
sw-h5-font-size | text | 16px |
sw-h6-font-size | text | 15px |
Zeilenhöhen
| Konfiguration | Default |
|---|---|
sw-h1-line-height | 44px |
sw-h2-line-height | 36px |
sw-h3-line-height | 32px |
sw-h4-line-height | 28px |
sw-h5-line-height | 24px |
sw-h6-line-height | 21px |
Optische Änderung in 2.9.0: Zeilenhöhe h6
Vor 2.9.0 hatte sw-h6-line-height keine Wirkung, und h6 / .h6 behielten Bootstraps Zeilenhöhe von 1.2 (18px). Seit 2.9.0 wirkt das Feld wie die Felder für h1 bis h5: Mit dem Default 21px beträgt die Zeilenhöhe ab 1200px 21px und skaliert darunter fluid (etwa 20.4px bei 375px). Das zeigt sich im Bewertungsbereich der Produktdetailseite und im Dialog "Konto löschen" der Profilseite (nur wenn das Löschen des Kontos aktiviert ist). Um die alte Höhe zu behalten, setze das Feld auf 1.2 × Schriftgröße Überschrift 6 (18px beim Default 15px). Ein bereits im Feld gespeicherter Wert wirkt jetzt. Die reinen Text-Logos für Zahlungs- und Versandarten im Footer nutzen denselben Wert und wechseln von 21px auf 18px.
Sekundäre Textfarbe
| Konfiguration | Typ | Default | Wirkung |
|---|---|---|---|
guppy-text-secondary-color | color | leer | Farbe von gedämpftem Text (seit 2.9.0) |
Sekundäre Textfarbe setzt Bootstraps $body-secondary-color (--bs-secondary-color): .text-muted, .text-body-secondary, Hilfetexte von Formularen (.form-text), Bild- und Tabellenunterschriften, Trenner und aktuelles Element der Breadcrumb, deaktivierte Nav-Links, Action- und deaktivierte Elemente von List-Groups, den Toast-Header und den deaktivierten Range-Regler. Leer fällt auf Textfarbe (sw-text-color) zurück, die Ausgabe bleibt also gleich. Der dunkle Farbmodus behält seinen eigenen Wert. Text in Fließtextgröße braucht mindestens 4.5:1 Kontrast zum Hintergrund (WCAG 1.4.3).
Buttons & Inputs
| Konfiguration | Typ | Default | Wirkung |
|---|---|---|---|
sw-input-btn-font-size | text | 16px | Button-Schriftgröße |
sw-input-btn-border-radius | text | 4px | Button-Eckenrundung |
sw-input-btn-font-weight | select | normal | Button-Schriftgewicht |
Verwendung in Code
In Twig
{% if theme_config('guppy-header') == 'extended' %}
{# Extended-Header-Logik #}
{% endif %}In SCSS
Theme-Werte sind als CSS Custom Properties verfügbar:
.custom-component {
background-color: var(--sw-color-brand-primary);
font-size: var(--sw-font-size-base);
}Verwandt
- Theme-Variablen: SCSS-Pendant der Konfigurationsfelder.
- Twig-Blöcke: Override-Pfade in Templates.
- Twig-Overrides: Verwendung in eigenen Templates.
- Variablen & Tokens: SCSS-Architektur und Mixins.