The Loop

Der WordPress The Loop ist der zentrale PHP-Mechanismus, mit dem WordPress Beiträge abruft und ausgibt. Fast jedes Theme nutzt ihn: Er geht durch alle Beiträge, die der aktuellen Anfrage entsprechen, und gibt für jeden Beitrag die Template-Ausgabe aus. Ohne den Loop keine Beitragsliste, keine Archivseite, keine Suchergebnisse.

Die Grundstruktur

<?php if ( have_posts() ) : ?>
    <?php while ( have_posts() ) : the_post(); ?>
        <article>
            <h2><?php the_title(); ?></h2>
            <?php the_content(); ?>
        </article>
    <?php endwhile; ?>
<?php else : ?>
    <p>Keine Beiträge gefunden.</p>
<?php endif; ?>

have_posts() prüft, ob noch Beiträge vorhanden sind. the_post() lädt den nächsten Beitrag und macht Template-Tags wie the_title() und the_content() verfügbar.

Custom Query Loop

Der Standard-Loop gibt die Beiträge aus, die WordPress für die aktuelle URL vorgesehen hat. Mit WP_Query lässt sich ein eigener Loop für beliebige Inhalte erstellen:

$query = new WP_Query( [ 'post_type' => 'portfolio', 'posts_per_page' => 6 ] );

if ( $query->have_posts() ) :
    while ( $query->have_posts() ) : $query->the_post();
        // Template-Ausgabe
    endwhile;
    wp_reset_postdata(); // Wichtig: Hauptloop wiederherstellen
endif;

Der Loop im Block Editor

Im Gutenberg Block Editor gibt es den Query Loop Block, der den klassischen PHP-Loop visuell abbildet. Mit ihm lassen sich Beitragslisten, Archivübersichten und gefilterte Inhalte ohne Code erstellen – mit allen Vorteilen des Block Editors: live Vorschau, Pattern-Unterstützung und volle FSE-Integration.