The Loop

Définition : The Loop est le mécanisme WordPress qui parcourt les publications renvoyées par une requête afin de les afficher dans un template. Il s’appuie notamment sur have_posts() et the_post() pour gérer le contexte courant.

Terminologie

Appellation officielle : The Loop

Autres appellations : Boucle WordPress, WordPress Loop

Comprendre le fonctionnement

Dans un thème classique, la boucle parcourt chaque élément récupéré par WP_Query et prépare les données utilisées par les template tags : titre, contenu, date ou extrait. Le nombre de passages correspond au nombre de contenus effectivement présents dans les résultats de la requête. La boucle fournit un modèle répétitif de rendu mais ne décide pas seule quels contenus doivent être chargés.

Il faut distinguer la boucle principale d’une boucle secondaire. Lorsque plusieurs boucles coexistent, le code doit contrôler quelle instance WP_Query est parcourue et restaurer les données globales modifiées après une requête personnalisée. Dans les thèmes blocs modernes, le bloc Query Loop offre une interface de composition basée sur des mécanismes associés mais différente d’une boucle PHP écrite à la main.

Exemple concret

Un template d’archive affiche successivement le titre des publications retournées par la requête principale.

Exemple de code commenté

<?php
// Dans un template de thème classique.
if ( have_posts() ) {
    while ( have_posts() ) {
        the_post();
        echo '<h2>' . esc_html( get_the_title() ) . '</h2>';
    }
}