Wiederholfelder — Dynamische zeilenbasierte Felder | Field Forge - Benutzerdefinierte Felder, gebaut für Geschwindigkeit
Herunterladen Anmelden

Wiederholfelder — Dynamische zeilenbasierte Felder

Was ein Wiederholfeld tut

Ein Wiederholfeld ist eine Zeilenschablone. Sie definieren, welche Unterfelder jede Zeile enthält (zum Beispiel: Name, Foto, Biografie), und Redakteure können Zeilen nach Belieben hinzufügen, entfernen und neu anordnen. Ein einzelnes Wiederholfeld kann von null bis zu Hunderten von Zeilen pro Beitrag halten.

Beispielanwendung: Teammitglieder

Eine Feldgruppe für eine “Teamseite” enthält ein Teammitglieder Wiederholfeld mit drei Unterfeldern:

  • Name (Text)
  • Foto (Bild)
  • Biografie (Textarea)

Auf dem Beitrag-Bearbeitungsbildschirm klickt ein Redakteur auf “Zeile hinzufügen”, füllt die drei Unterfelder aus und klickt erneut auf “Zeile hinzufügen” für das nächste Teammitglied. Sie können Zeilen ziehen, um die Reihenfolge zu ändern, einzelne Zeilen löschen und so viele Zeilen hinzufügen, wie benötigt werden.


Unterfeldtypen, die unterstützt werden

Wiederholunterfelder können einer der 32 Feldtypen von Field Forge sein:

  • Basis (Text, Textarea, Zahl, E-Mail, URL usw.)
  • Inhalt (Bild, Datei, WYSIWYG, oEmbed, Galerie)
  • Auswahl (Auswahl, Kontrollkästchen, Radio, wahr/falsch, Schaltflächengruppe)
  • Relational (Beziehung, Beitragsobjekt, Seitenlink, Taxonomie, Benutzer)
  • jQuery (Datumsauswahl, Zeitauswahl, Farbauswahl)
  • Layout (Tab, Akkordeon, Nachricht)

Der einzige Unterfeldtyp, der innerhalb eines Wiederholfeldes nicht funktioniert, ist Klonen (was eine unendliche Rekursion erzeugen würde).


Verschachtelte Wiederholfelder

Wiederholfelder können andere Wiederholfelder enthalten. Beispiel: ein “Dienstleistungen”-Wiederholfeld, bei dem jede Dienstleistung ein verschachteltes “Merkmale”-Wiederholfeld hat.

Dienstleistungen Wiederholfeld ├── Zeile 1: Dienstleistung A │ ├── Dienstleistungsname: "Beratung" │ ├── Beschreibung: "..." │ └── Merkmale Wiederholfeld │ ├── Zeile 1: "Entdeckungsworkshop" │ ├── Zeile 2: "Strategiedokument" │ └── Zeile 3: "Implementierungsunterstützung" └── Zeile 2: Dienstleistung B ├── Dienstleistungsname: "Entwicklung" ├── Beschreibung: "..." └── Merkmale Wiederholfeld ├── Zeile 1: "Benutzerdefinierter Code" └── Zeile 2: "QA-Tests"

Verschachtelungen funktionieren bis in jede Tiefe, obwohl Sie für tief verschachtelte Daten in Erwägung ziehen sollten, mit benutzerdefinierten Beitragstypen und Beziehungen umzuorganisieren.


Vorlagencode (ACF-kompatibel)

Das Wiederholfeld von Field Forge verwendet die exakt gleichen Vorlagenfunktionen wie ACF und SCF. Code, der für ACF geschrieben wurde, funktioniert unverändert:

php

<img decoding="async" src="" alt="">

Dieser Code funktioniert bei:

  • ACF (original)
  • Sichere benutzerdefinierte Felder (SCF, das WordPress.org Fork)
  • Field Forge (mit der ACF-Kompatibilitätsschicht)

Wenn Sie von ACF oder SCF zu Field Forge migrieren, bleibt dieser Vorlagencode unverändert.


Verschachtelte Schleifen

Für verschachtelte Wiederholfelder durchlaufen Sie eine Schleife innerhalb einer anderen Schleife:

