WP_Query est une classe définie dans WordPress. Elle permet aux développeurs d'écrire des requêtes personnalisées et d'afficher des articles en utilisant différents paramètres. Il est possible pour les développeurs d'interroger directement la base de données WordPress. Cependant, WP_Query est l'une des méthodes recommandées pour interroger des articles de la base de données WordPress.
Ci-dessous un exemple de WP_Query simple qui affiche les articles de la catégorie films :
<?php // The Query $the_query = new WP_Query( 'category_name=movies' ); ?>
Le code d'exemple ci-dessus n'affiche pas automatiquement les articles. Pour afficher les résultats de la requête, l'utilisateur devra utiliser la boucle 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 existe de nombreux 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 dans une boucle). Les développeurs WordPress peuvent l'utiliser dans leurs plugins et thèmes pour créer leurs propres affichages personnalisés d'articles.
Une liste complète des paramètres de WP_Query est disponible sur WordPress Codex.
