Skip to content

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 ​

KonfigurationTypDefaultBeschreibung
guppy-container-width-defaulttext1400pxStandard-Container
guppy-container-width-fluidtext100%Fluid-Container
guppy-container-width-smtext1230pxkleine Container

Container-Padding ​

BreakpointKonfigurationDefault
XXLguppy-container-default-padding-x-xxl48px
XLguppy-container-default-padding-x-xl48px
LGguppy-container-default-padding-x-lg48px
MDguppy-container-default-padding-x-md48px
SMguppy-container-default-padding-x-sm24px
Mobileguppy-container-default-padding-x-mobile10px

Allgemeine Einstellungen ​

Tab Layout, Block Allgemeine Einstellungen:

KonfigurationTypDefaultWirkung
guppy-border-radiustext4pxBasis-Eckenradius des Themes (seit 2.9.0)
guppy-slider-arrows-roundswitchausrunde Slider-Pfeile (seit 2.9.0)
guppy-ui-icons-phosphorswitchausPhosphor-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:

KonfigurationTypDefaultBeschreibung
guppy-cms-section-padding-xtext48pxhorizontales Padding
guppy-cms-section-padding-ytext48pxvertikales Standard-Padding
guppy-cms-section-padding-y-2xtext96pxextra vertikales Padding (2x)

Section-Optionen im Editor:

OptionWirkung
Horizontales Paddingaktivieren/deaktivieren
Padding Oben & UntenStandard-Y-Padding
Extra Groß (2x)doppeltes Y-Padding
Padding Obennur oben (mit Option Kein Abstand)
Padding Untennur unten (mit Option Kein Abstand)

Anpassung im Child-Theme:

scss
$guppy-cms-section-padding-x:    32px;
$guppy-cms-section-padding-y:    64px;
$guppy-cms-section-padding-y-2x: 128px;

Header-Variante ​

KonfigurationTypOptionenDefault
guppy-headerselectdefault, compact, extended, simpleextended
VarianteBeschreibung
defaultShopware-Standard-Header
compactGuppy Standard, kompakt
extendedmit Top-Bar
simpleminimalistisch

Header-Optionen ​

KonfigurationTypDefaultWirkung
guppy-header-max-heighttext22pxmaximale Logo-Höhe
guppy-topbar-background-colorcolor#EEEEEEHintergrundfarbe der Top-Bar
guppy-header-skip-to-main-contentboolfalseSkip-Link zum Hauptinhalt
guppy-header-skip-to-main-navboolfalseSkip-Link zur Navigation
guppy-header-skip-to-searchboolfalseSkip-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.

KonfigurationTypOptionenDefault
guppy-footerselectdefault, guppy-defaultguppy-default
KonfigurationTypDefaultWirkung
guppy-footer-border-top-colortextdefault-borderobere Rahmenfarbe
guppy-footer-show-payment-methodsboolfalseZahlungsarten anzeigen
guppy-footer-show-shipping-methodsboolfalseVersandarten anzeigen

Zusatzfelder für Versand-/Zahlungsarten ​

DmfGuppyTheme legt das Custom-Field-Set guppy_footer_options an:

FeldTypWirkung
guppy_hide_in_footerboolwenn aktiv: Methode nicht im Footer anzeigen
guppy_alternative_labeltextüberschreibt den Tooltip-Namen beim Hover

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.

FeldPlattform
guppy_social_media_instagram_threadsInstagram-Threads
guppy_social_media_instagramInstagram
guppy_social_media_linkedinLinkedIn
guppy_social_media_youtubeYouTube
guppy_social_media_xX (Twitter)
guppy_social_media_facebookFacebook
guppy_social_media_tiktokTikTok
guppy_social_media_xingXing

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) ​

