ACF Repeater-Feld in WordPress – Dynamische Inhalte effizient verwalten

Lesezeit: ca. 3 Minuten

ACF Repeater-Feld: Dynamische Inhalte in WordPress flexibel gestalten

Das Advanced Custom Fields (ACF) Repeater-Feld ermöglicht es, wiederholbare Gruppen von Feldern in WordPress zu erstellen. Dies ist besonders nützlich, um dynamische Inhalte wie Slideshows, Team-Mitglieder-Profile oder FAQs effizient zu verwalten. In diesem Beitrag erfährst du, wie du das Repeater-Feld einrichtest und in deinen WordPress-Themes nutzt.

Was ist das ACF Repeater-Feld?

Das Repeater-Feld von Advanced Custom Fields ( ACF ) erlaubt es, eine Gruppe von Unterfeldern zu definieren, die beim Bearbeiten von Inhalten beliebig oft wiederholt werden können. Dabei können verschiedene Feldtypen wie Text, Bild oder WYSIWYG-Editor als Unterfelder hinzugefügt werden.

Einrichtung des Repeater-Feldes

1. Feldgruppe erstellen: Gehe im WordPress-Dashboard zu Custom Fields > Feldgruppen und erstelle eine neue Gruppe.

2. Repeater-Feld hinzufügen: Füge ein neues Feld vom Typ Repeater hinzu und definiere die benötigten Unterfelder, z. B. Textfelder für Titel und Beschreibung oder Bildfelder für Grafiken.

3. Feldgruppe zuweisen: Weise die Feldgruppe den gewünschten Beitragsarten oder Seiten zu.

Verwendung des Repeater-Feldes im Template

Um die Daten des Repeater-Feldes im Frontend anzuzeigen, kannst du folgenden Code in dein Theme-Template einfügen:

<?php

// Überprüfen, ob Zeilen im Repeater-Feld vorhanden sind.
if( have_rows('repeater_field_name') ):

    // Durch die Zeilen des Repeater-Feldes schleifen.
    while( have_rows('repeater_field_name') ) : the_row();

        // Unterfeld-Werte laden.
        $sub_value = get_sub_field('sub_field_name');
        // Hier kannst du den Wert ausgeben oder weiterverarbeiten.

    endwhile;

else :
    // Keine Zeilen gefunden.
    echo 'Keine Einträge vorhanden.';
endif;
?>

Erläuterung:

• have_rows(‚repeater_field_name‘): Überprüft, ob das Repeater-Feld Zeilen enthält.

• the_row(): Setzt die aktuelle Zeile des Repeater-Feldes.

• get_sub_field(’sub_field_name‘): Holt den Wert des angegebenen Unterfeldes.

Beispiel: Slider mit dem Repeater-Feld

Mit dem Repeater-Feld kannst du beispielsweise einen einfachen Bild-Slider erstellen:

<?php if( have_rows('slides') ): ?>
    <ul class="slides">
    <?php while( have_rows('slides') ): the_row(); 
        $image = get_sub_field('image');
        ?>
        <li>
            <?php echo wp_get_attachment_image( $image, 'full' ); ?>
            <p><?php echo esc_html( get_sub_field('caption') ); ?></p>
        </li>
    <?php endwhile; ?>
    </ul>
<?php endif; ?>

Erläuterung:

• have_rows(’slides‘): Überprüft, ob das Repeater-Feld “slides” Zeilen enthält.

• get_sub_field(‚image‘): Holt das Bild-Unterfeld.

• wp_get_attachment_image( $image, ‚full‘ ): Gibt das Bild in voller Größe aus.

• get_sub_field(‚caption‘): Holt das Unterfeld für die Bildunterschrift.

Fazit

Das ACF Repeater-Feld bietet eine flexible Möglichkeit, wiederholbare Inhalte in WordPress zu erstellen und zu verwalten. Durch die einfache Integration in Themes und die Unterstützung verschiedener Feldtypen kannst du dynamische und komplexe Layouts effizient umsetzen.