DmfUspBanner

DmfUspBanner zeigt deine Kundenvorteile über dem Storefront-Header: kostenloser Versand ab einem bestimmten Betrag, Rückgabefrist, Lieferzeit. Das Banner teilt sich die Zeile mit der Sprach- und Währungsauswahl und färbt die komplette Leiste.

Gepflegt wird es pro Verkaufskanal, und jeder Text ist übersetzbar. Vor Guppy 2.8.0 steckte diese Funktion in der Theme-Konfiguration, wo sich alle Verkaufskanäle mit demselben Theme einen Satz Texte geteilt haben und es gar keine Sprachdimension gab.

Schnellinfo

Composer-Paket	dmf/sw6-plugin-usp-banner
Plugin-Klasse	Dmf\UspBanner\DmfUspBanner
Namespace	Dmf\UspBanner
Shopware	>= 6.7.0
Benötigt	DmfSplideSlider
Speicherung	Eigene Entity dmf_usp_banner, ein Banner pro Verkaufskanal
Pflege	Inhalte → USP-Banner
Repository	dmf / plugin-usp-banner

Installation

composer require dmf/sw6-plugin-usp-banner
bin/console plugin:refresh
bin/console plugin:install --activate DmfUspBanner
bin/console cache:clear
bin/console administration:build
bin/console theme:compile

Features

• Zwei Darstellungen: Standard (ein Text mit optionalem Link) und Vorteile (bis zu drei Texte nebeneinander, die zum Slider werden, sobald der Platz nicht reicht).
• Ein Banner pro Verkaufskanal, abgesichert über einen Unique-Index. Belegte Kanäle bietet die Auswahl gar nicht erst an.
• Jeder Text ist übersetzbar, auch der Link. Ein zweisprachiger Shop verlinkt also pro Sprache auf die passende Landingpage.
• Link-Auswahl über denselben Picker wie die Erlebniswelten: Kategorie, Produkt, Medien-Datei, E-Mail-Adresse, Telefonnummer oder externe URL.
• Kontrastprüfung nach WCAG 2.1 AA direkt unter den Farbwählern, inklusive Warnung unterhalb von 4,5:1 (BFSG).
• Eigene Rechte unter dmf_usp_banner (Viewer, Editor, Creator, Deleter).
• Storefront-Snippets in de-DE, en-GB, es-ES, fr-FR, it-IT, nl-NL und pl-PL.

Konfiguration

Anders als die meisten Plugins bringt DmfUspBanner keine Plugin-Konfiguration mit. Die Banner werden im Admin unter Inhalte → USP-Banner angelegt, weil sie pro Verkaufskanal und pro Sprache gepflegt werden.

Feld	Typ	Default	Wirkung
Verkaufskanal	Auswahl	–	Der Kanal, zu dem das Banner gehört. Pro Kanal ist genau eines möglich.
Aktiv	bool	false	Aus blendet das Banner aus, unabhängig vom Inhalt.
Darstellung	Auswahl	Standard	Entscheidet, welche der folgenden Felder gelesen werden.
Text	Text, übersetzbar	–	Nur Standard. Ohne Text in der aktuellen Sprache rendert das Banner dort nicht.
Link	Link-Picker, übersetzbar	–	Nur Standard. Ohne Link wird der Text ohne Verlinkung ausgegeben.
Link in neuem Tab öffnen	bool	false	Setzt target="_blank" mit rel="noopener".
Linkposition	Auswahl	Zentriert	Links oder Zentriert, bezogen auf die Seite. Ab zwei Vorteilen ohne Wirkung.
Vorteil 1 bis 3	Text, übersetzbar	–	Nur Vorteile. Leere Felder werden geschlossen, nicht als Lücke gerendert.
Hintergrundfarbe	Farbe	#EEEEEE	Färbt die komplette Leiste inklusive der Umschalter.
Textfarbe	Farbe	#2B3136	Gilt für den Banner-Text und die Umschalter daneben.
Hover-Farbe	Farbe	–	Optional. Ohne Angabe behält beim Hover alles die Textfarbe.

Verwendung

1. Im Admin Inhalte → USP-Banner öffnen und USP-Banner anlegen wählen.
2. Verkaufskanal auswählen und das Banner aktivieren.
3. Darstellung wählen: Standard für eine Aussage mit Link, Vorteile für bis zu drei Kundenvorteile.
4. Texte eintragen. Über die Sprachauswahl in der Smart Bar pflegst du jede Sprache einzeln.
5. Farben setzen und den Kontrastwert unter den Farbwählern prüfen.
6. Speichern.

Einschränkungen

Texte aus der Theme-Konfiguration werden nicht übernommen

Wer vor Guppy 2.8.0 ein USP-Banner über die Theme-Einstellungen gepflegt hat, trägt die Texte hier einmalig neu ein. Das Theme kann nicht in ein Plugin schreiben, das eventuell gar nicht installiert ist.

Drei feste Vorteils-Felder

Die Darstellung Vorteile hat genau drei Felder. Mehr Vorteile brauchen eine Migration im Plugin.

Themes, die den Top-Bar-Block überschreiben

Das Banner rendert aus dem Core-Block layout_header_top_bar. Ein Theme, das diesen Block ohne parent() überschreibt, blendet das Banner aus.

Hinweise

• Pro Verkaufskanal ist genau ein Banner möglich. Ein zweites lässt sich nicht im Hintergrund vorbereiten, eine Änderung überschreibt also immer das, was gerade live ist.
• Interne Linkziele werden als Platzhalter gespeichert und erst beim Rendern aufgelöst. Dasselbe Banner verlinkt dadurch in jedem Verkaufskanal und jeder Sprache korrekt.
• Unterhalb von 1200 Pixeln Viewport-Breite werden die Vorteile zum Slider.
• Die Hintergrundfarbe des Banners überschreibt die Top-Bar-Hintergrundfarbe aus dem Theme, solange das Banner ausgespielt wird.

Verwandt

• DmfSplideSlider: liefert den Slider für die Vorteile.
• Alle Plugins
• Empfohlene Plugins