KonfigurationTyp
guppy-footer-custom-section-image-1media
guppy-footer-custom-section-image-1-linktext
guppy-footer-custom-section-image-2media
guppy-footer-custom-section-image-2-linktext
(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 ​

KonfigurationTypOptionenDefault
guppy-productcard-configselectdefault, guppy-defaultguppy-default
guppy-productcard-protective-framebool–true
guppy-productcard-image-object-fitselectcontain, covercontain

Productdetail ​

Buybox ​

KonfigurationTypDefaultWirkung
guppy-detail-buybox-stylingselectdefaultdefault, border, background
guppy-detail-headline-buyboxbooltrueProduktname in Buybox
guppy-detail-buybox-contactboolfalseKontaktinfo anzeigen
guppy-detail-buybox-contact-hotlineboolfalseHotline anzeigen
guppy-detail-buybox-hide-quantity-buttonsboolfalseMengen-Buttons ausblenden
guppy-detail-mobile-title-above-galleryboolfalseProdukttitel über der Galerie auf Mobile

Galerie und Tabs ​

KonfigurationTypDefaultWirkung
guppy-detail-gallery-scrollboolfalseGalerie scrollt mit Inhalt
guppy-detail-display-properties-as-tabboolfalseEigenschaften als separater Tab

Login & Registrierung ​

KonfigurationTypOptionenDefault
guppy-login-registerselectdefault, compactcompact

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 ​

KonfigurationTypDefault
guppy-badges-show-outlineboolfalse

Neu-Badge ​

KonfigurationTypDefault
guppy-badges-new-background-colorcolor#22C087
guppy-badges-new-colorcolor#FFFFFF
guppy-badges-new-outline-colorcolor#FFFFFF

Top-Seller-Badge ​

KonfigurationTypDefault
guppy-badges-top-seller-background-colorcolor#F89C00
guppy-badges-top-seller-colorcolor#FFFFFF
guppy-badges-top-seller-outline-colorcolor#FFFFFF

Discount-Badge ​

KonfigurationTypDefault
guppy-badges-discount-background-colorcolor#E10036
guppy-badges-discount-colorcolor#FFFFFF
guppy-badges-discount-outline-colorcolor#FFFFFF

Ausverkauft-Badge ​

KonfigurationTypDefault
guppy-badges-show-out-of-stockboolfalse
guppy-badges-out-of-stock-background-colorcolor#EEEEEE
guppy-badges-out-of-stock-colorcolor#303030
guppy-badges-out-of-stock-outline-colorcolor#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 ​

KonfigurationTypDefaultWirkung
guppy-alert-color-successcolor#D3F2E7Erfolg-Hintergrund
guppy-alert-color-success-textselectdarkErfolg-Textfarbe
guppy-alert-color-infocolor#CEEDFEInfo-Hintergrund
guppy-alert-color-info-textselectdarkInfo-Textfarbe
guppy-alert-color-warningcolor#FFEFD4Warnung-Hintergrund
guppy-alert-color-warning-textselectdarkWarnung-Textfarbe
guppy-alert-color-dangercolor#FDE2E7Fehler-Hintergrund
guppy-alert-color-danger-textselectdarkFehler-Textfarbe

Optionen ​

KonfigurationTypDefaultWirkung
guppy-alert-alert-outline-activeboolfalseOutline-Rahmen für Alerts

Farbsystem ​

Brand ​

KonfigurationTypDefaultVerwendung
sw-color-brand-primarycolor#215AFFPrimärfarbe
sw-color-brand-secondarycolor#0B1845Sekundärfarbe

Graustufen ​

KonfigurationDefault
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:

KonfigurationTypLeer bedeutetWirkung
guppy-focus-colorcolorPrimärfarbe (sw-color-brand-primary)Tastatur-Fokusindikator (seit 2.9.0)
guppy-input-border-colorcolorRahmenfarbe (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 ​

KonfigurationTypDefault
sw-font-size-basetext1rem
sw-h1-font-sizetext32px
sw-h2-font-sizetext24px
sw-h3-font-sizetext20px
sw-h4-font-sizetext18px
sw-h5-font-sizetext16px
sw-h6-font-sizetext15px

Zeilenhöhen ​

KonfigurationDefault
sw-h1-line-height44px
sw-h2-line-height36px
sw-h3-line-height32px
sw-h4-line-height28px
sw-h5-line-height24px
sw-h6-line-height21px

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 ​

KonfigurationTypDefaultWirkung
guppy-text-secondary-colorcolorleerFarbe 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 ​

KonfigurationTypDefaultWirkung
sw-input-btn-font-sizetext16pxButton-Schriftgröße
sw-input-btn-border-radiustext4pxButton-Eckenrundung
sw-input-btn-font-weightselectnormalButton-Schriftgewicht

Verwendung in Code ​

In Twig ​

twig
{% if theme_config('guppy-header') == 'extended' %}
    {# Extended-Header-Logik #}
{% endif %}

In SCSS ​

Theme-Werte sind als CSS Custom Properties verfügbar:

scss
.custom-component {
    background-color: var(--sw-color-brand-primary);
    font-size: var(--sw-font-size-base);
}

Verwandt ​