CMS-Integration
Badges sind nicht nur für die Standard-Shopware-Produktdetail- und -Listingvorlagen — sie rendern auch automatisch in den CMS-Elementen, die Sie in eigenen Layouts verwenden. Es gibt keinen Konfigurationsschritt: legen Sie das Standard-CMS-Element in ein Shopping-Experience-Layout, und Badges erscheinen dort, wo die Konfiguration es vorsieht.
Unterstützte CMS-Elemente
Abschnitt betitelt „Unterstützte CMS-Elemente“Das Plugin erweitert die vier CMS-Elemente, die Produktinformationen anzeigen:
Bildergalerie
Abschnitt betitelt „Bildergalerie“Das CMS-Bildergalerie-Element — verwendet in Produktdetail-Layouts zur Anzeige der Produktmedien — rendert das volle Bild-Overlay-Slot-System. Sowohl linker als auch rechter Slot werden unterstützt, einschließlich Eckband-Badges, mit denselben Positionierungs- und Styling-Defaults, die Sie im Produktseiten-Tab konfiguriert haben.
Kaufbox
Abschnitt betitelt „Kaufbox“Das Kaufbox-CMS-Element — verwendet zum Rendern des In-den-Warenkorb-Bereichs in einem eigenen Produktlayout — rendert Badges, die über und unter der Kaufbox platziert sind, und spiegelt die Standard-Detailseiten-Platzierungen.
Produktbox
Abschnitt betitelt „Produktbox“Das Produktbox-CMS-Element — verwendet, um eine einzelne Produktkarte innerhalb eines CMS-Layouts zu rendern — rendert die listingartigen Platzierungen: Bild-Overlay-Slots und die Über-/Unter-Produktinfo-Platzierungen.
Produkt-Slider
Abschnitt betitelt „Produkt-Slider“Das Produkt-Slider-CMS-Element — verwendet zum Rendern eines horizontalen Scrollers mehrerer Produkte — rendert dieselben listingartigen Platzierungen auf jeder Karte im Slider. Badges, die auf den Listing-Kontext zielen, erscheinen automatisch.
Übernahme der Konfiguration
Abschnitt betitelt „Übernahme der Konfiguration“Das CMS-Rendering verwendet dieselbe Konfiguration weiter, die Sie bereits für Standard-Detail- und -Listingvorlagen eingerichtet haben:
- Die Bildergalerie verwendet die Slot-Konfiguration der Produktseite.
- Die Produktbox und der Produkt-Slider verwenden die Slot-Konfiguration des Produktlistings.
Es gibt keinen separaten „CMS”-Tab — Ihre bestehenden Slot-Einstellungen gelten sowohl für Standardvorlagen als auch für CMS-gesteuerte Seiten.
Live-Admin-Vorschau
Abschnitt betitelt „Live-Admin-Vorschau“Das Badge-Bearbeitungsformular bietet ein Vorschau-Panel, das das Storefront-Rendering in Echtzeit spiegelt. Schalten Sie die Vorschau über die Schaltfläche im Formular-Header um. Die Vorschau unterstützt das Umschalten zwischen Platzierungen:
- Detailseiten-Bild-Overlay
- Detailseite über/unter Kaufbox
- Listingseiten-Bild-Overlay
- Listingseite über/unter Produktinfo
Verwenden Sie das Dropdown über der Vorschau, um zu prüfen, wie das Badge in jeder Position aussieht, bevor Sie speichern.
Was nicht automatisch gerendert wird
Abschnitt betitelt „Was nicht automatisch gerendert wird“Wenn Sie eigenes Twig geschrieben haben, das nicht die Standard-Shopware-Produkt-Render-Blöcke oder eines der vier oben genannten CMS-Elemente verwendet, erscheinen Badges dort nicht von selbst. Entweder:
- Refaktorieren Sie das eigene Twig so, dass es das Standard-
component/product/card.html.twig(und Verwandte) erweitert, oder - Rufen Sie die Badge-Render-Twig-Funktionen des Plugins manuell aus Ihrer eigenen Vorlage auf.
Für die meisten Shops sind die Standardvorlagen und CMS-Elemente ausreichend.