WordPress
La boucle (boucle WordPress principale)
Recherche…
Structure de boucle WordPress de base
Chaque fois que WordPress charge la page, celle-ci exécute la boucle principale .
La boucle est le moyen de parcourir tous les éléments liés à la page sur laquelle vous vous trouvez actuellement.
La boucle principale fonctionnera sur un objet WP_Query
global. La requête a une méthode globalisée have_posts()
, qui nous permet de parcourir tous les résultats. Enfin, à l'intérieur de la boucle, vous pouvez appeler la the_post()
(également en tant que fonction globale), qui définit l'objet post global sur la publication en cours dans la boucle, et définit la postdata sur la publication en cours. Grâce à cela, vous pouvez appeler des fonctions comme the_title
, the_content
, the_author
( balises template ) directement dans la boucle.
Par exemple, si vous êtes sur des listes de publications, la boucle principale contiendra un objet de requête avec tous les messages.
Si vous êtes sur un seul message (ou page), il contiendra une requête avec un seul message (page) sur lequel vous êtes actuellement.
if ( have_posts() ) :
while ( have_posts() ) :
the_post();
var_dump( $post );
endwhile;
endif;
Syntaxe de boucle alternative
Vous pouvez également utiliser une boucle avec des accolades comme ceci:
if ( have_posts() ) {
while ( have_posts() ) {
the_post();
var_dump( $post );
}
}
Manipulation d'aucun élément dans la boucle
Si vous voulez gérer un tel scénario, ajoutez simplement une instruction if/else
.
if ( have_posts() ) : while ( have_posts() ) :
the_post();
var_dump( $post );
endwhile; else :
__('This Query does not have any results');
endif;