“`php

“`

Das have_rows() / the_row() / get_sub_field() Trio verarbeitet beliebige Verschachtelungen.


Wiederholfeldeinstellungen

Bei der Konfiguration eines Wiederholfeldes im visuellen Builder von Field Forge:

  • Bezeichnung — was Redakteure im Beitrag-Editor sehen
  • Name — der Variablenname (get_field('name'))
  • Minimale Zeilen — minimale Anzahl von Zeilen (0 für optional, 1+ für erforderlich)
  • Maximale Zeilen — Obergrenze (oder leer lassen für unbegrenzt)
  • Schaltflächenbezeichnung — benutzerdefinierter Text für die Schaltfläche “Zeile hinzufügen” (Standard: “Zeile hinzufügen”)
  • Layout — Tabellen-, Block- oder Zeilenanzeige im Beitrag-Editor
  • Zusammengeklapptes Feld — welches Unterfeld als zusammengeklappte Bezeichnung der Zeile angezeigt werden soll (für kompakte Anzeige vieler Zeilen)

Leistung bei großen Wiederholfeldern

Hier zeigt sich, wo Field Forge’s benutzerdefinierte Tabellenspeicherung wirklich von Vorteil ist. ACF und SCF speichern Wiederholfeld-Daten in wp_postmeta mit einer Zeile pro Unterfeld pro Wiederholzeile. Ein Wiederholfeld mit 5 Unterfeldern und 50 Zeilen erzeugt 250 Metaeinträge pro Beitrag. Das Laden einer Seite mit 20 solchen Beiträgen erzeugt über 5.000 Metaabfragen.

Die benutzerdefinierte Tabelle von Field Forge verwendet parent_id und row_index Spalten, um Wiederholfeld-Daten in einer nativen relationalen Struktur zu speichern. Eine einzige Abfrage ruft alle Wiederholfeld-Daten für einen Beitrag ab. Archivseiten laden 10–50x schneller bei wiederholungsintensiven Vorlagen.


Migration vorhandener Wiederholfeld-Daten

Wenn Sie von ACF oder SCF importieren, rekonstruiert das Migrationstool von Field Forge die verschachtelten Wiederholfeldstrukturen korrekt. Eltern-Kind-Beziehungen zwischen Zeilen werden beibehalten. Verschachtelte Wiederholfelder werden mit vollständiger Hierarchie migriert. Nach der Migration funktionieren Ihre Vorlagen weiterhin (über die ACF-Kompatibilitätsschicht) und Abfragen laufen schneller (über die benutzerdefinierte Tabellenspeicherung).

Siehe den vollständigen Migrationsleitfaden →


REST API-Ausgabe

Wiederholfeld-Daten werden über die WordPress REST API und die benutzerdefinierten Endpunkte von Field Forge bereitgestellt:

json { "team_members": [ { "name": "Alice Johnson", "photo": { "id": 123, "url": "https://example.com/alice.jpg", "alt": "Alice Johnson" }, "bio": "Alice ist unsere Leiterin der Technik..." }, { "name": "Bob Smith", "photo": { "id": 124, "url": "...", "alt": "Bob Smith" }, "bio": "Bob leitet das Designteam..." } ] }

Perfekt für headless WordPress-Frontends. In Kombination mit der TypeScript-Generierung von Field Forge werden Wiederholfeld-Daten vollständig typisiert Array im Frontend.


Bereit, Wiederholfelder zu verwenden?

Holen Sie sich Field Forge — ab $35/Jahr →

Wiederholfelder sind in jedem kostenpflichtigen Plan enthalten. Die kostenlose Version bietet grundlegende Unterstützung für Wiederholfelder; kostenpflichtige Pläne schalten verschachtelte Wiederholfelder und erweiterte Funktionen frei.

Forge KI-Assistent Online

Hallo! Ich bin der Field Forge KI-Assistent. Fragen Sie mich alles über das Plugin — Einrichtung, Funktionen, Fehlerbehebung oder Entwicklung.

Gerade eben
Unterstützt von Forge KI · Dokumentation durchsuchen