Contentwidgets auf Contentseiten

Contentwidgets auf Contentseiten verwenden

Contentwidgets zeigen ausgewählte Contentseiten als Kacheln oder Grid an. Der Einsatz ist direkt im Editor per

Ohne weitere Attribute ist das Widget technisch gültig, zeigt aber nur dann Inhalte, wenn die benötigte Auswahl der Contentseiten über Attribute ergänzt wird.

Beispiel

Dieses Beispiel zeigt maximal sechs Contentseiten in drei Spalten und nutzt die Unterseiten einer übergeordneten Contentseite:

Wenn konkrete Seiten statt einer ganzen Unterseiten-Gruppe angezeigt werden sollen, wird page_ids verwendet. Diese direkte Auswahl hat Vorrang vor category_id.

Attribute des Editor-Tags

Attribut Werte Wirkung
type contentwidget Pflichtangabe für diesen Widgettyp. Nur damit wird die Contentseiten-Galerie erzeugt.
page_ids kommagetrennte Contentseiten-Ids Zeigt genau die angegebenen Contentseiten in der angegebenen Reihenfolge. Wenn dieses Attribut gesetzt ist, wird category_id nicht verwendet.
category_id eine Contentseiten-Id Nutzt die Unterseiten der angegebenen Contentseite als Quelle. Es werden die Child-Seiten dieser übergeordneten Seite geladen.
items_in_row Zahl, Standardwert 4 Legt fest, wie viele Kacheln nebeneinander stehen. Daraus wird die Grid-Breite der Kacheln berechnet.
max_items Zahl, Standardwert 4 Begrenzt die maximale Anzahl der ausgegebenen Contentseiten. Daraus ergibt sich zusammen mit items_in_row die Anzahl der Reihen.
sort_method a-z oder random Ist random gesetzt, wird die ermittelte Seitenliste zufällig gemischt. Andere Werte verändern im Contentwidget-Code keine Sortierung.

Auswahl- und Ausgabelogik

  • Direkte Seitenauswahl: Wenn page_ids gesetzt ist, lädt das Widget jede genannte Contentseite einzeln.
  • Unterseiten-Auswahl: Wenn page_ids leer ist und category_id gesetzt ist, lädt das Widget die Child-Seiten dieser Contentseite.
  • Leere Auswahl: Wenn weder konkrete Seiten noch eine übergeordnete Seite gefunden werden, wird keine Galerie ausgegeben.
  • Sprache und Shop-Kontext: Die geladenen Contentseiten richten sich nach dem aktuellen Sprach- und Shop-Kontext der Frontend-Ausgabe.
  • Kacheldaten: Für jede Kachel verwendet die Galerie Linktext oder Bezeichnung, Linkziel, Vorschaubild und Vorschautext der jeweiligen Contentseite.

Contentwidget als Fullwidth-Modul

In der Bearbeitung einer Contentseite können Fullwidth-Bereiche oberhalb oder unterhalb der Seite aktiviert werden. Dort wird zuerst der Bereich eingeschaltet und anschließend ein Contentmodul ausgewählt. Wird ContentWidget gewählt, erscheinen die modulspezifischen Felder.

  • Fullwidth-Bereich aktivieren: schaltet den jeweiligen Modulslot für diese Contentseite ein. Wird der Schalter deaktiviert, setzt das Backend vorhandene Module in diesem Slot auf inaktiv.
  • Contentmodul: wählt den Modultyp. Beim Wechsel auf einen anderen Modultyp ersetzt das Backend vorhandene Module dieses Slots.
  • Überschrift anzeigen: blendet die Standardüberschrift des Contentwidgets ein oder aus.
  • Gesamt-Anzahl Contentseiten: entspricht der maximalen Anzahl der angezeigten Contentseiten im Modul.
  • Anzahl Contentseiten nebeneinander: legt die Spaltenzahl im Modul fest. Im aktuellen Formular sind die Werte 1 bis 4 auswählbar.
  • Ids der Contentseiten (kommagetrennt): legt die direkt angezeigten Contentseiten fest. Das Modul nutzt diese konkrete Auswahl und keine übergeordnete Seite.
Das Fullwidth-Modul speichert die Konfiguration im Modulslot der jeweiligen Contentseite. Es ist damit an diese Seite, den gewählten Shop und die gewählte Sprache gebunden.

Speichern und technische Wirkung

Beim Speichern einer Contentseite verarbeitet das Backend auch die Fullwidth-Modulslots. Aktive Slots werden gespeichert, inaktive Slots werden deaktiviert. Danach werden passende Contentmodul-Caches geleert, damit die Frontend-Ausgabe neu aufgebaut werden kann.

Editor-Tags werden beim Rendern der Seite ausgewertet. Im Backend selbst wird anstelle der Galerie kein vollständiger Frontend-Code eingesetzt; maßgeblich ist daher die Prüfung in der tatsächlichen Frontend-Ausgabe.

Sichere Pflege

  1. Vor dem Einfügen entscheiden, ob konkrete Contentseiten oder die Unterseiten einer übergeordneten Seite angezeigt werden sollen.
  2. Bei konkreter Auswahl die Contentseiten-Ids sorgfältig prüfen und kommagetrennt ohne zusätzliche Wörter eintragen.
  3. Spaltenzahl und maximale Anzahl zusammen planen, damit keine ungewollt leere oder abgeschnittene Galerie entsteht.
  4. Bei zufälliger Sortierung beachten, dass die Reihenfolge bei späteren Aufrufen wechseln kann.
  5. Nach dem Speichern die Seite im Frontend prüfen, besonders Vorschaubilder, Linktexte, Vorschautexte und mobile Darstellung.

War diese Seite hilfreich?

Hilf uns, das Handbuch weiter zu verbessern. Wenn etwas fehlt oder unverständlich ist, kannst Du direkt einen kurzen Kommentar senden.