[aide] M. Query Post (Créer un compte)

Parce que y’en a marre de devoir présenter M. Query post un topic sur deux, voici un topic dédié à son utilisation.

Avec la fonction Query Post on va pouvoir faire une tonne de choses ! C’est notamment très utile pour contrôler le nombre de billets à afficher, l’ordre de tri des billets, afficher les billets que de certaines catégories… Et plein d’autres choses ! Très utile pour la page d’index, de catégories, archives.

On va donc voir simplement comment procéder pour effectuer chacune de ces tâches. Ce topic est tout public, débutant comme confirmé, vous êtes les bienvenus 🍺.

1. Faut pas looper le site !

La loop [en] ou la boucle en français est la fonction qui permet d’afficher les articles, elle commence généralement ainsi :

<?php if (have_posts()) : ?><?php while (have_posts()) : the_post(); ?>

La fonction Query Post qui va nous permettre de personnaliser l’affichage des billets se glisse entre if have posts et while have post : the post (ne m’en veuillez pas les barbus) de telle manière :

<?php if (have_posts()) : ?>
<?php query_posts(''); ?>
<?php while (have_posts()) : the_post(); ?>

C’est bon tout le monde suit ? On a donc introduit la fonction Query Post qui pour le moment ne comporte aucune consigne, cela ne va donc rien affecter.

2. La personnalisation ça a du bon

Maintenant que tout le monde sait de quoi on parle, on va passer aux choses sérieuses.

2.1 Définir le nombre de billets à afficher

<?php if (have_posts()) : ?>
<?php query_posts('showposts=10'); 
// on affiche 12 billets max, les autres paramètres restent par défaut
?>
<?php while (have_posts()) : the_post(); ?>

Applications possibles : utile si on ne veut pas afficher le même nombre d’article sur notre index que sur nos pages d’archives par exemple.

Maintenant que vous avez compris comment fonctionne la loop et comment l’utiliser, on va être plus concis 😉.

2.2 Définir la catégorie d’où seront affichés les billets

query_posts(« cat=1 »); //affiche les billets classés dans la catégorie dont l’ID est 1
query_posts(« cat=-1 »); //affiche les billets classés dans toutes les catégories mis à part celle dont l’ID est 1
query_posts(« cat=1,2,3 »); //affiche les billets classés dans les catégories dont les IDs sont les suivants : 1, 2, 3
query_posts(« tag=tata-simone »); //affiche les billets ayant le tag « tata-simone »
query_posts(« tag=tata-simone,tonton-andre »); //affiche les billets ayant le tag « tata-simone » ou « tonton-andre »
query_posts(« tag=tata-simone+tonton-andre »); //affiche les billets ayant le tag « tata-simone » et « tonton-andre » (uniquement si ils comportent les 2)

Applications possibles : peut servir pour afficher les billets d’une seule catégorie dans la sidebar, faire un encart sur la page d’accueil…

2.3 Définir le mode de tri des billets

query_posts(« order=desc »);//tri les billets par date du plus récent au plus vieux
query_posts(« order=asc »);//tri les billets par date du plus vieux au plus récent
query_posts(« orderby=author »);//tri les billets par auteurs
query_posts(« orderby=category »);//tri les billets par catégories
query_posts(« orderby=category »);//tri les billets par modification
query_posts(« orderby=ID »);//tri les billets par ID

Applications possibles : dans un site où l’on ne souhaite pas mettre en avant la fraîcheur de l’information.

2.4 Afficher un billet particulier, une page particulière

query_posts(‘p=1’); //affiche le billet dont l’ID est 1
query_posts(‘page_id=1’); //affiche la page dont l’ID est 1
query_posts(‘pagename=tata-simone’); //affiche la page dont le titre est « tata simone »

Applications possibles : mis en valeur dans un but quelconque d’un post précis.

2.5 Exclure les x premiers billets

query_posts(« offset=10 »); //affiche les billets à partir du 11ème

Applications possibles : sur la page d’accueil (ou les pages d’archives), une fonction très intéressante qui permet de linker des posts assez vieux sous une mis en forme différente.

2.6 Sélectionner une période particulière (dans le temps)

query_posts(« hour=01 »); //affiche les billets publiés lors de l’heure 1
query_posts(« minute=1 »); //affiche les billets publiés lors de la première minute d’une heure
query_posts(« second=1 »); //affiche les billets publiés lors de la première seconde d’une minute
query_posts(« day=1 »); //affiche les billets publiés le premier jour du mois
query_posts(« monthnum=1 »); //affiche les billets publiés lors du premier mois d’une année
query_posts(« year=2000 »); //affiche les billets publiés lors de l’année 2000

Applications possibles : pour faire un retour dans le passé.

3. A deux c’est mieux

Mais on peut également cumuler ces paramètres !

Exemple, si je souhaite afficher 8 billets de la catégorie ayant l’ID 5 et 7″ :

query_posts(« showposts=8&cat=5,7 »);

Tadam !

Pareil, si on souhaite afficher 3 billets du tag « tata-simone » en trillant les billets par auteur :

query_posts(« showposts=3&tag=tata-simone&orderby=author »);

Vous l’avez donc surement compris (si non, c’est pas la peine de faire des tests de QI), pour cumuler les paramètres il faut utiliser ‘&’.

4. Voler de ses propres ailes

Maintenant c’est à vous de jouer. Toutefois sachez qu’il existe encore d’autres paramètres que vous pouvez consulter sur la page du codex de WordPress.org [en] dédiée à M. Query Post.

Je vous invite aussi à consulter la page dédiée à la démonstration de l’utilisation de la boucle [en] qui vous permettra de revoir les bases de la loop.

PS : pourquoi pas « post-iter » ce topic (quasiment d’intérêt public) ?