UD Block: Erweiterter Loop

Der UD Loop Block ist ein modularer, REST-gesteuerter Inhaltsblock, der Inhalte aus verschiedenen CPTs dynamisch rendert. Er erkennt automatisch, wenn ein Bildungsangebot oder eine Seite mit Datumsblöcken gewählt wird, und aktiviert entsprechende Filteroptionen oder REST-Abfragen. Damit ist er universell einsetzbar für News-, Bildungs- und datumsbasierte Inhaltsübersichten innerhalb von Full Site Editing Themes.

Screenshots

Loop-Block in der Frontend-Ansicht

Loop-Block in der Editor-Ansicht.

1. Funktionen

Der UD Loop Block bietet verschiedene globale Einstellungen:

Sortierung

• sortMode legt fest, nach welchem Kriterium die Beiträge sortiert werden:
  • published – nach Veröffentlichungsdatum (Standard)
  • menu-order – nach manueller Reihenfolge
  • datetime-block – nach Datumselementen innerhalb eines ud/datetime-block
• Wenn postType === "datetime-page" gewählt wird, wird sortMode automatisch auf "datetime-block" gesetzt.
• Wenn keine Datumsblöcke gefunden werden, wird sortMode automatisch auf "published" zurückgesetzt.
• sortOrder bestimmt die Reihenfolge (ASC oder DESC).

Anzeigeoptionen

• postCount – Anzahl der angezeigten Beiträge, gemerkt pro Post-Type.
• selectedPageParent – nur aktiv, wenn postType === "page"; zeigt Unterseiten einer gewählten Elternseite.
• selectedPageId – aktiv, wenn postType === "datetime-page"; Auswahl einer Seite mit Datumsblöcken.
• filterFutureDates – boolescher Filter, gemerkt pro Post-Type; wird nur für page und ud_news verwendet.

Responsive Breakpoints

• Steuern die Anzahl angezeigter Beiträge bei unterschiedlichen Bildschirmbreiten.
• Jeder Breakpoint enthält:
  • maxWidth – obere Grenze des Viewports in Pixeln
  • items – Anzahl der anzuzeigenden Elemente
• Breakpoints können im Editor hinzugefügt, geändert oder entfernt werden.
• Änderungen werden automatisch mit dem Attribut breakpoints synchronisiert.

2. Post-Types

Der Block verarbeitet folgende Post-Types:

• post – Standardbeiträge
• page – Standardseiten
• ud_news – Nachrichten / Aktuelles
• ud_bildungsangebote – zentraler CPT für Bildungsinhalte

Besonderheiten

• Wenn postType === 'ud_bildungsangebote', werden zusätzliche Editor-Optionen geladen:

  • Taxonomie bildungsbereich (REST-Endpunkt: /wp/v2/bildungsbereich)
  • Dynamische SelectControl zur Filterung nach Bildungsbereichen

• Wenn postType === 'datetime-page' (Einzelseite mit Datum-Blocks) gewählt wird, durchsucht der Block reguläre Seiten nach dem Vorkommen des Blocks ud/datetime-block. Nur Seiten, die diesen Block enthalten, werden über den REST-Endpunkt /wp-json/ud-loop-block/v1/datetime-pages bereitgestellt und können im Editor ausgewählt werden. Dadurch lassen sich gezielt Seiten mit zeitlich strukturierten Inhalten (Datumsabschnitten) im Loop darstellen.

• Wenn postType andere CPTs betrifft (z. B. ud_news), entfallen diese Zusatzoptionen.

3. Konditionale Logik im Editor (edit.js)

• postType-abhängige UI:

  • postType === 'ud_bildungsangebote' → zeigt zusätzlich ein dynamisches Select-Feld für bildungsbereich
  • postType === 'datetime-page' → aktiviert spezielle REST-Abfrage und Auswahl von Seiten mit ud/datetime-block
  • Andere Post-Types → zeigen statische Filterfelder (z. B. Anzahl, Sortierung, Reihenfolge)

• REST-basierte dynamische Optionen:

  • Begriffe der Taxonomie bildungsbereich werden über wp.data / apiFetch geladen.
  • Diese werden im Editor als Optionen dargestellt, sobald postType gewechselt wird.

• Attributabhängigkeiten:

  • Wenn contentType gesetzt ist, kann postType überschrieben werden (z. B. Gruppierung mehrerer Bildungsangebote unter einem logischen Typ).
  • Änderung von postType → Resets relevanter Taxonomieattribute (terms, bildungsbereich).

Übersicht der Editor-Logik

Einblicke in die Umsetzung

Der Beitrag gibt Einblick in die entwickelte Lösung und ihre Funktionsweise. Das Projekt zeigt den konkreten Einsatz.

• Mehr zur Lösung: Inhaltsübersichten in WordPress flexibel abfragen und redaktionell gestalten
• Einblick ins Projekt: Bildung durchdacht vernetzt

Autor

ulrich.digital gmbh

Lizenz

Dieses Projekt steht unter der ulrich.digital Nutzungslizenz 1.0.

Die unveränderte Software darf in eigenen und kommerziellen Projekten eingesetzt werden. Auf jeder öffentlich erreichbaren Website oder Anwendung muss ulrich.digital gmbh im Impressum, in einem Credits-Bereich oder auf einer vergleichbaren Informationsseite genannt werden. Verkauf, eigenständige Weitergabe, Unterlizenzierung und Änderungen bedürfen der vorherigen schriftlichen Zustimmung von ulrich.digital gmbh.

Komponenten Dritter behalten ihre jeweiligen Lizenz- und Nutzungsbedingungen.