Blogwidgets auf Contentseiten
Blogwidgets auf Contentseiten verwenden
Blogwidgets binden Blog-Beiträge als Kacheln oder Teaser in Contentseiten, Blog-Beiträge oder Fullwidth-Bereiche ein. Je nach Einsatz werden konkrete Blog-Beitrags-Ids, aktuelle interne Blog-Beiträge oder Beiträge aus einem Feed angezeigt.
Wofür Blogwidgets da sind
Ein Blogwidget erzeugt eine kompakte Übersicht aus Blog-Beiträgen. Die Ausgabe nutzt Titel, Link, Datum, Vorschaubild und Vorschautext beziehungsweise einen gekürzten Beitragstext, wenn kein Vorschautext gepflegt ist.
Der Widgettyp eignet sich für redaktionelle Einstiege, Themenwelten, Ratgeberseiten oder Landingpages, auf denen passende Blog-Inhalte angeteasert werden sollen.
Einbindung im Editor
In geeigneten Inhaltsfeldern kann ein Blogwidget über die Quelltextansicht des Editors eingefügt werden. Der technische Typ wird über type="blogwidget" festgelegt.
Für den Editor-Tag muss eine konkrete Beitragsauswahl über page_ids gesetzt werden. Ohne Beitrags-Ids wird keine Blogliste aufgebaut.
Beispiel
Dieses Beispiel zeigt maximal sechs Blog-Beiträge, drei Beiträge nebeneinander und nutzt die Beiträge mit den angegebenen Ids:
Die Reihenfolge folgt grundsätzlich der angegebenen Beitragsliste. Nur bei sort_method="random" mischt das Widget die ermittelte Liste zufällig.
Attribute des Editor-Tags
| Attribut | Werte | Wirkung |
|---|---|---|
type |
blogwidget |
Pflichtangabe für diesen Widgettyp. Nur damit wird die Blog-Beitrags-Galerie erzeugt. |
page_ids |
kommagetrennte Blog-Beitrags-Ids | Legt fest, welche Blog-Beiträge angezeigt werden. Dieses Attribut ist für den Editor-Tag die zentrale Quelle. |
items_in_row |
Zahl, Standardwert 4 |
Legt fest, wie viele Beitragskacheln nebeneinander stehen. Daraus wird die Grid-Breite der Kacheln berechnet. |
max_items |
Zahl, Standardwert 4 |
Begrenzt die maximale Anzahl der ausgegebenen Beiträge. Zusammen mit items_in_row ergibt sich die Anzahl der Reihen. |
sort_method |
random oder leer |
Ist random gesetzt, wird die Beitragsliste zufällig gemischt. Andere Werte verändern im Blogwidget-Code keine Sortierung. |
Auswahl- und Ausgabelogik
- Direkte Beitragsauswahl: Das Widget lädt die in
page_idsgenannten Blog-Beiträge einzeln. - Leere Auswahl: Ohne gültige Beitrags-Ids wird keine Galerie ausgegeben.
- Sprache und Shop-Kontext: Die geladenen Beiträge richten sich nach dem aktuellen Sprach- und Shop-Kontext der Frontend-Ausgabe.
- Kacheldaten: Die Galerie verwendet Linktext oder Bezeichnung, Linkziel, Vorschaubild und Vorschautext der jeweiligen Beiträge.
- Zufällige Reihenfolge:
sort_method="random"mischt die bereits geladene Beitragsliste.
Interne Blog-Beiträge als Fullwidth-Modul
In der Bearbeitung einer Contentseite können Fullwidth-Bereiche oberhalb oder unterhalb der Seite aktiviert werden. Wird dort das Modul Blog gewählt, zeigt das Backend aktuelle interne Blog-Beiträge.
- 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.
- Anzahl der Beiträge: legt fest, wie viele interne Blog-Beiträge angezeigt werden. Im aktuellen Formular sind 1 bis 4 Beiträge auswählbar.
Das interne Blog-Modul lädt aktive Blog-Beiträge im aktuellen Shop- und Sprachkontext und sortiert sie nach Erstellungsdatum absteigend. Pro Beitrag werden Titel, Link, Datum, Vorschautext und bei vorhandenem Bild auch das Vorschaubild ausgegeben.
Feed-Beiträge als Fullwidth-Modul
Das Modul BlogFeed zeigt Beiträge aus einem RSS-Feed als Teaserliste. Es ist für externe oder zentrale Blog-Feeds gedacht, wenn die Beiträge nicht als interne Blog-Beiträge gepflegt werden.
- Feed-Url (RSS): Adresse des RSS-Feeds. Wenn der Feed nicht geladen werden kann oder keine Einträge enthält, wird keine Liste ausgegeben.
- Anzahl der Beiträge: legt fest, wie viele Feed-Beiträge im Modul angezeigt werden. Im aktuellen Formular sind 1 bis 4 Beiträge auswählbar.
Aus dem Feed werden Titel, Beschreibung, Link, Datum und ein Bild aus dem Feed-Eintrag verwendet, sofern vorhanden.
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 wird.
Editor-Tags werden beim Rendern des Inhalts ausgewertet. Die Ausgabe entsteht aus den gespeicherten Blog-Beiträgen beziehungsweise aus dem konfigurierten Feed.
Sichere Pflege
- Vor dem Einfügen entscheiden, ob konkrete Blog-Beiträge, aktuelle interne Beiträge oder ein Feed benötigt werden.
- Bei
page_idsdie Beitrags-Ids und die gewünschte Reihenfolge prüfen. - Bei internen Beiträgen Vorschautext, Vorschaubild, Veröffentlichung und Shopzuordnung prüfen.
- Bei Feed-Beiträgen sicherstellen, dass der Feed stabil erreichbar ist und passende Inhalte liefert.
- Nach dem Speichern die Frontend-Ausgabe prüfen, besonders Titel, Links, Bilder, Datum, Textlänge und mobile Darstellung.