WP_Query est une classe définie dans WordPress. Elle permet aux développeurs/développeuses d’écrire des requêtes personnalisées et d’afficher les publications en utilisant différents paramètres. Il est possible pour les développeurs/développeuses d’interroger directement la base de données de WordPress. Cependant, WP_Query est l’une des méthodes recommandées pour interroger les publications depuis la base de données de WordPress.
Voici un exemple d’une simple requête WP_Query qui affiche les publications de la catégorie films :
1 2 3 4 5 | <?php// The Query$the_query = new WP_Query( 'category_name=movies' );?> |
L’exemple de code ci-dessus n’affiche pas automatiquement les publications. Pour afficher les résultats de la requête, le compte doit utiliser la boucle de WordPress. Comme ceci :
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 | <?php// The Query$the_query = new WP_Query( 'category_name=movies' );// The Loopif ( $the_query->have_posts() ) { echo '<ul>'; while ( $the_query->have_posts() ) { $the_query->the_post(); echo '<li>' . get_the_title() . '</li>'; } echo '</ul>';} else { // no posts found}/* Restore original Post Data */wp_reset_postdata();?> |
WP_Query est un outil puissant il y a beaucoup de paramètres qui peuvent être utilisés pour écrire des requêtes plus complexes et 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/développeuses WordPress peuvent l’utiliser dans leurs extensions et thèmes pour créer leurs propres affichages personnalisés des publications.
Une liste complète des paramètres de WP_Query est disponible sur le Codex de WordPress.
