Qu'est-ce que la requête WP_Query ?

WP_Query est une classe définie dans WordPress. Elle permet aux développeurs d’écrire des requêtes personnalisées et d’afficher les articles en utilisant différents paramètres. Il est possible pour les développeurs d’interroger directement la base de données de WordPress. Cependant, WP_Query est l’un des moyens recommandés pour interroger les articles depuis la base de données de WordPress.

Voici un exemple d’une WP_Query simple qui affiche les articles de la catégorie films :

1 <?php
2 // La requête
3 $the_query = new WP_Query( ‘category_name=movies’ ) ;
4
5 ?>

L’exemple de code ci-dessus n’affiche pas automatiquement les articles. Pour afficher les résultats de la requête, l’utilisateur doit utiliser la boucle de WordPress. Comme ceci :

1 <?php
2 // La requête
3 $the_query = new WP_Query( ‘category_name=movies’ ) ;
4
5 // La boucle
6 if ( $the_query->have_posts() ) {
7 echo ‘<ul>’ ;
8 while ( $the_query->have_posts() ) {
9 $the_query->the_post() ;
10 echo ‘<li>’ . get_the_title() . ‘</li>’ ;
11 }
12 echo ‘</ul>’ ;
13 } else {
14 // aucun message trouvé
15 }
16 /* Restaurer les données d’origine des messages */
17 wp_reset_postdata() ;
18
19 ?>

WP_Query est un outil puissant ; il existe de nombreux paramètres qui peuvent être utilisés pour écrire des requêtes plus complexes et plus avancées. WP_Query peut être utilisé pour créer des boucles imbriquées (une boucle WordPress à l’intérieur d’une boucle). Les développeurs WordPress peuvent l’utiliser dans leurs plugins et leurs thèmes pour créer leurs propres affichages personnalisés des articles.

Une liste complète des paramètres de WP_Query est disponible sur WordPress Codex.

A lire aussi :