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 :
<?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 :
<?php
// The Query
$the_query = new WP_Query( 'category_name=movies' );
// The Loop
if ( $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.
