Comment utiliser la requête WP query pour l’affichage de vos articles

Dans un précédent article, je vous avais expliqué comment utiliser la fonction query_post pour personnaliser l’affichage de vos articles, ici je vais vous expliquer comment utiliser la requête WP_Query  avec quelques exemples de boucles personnalisées et un tableau avec toutes les possibilités de requête.


La requête WP_query

La requête WP_query est une boucle (The Loop)  qui est utilisée par WordPress pour afficher chacun de vos articles avec l’interprétation d’un tableau d’arguments qui traiteront tous les articles devant être affichés sur la page active avec des critères précis d’affichage catégorie, mots clés, identifiant, auteur….


La boucle contient du code html,  php et les marqueurs the_exerpt qui affichera un extrait de l’article the_title qui affichera le titre et the_permalink qui indiquera le lien dans la balise href de chaque article.


La requête Wp_query peut être utilisé dans les pages templates de votre thème elle peut-être placer n’import  où voici un exemple de la forme courte :

<?php

$the_query = new WP_Query('cat=0&showposts=2');

while ($the_query->have_posts()) : 
$the_query->the_post();

 		// Votre boucle 

?>

  <h2><a href="<?php the_permalink() ?>"><?php the_title(); ?></a></h2>

  <p><?php the_excerpt();?></p>

<?php  // Votre boucle fin

endwhile;

?>

L’exemple ci-dessus est formulé comme pour requête query_post pour une insertion rapide d’une boucle sur votre page ou sidebar.


Maintenant passons a une forme plus développer rien de bien compliquer, il suffit de juste de savoir se que vous voulez afficher. Pour cela ont va utiliser $args un tableau d’arguments qui correspondra a une liste de conditions pour personnaliser l’affichage de vos articles.


Exemple :

<?php 

$args= array(

			'showposts' => 3,

			'cat' => 0,

			'orderby'  => 'rand'

			);

$the_query = new WP_Query($args);

while ($the_query->have_posts()) : 
$the_query->the_post();

  	   // Votre boucle 

?>

  <h2><a href="<?php the_permalink() ?>"><?php the_title(); ?></a></h2>

  <p><?php the_excerpt();?></p>

<?php // Votre boucle fin

endwhile;

?>

Dans mon tableau arguments ci-dessus j’ai utilisé les conditions suivantes :


– showposts :  pour nombre d’article a afficher.

– cat : pour indiquer l’identifiant numérique de la catégorie de mes articles.

– orderby : pour avoir un ordre d’affichage aléatoire.


Important : Quant vous utilisez une liste d’arguments, chaque condition est séparée par une virgule.


Afficher des articles d’une catégorie avec un mot clé spécifique par date de parution descendante

Dans cet autre exemple, je voudrais une boucle qui m’affiche 5 articles de la catégorie voiture avec le mot clé rouge classé par date de parution descendante :

Je créer mon tableau d’arguments et j’y ajoute mes conditions :

<?php 

$args= array(

			'showposts' => 5, // nombre d'article 

			'category_name'  => 'voiture', // nom de la catégorie (identifiant sans accent et majuscule)

			'orderby'  => 'date', // ordre par date

			'order'  => 'desc', // ordre décendant

			'tag' => 'rouge' // mot clé (identifiant sans accent et majuscule)

			);

?>

Dans ce tableau d’arguments, je vais utiliser les conditions suivantes :


Showposts : pour le nombre d’articles

Category_name : pour indiquer quelle catégorie d’articles ( identifiant nom )

Orderby : pour trier mes articles par date

Oder : pour indiquer l’ordre d’affichage (ascendant ou descendant)

Tag : pour choisir les articles, qui seront affichés avec le mot clé rouge.


Et après ma boucle qui va interpréter mes conditions dans le tableau d’arguments :

<?php

$the_query = new WP_Query($args);

while ($the_query->have_posts()) : 
$the_query->the_post();

       // Votre boucle ici

?>

  <h2><a href="<?php the_permalink() ?>"><?php the_title(); ?></a></h2>

  <p><?php the_excerpt();?></p>

<?php // Votre boucle ici fin

endwhile;

?>

Afficher des articles par post type.

Les custom post types de WordPress permettre de créer des types de contenu sur mesure et différent modèle d’article cet a dire différents éditeurs pour des sections spécifiques. L’usage des custom post types est de plus en plus répandus pour des sites professionnels.


Ici nous allons voir comment récupérer les articles d’un post type.

<?php

$args= array(

			'post_type' => 'post' // post type par défaut

			);

?>

<?php

$the_query = new WP_Query($args);

while ($the_query->have_posts()) :
 $the_query->the_post();

       // Votre boucle ici

?>

  <h2><a href="<?php the_permalink() ?>"><?php the_title(); ?></a></h2>

  <p><?php the_excerpt();?></p>

<?php // Votre boucle ici fin

endwhile;

?>

Dans mon tableau d’arguments j’ai utilisé la condition post_type pour indiqué quel type d’article je voulais récupérer dans cet exemple j’ai indiqué post qui l’éditeur par défaut des articles dans wordpress, vous pouvez remplacer post par votre post_type exemple : football, athlétisme, tennis….



Si je voulais récupérer un extrait de mes pages j’utiliserais le même tableau d’argument avec la même condition en remplaçant post par page:

<?php

$args= array(

			'post_type' => 'page' // post type par défaut pour les pages

			);

?>

Plusieurs boucles sur la même page

Dans le cas où vous voulez créer une page avec plusieurs boucles avec des tableaux d’arguments et différentes conditions il est important de rajouter cette fonction wp_reset_postdata à la fin de vos boucles après le endwhile comme ceci :

<?php

endwhile;

?>

<?php wp_reset_postdata(); ?>

La fonction wp_reset_postdata va tous simplement restaurer les valeurs par défaut de la requête WP_query de façon à ce que les tableaux d’arguments et les conditions de chaque boucle ne rentrent pas en conflit et vous génère des erreurs d’affichage.


Conclusion

La requête WP_query peu s’utiliser de manière très simple si vous démarré un nouveau blog avec peu d’articles, mais elle peu s’avérer très utile dans l’évolution de votre blog si il contient un très grand nombre d’articles classés dans plusieurs catégories, post type, mots clé …. Et offre beaucoup de possibilité d’affichage pour une page d’accueil, un index ou dans votre sidebar.

Le fait de clarifier l’affichage de vos articles avec la requête WP_query permettra une navigation plus simple pour vos internautes.


[member]
Tuturiel WP query.zip
[/member]