-20%
Produktwidgets auf Contentseiten
Produktwidgets auf Contentseiten verwenden
Produktwidgets zeigen Produktlisten innerhalb von Contentseiten, Blog-Beiträgen oder Fullwidth-Bereichen an. Je nach Einsatz werden konkrete Produkte, Produkte aus einer Produktgruppe, Produkte eines Herstellers oder vordefinierte Listen wie Bestseller, Neuheiten und Angebote ausgegeben.
Inhaltsverzeichnis
- Wofür Produktwidgets da sind
- Einbindung im Editor
- Abonnements
- Amazon
- Amazon Pay
- apt-shop BASIC Edition
- Beispiel
- Abonnements
- Amazon
- Amazon Pay
- apt-shop BASIC Edition
- apt-shop BUSINESS Edition
- apt-shop DIGITAL Edition
- Händlerbund
- Multishoplizenz
- Produktmerkmale
- Attribute des Editor-Tags
- Auswahl- und Filterlogik
- Produktwidget als Fullwidth-Modul
- Produkttypen im Modul
- Speichern und technische Wirkung
- Sichere Pflege
- War diese Seite hilfreich?
Wofür Produktwidgets da sind
Ein Produktwidget erzeugt eine kompakte Produktgalerie an einer redaktionellen Stelle. Es verwendet die normale Produktlisten-Ausgabe und übernimmt dadurch Produktdaten, Preise, Verfügbarkeit, Bildausgabe und optional den Warenkorb-Button aus dem Shop-Kontext.
Der Widgettyp ist sinnvoll, wenn redaktionelle Inhalte direkt zu passenden Produkten führen sollen, zum Beispiel auf Landingpages, Ratgeberseiten, Aktionsseiten oder Blog-Beiträgen.
Für Contentseiten-Kacheln und Blog-Beitrags-Kacheln gibt es eigene Widgettypen. Produktwidgets sollten nur für Produktlisten verwendet werden.
Einbindung im Editor
In geeigneten Inhaltsfeldern kann ein Produktwidget über die Quelltextansicht des Editors eingefügt werden. Der technische Typ wird über type="productwidget" festgelegt.
Ohne weitere Attribute nutzt das Widget die Standardwerte. Für eine fachlich sinnvolle Ausgabe sollte meistens eine konkrete Produkt-, Hersteller- oder Produktgruppen-Auswahl ergänzt werden.
Beispiel
Dieses Beispiel zeigt maximal sechs Produkte, drei Produkte nebeneinander und alphabetische Sortierung:
-20% 
-14% 
Eine direkte Produktauswahl kann so aussehen:
Attribute des Editor-Tags
| Attribut | Werte | Wirkung |
|---|---|---|
type |
productwidget |
Pflichtangabe für diesen Widgettyp. Nur damit wird die Produktlisten-Ausgabe erzeugt. |
artikel_ids |
kommagetrennte Produkt-Ids | Zeigt genau die angegebenen Produkte. Wenn dieses Attribut gesetzt ist, werden Hersteller- und Produktgruppenfilter nicht verwendet. |
manufactor_id |
eine Hersteller-Id | Begrenzt die Produktliste auf Produkte dieses Herstellers, sofern keine direkte Produktauswahl gesetzt ist. |
category_id |
eine Produktgruppen-Id | Begrenzt die Produktliste auf Produkte dieser Produktgruppe, sofern keine direkte Produktauswahl gesetzt ist. |
include_subgroups |
true oder leer |
Erweitert den Produktgruppenfilter auf Untergruppen, wenn category_id gesetzt ist und der Wert exakt true lautet. |
items_in_row |
Zahl, Standardwert 4 |
Legt fest, wie viele Produkte nebeneinander stehen. Bei 1 nutzt das Widget die Listenansicht, sonst die Galerieansicht. |
max_items |
Zahl, Standardwert 4 |
Begrenzt die maximale Anzahl der ausgegebenen Produkte. Ist kein Wert gesetzt, kann das Widget die Trefferanzahl des Filters verwenden. |
sort_method |
zum Beispiel a-z, z-a, price-asc, price-desc, discount, sells, availability, newest, random |
Gibt die Sortierung an die Produktlisten-Ausgabe weiter. Wenn kein Wert gesetzt ist, wird alphabetisch aufsteigend sortiert. |
Auswahl- und Filterlogik
- Direkte Produktauswahl:
artikel_idshat Vorrang vor Hersteller und Produktgruppe. - Herstellerfilter:
manufactor_idwird genutzt, wenn keine direkte Produktauswahl gesetzt ist. - Produktgruppenfilter:
category_idwird genutzt, wenn keine direkte Produktauswahl gesetzt ist. - Untergruppen:
include_subgroups="true"wirkt nur zusammen mitcategory_id. - Shop-Kontext: Das Widget verwendet den aktuellen Shop-Kontext und dessen Produktfilter. Sichtbarkeit, Sprache, Preise und Kundengruppen können deshalb die Ausgabe beeinflussen.
Bei direkter Produktauswahl sollten nur Produkte verwendet werden, die im Zielshop sichtbar und kaufbar sind. Nicht sichtbare oder nicht verfügbare Produkte können die erwartete Ausgabe verändern.
Produktwidget als Fullwidth-Modul
In der Bearbeitung einer Contentseite können Fullwidth-Bereiche oberhalb oder unterhalb der Seite aktiviert werden. Dort wird ein Contentmodul gewählt. Das Modul ProductWidget bietet eine formularbasierte Konfiguration ohne manuelle Tag-Attribute.
- Fullwidth-Bereich aktivieren: schaltet den Modulslot dieser Contentseite ein. Wird der Schalter deaktiviert, setzt das Backend vorhandene Module dieses Slots auf inaktiv.
- Contentmodul: wählt den Modultyp. Ein Wechsel des Modultyps ersetzt vorhandene Module in diesem Slot.
- Warenkorb button anzeigen: blendet den Warenkorb-Button in der Produktgalerie ein oder aus.
- Überschrift anzeigen: zeigt die Standardüberschrift passend zur gewählten Produktart an.
- Link für weitere anzeigen: ergänzt bei Bestseller, neuen Produkten oder Angeboten einen Link zur jeweiligen vollständigen Produktliste. Bei der eigenen Startseiten-Auswahl wird dieser Link nicht ausgegeben.
- Gesamt-Anzahl Produkte: begrenzt die Anzahl der Produkte im Modul.
- Anzahl Produkte nebeneinander: legt die Spaltenzahl fest. Im aktuellen Formular sind 1 bis 4 Produkte nebeneinander auswählbar.
- Produktart: wählt die Quelle der Produktliste: Bestseller, Neueste Produkte, Angebote oder eigene Auswahl Startseite.
Produkttypen im Modul
- Bestseller: nutzt die Bestseller-Produktliste und sortiert nach Verkäufen absteigend.
- Neueste Produkte: nutzt die Neuheiten-Liste und sortiert nach Produktdatum beziehungsweise neuerem Eintrag.
- Angebote: nutzt Produkte mit Angebotskennzeichen und gibt diese in der Angebotsliste aus.
- Eigene Auswahl Startseite: nutzt Produkte, die für die Startseiten-Auswahl markiert sind.
Das Fullwidth-Modul ignoriert die frei übergebene Sortierung des Editor-Tags und verwendet die Logik der gewählten Produktart beziehungsweise der zugehörigen Produktliste.
Speichern und technische Wirkung
Beim Speichern einer Contentseite verarbeitet das Backend die Fullwidth-Modulslots mit. Aktive Slots werden gespeichert, inaktive Slots deaktiviert. Anschließend werden die passenden Modul-Caches geleert, damit die Frontend-Ausgabe neu aufgebaut werden kann.
Editor-Tags werden beim Rendern des Inhalts ausgewertet. Das Widget bindet zusätzlich die Warenkorb-Funktion für die Produktliste ein und erzeugt die Ausgabe über den Produktlisten-Presenter.
Sichere Pflege
- Vor dem Einfügen entscheiden, ob konkrete Produkte, Hersteller, Produktgruppen oder ein vordefinierter Produkttyp benötigt werden.
- Bei direkten Produkt-Ids prüfen, ob alle Produkte im Zielshop aktiv, sichtbar und passend sortiert sind.
- Bei Produktgruppen entscheiden, ob Untergruppen einbezogen werden sollen.
- Spaltenzahl und maximale Anzahl so wählen, dass Desktop- und Mobilansicht sinnvoll wirken.
- Nach dem Speichern die Ausgabe im Frontend prüfen, besonders Preise, Verfügbarkeit, Warenkorb-Button, Reihenfolge und mobile Darstellung.