La classe PHP WP_Query de WordPress est un ensemble d’instructions permettant de personnaliser l’affichage d’un ou plusieurs articles en fonction de critères définis. Elle sert à extraire des éléments spécifiques du site en se basant sur des critères prédéfinis tels que les catégories, les étiquettes, les auteurs, les dates, les types de contenus, etc.
Pour utiliser la classe WP_Query, on crée une requête en spécifiant les critères de récupération des données. Par exemple, on peut définir les catégories, les étiquettes, le nombre d’articles à afficher, etc. Cette requête peut être intégrée de différentes manières : directement dans le template en PHP, via les blocs de requête avec Gutenberg, en ajoutant des données dynamiques avec un code PHP personnalisé, en utilisant des plugins comme le module Blog de Divifilter avec Divi, en passant par le Query builder d’Oxygen Builder, ou en utilisant des widgets comme Pots et Loop Grid avec Elementor.
Un exemple d’utilisation de la classe WP_Query est le suivant :
« `php
$args = array(
‘post_type’ => ‘post’,
‘category_name’ => ‘actualites’,
‘posts_per_page’ => 5
);
$query = new WP_Query( $args );
if ( $query->have_posts() ) {
while ( $query->have_posts() ) {
$query->the_post();
// le code pour afficher le contenu de l’article va ici
}
}
wp_reset_postdata();
?>
« `
Un synonyme couramment utilisé pour décrire ce processus est « boucle de requête ». En anglais, on fait référence à cela comme un « loop » ou « query loop ». Pour plus d’informations, vous pouvez consulter la documentation associée.