Aujourd’hui nous allons voir comment fonctionne la fonction query_posts, qui nous servira dans d’autres tutoriels.
Tout d’abord a quoi peu bien nous servir cette fonction ?
La fonction query_posts peu nous servir a personnalisé une page d’accueil par exemple :
Admettons qu’ont veuillent insérer plusieur boucle (loop) différente sur notre page d’accueil de notre site :
Un entête avec une boucle contenant les cinq articles de la catégorie Nouveauté.
Ce qui nous donneraient avec la fonction query_posts :
// début de la boucle avec la fonction query_post
<?php query_posts('cat=2&showposts=5'); while (have_posts()) : the_post(); ?>
<?php the_content(); ?>// affiche du contenu de votre article
<?php endwhile; ?> // fermeture de la boucle
Ici dans cette boucle j’ai indiqué a la fonction query_post que je voulais afficher la catégorie Nouveauté qui a pour identifiant 2 (cat=2) et (&) les 5 articles récent de cette catégorie (showpost=5). Voila un exemple simple de la fonction query_posts elle peu faire bien plus de choses voyons ca en détail.
Query_posts et les catégories de vos articles.
Cat et category_name pour afficher les catégories désirer.
query_posts("cat=2"); //Affiche les articles de la catégorie qui a pour identifiant 2
query_posts("cat=-2"); //Retire la catégorie qui a pour identifiant 2
query_posts("category_name=nouveaute"); //Affiche les articles de la catégorie "nouveaute"
query_posts("cat=1,2,4"); //Affiche un série de catégories qui ont pour identifiant 1,2,4
A noter dans le code ci-dessus vous avez le choix avec l’identifiant de la catégorie, vous avez l’ID qui se récupère dans la barre d’adresse :
http://…../edit-tags.php?action=edit&taxonomy=category&tag_ID=2&post_type=post
Ou
L’identifiant normalisé du nom de votre catégorie qui est obtenu lorsque vous créer une catégorie exemple :
Nouveauté = nouveaute. Dans se cas ont utilisera category_name=nouveaute. L’identifiant normalisé du nom de votre est plus pratique si par exemple vous créer une page d’accueil avec plusieurs boucle cela vous permet de vous repérez plus facilement dans le code ou chaque catégorie est afficher.
Afficher un article unique
P= et name va permettre l’affichage d’un seul article
query_posts('p=10'); //Affiche l'article avec l' identifiant 10
query_posts('name=titre-de-mon-article'); //Affiche l'article avec identifiant normalisé "titre-de-mon-article"
Idem que pour les catégories ont pourra utiliser l’identifiant :
http://…./post.php?post=692&action=edit&message=10
Ou
L’identifiant normalisé qui est le titre de votre article il est obtenu lors de l’édition de l’article sous le titre vous avez permalien : http://…/titre-de-mon-article et l’identifiant sera : name=titre-de-mon-article
Afficher une page unique
Page et pagename va permettre l’affichage d’une seule page
query_posts("page_id=4"); //Affiche la page avec l' identifiant 4
query_posts("pagename=contact"); //Affiche la page avec l’identifiant normalisé "contact"
Mais quel intérêt a affiché une page ? Cela pourrait servir dans le cas ou voulez par exemple afficher un formulaire de contact visible directement en page d’accueil.
Déterminer le nombre d’article a affiché
Showpost et offset va permettre d’afficher le nombre d’article désiré.
query_posts('showposts=7'); //Affiche les 7 premiers articles
query_posts('offset=2');//On exclu les 2 premiers article
Showpost va indiquer que vous voulez afficher que 7 articles d’une catégorie, il affichera les articles par ordre de parution vous pouvez modifier aussi l’ordre d’affichage :
query_posts('orderby=post_date&order=desc')
orderby modifie l’ordre d’affichage :
post_date – Trier par date de poste (qui est la valeur par défaut).
post_author – Trier par l’auteur.
post_title – Trier par titre.
post_modified – Trier par date de modification.
post_menu_order – Trier par ordre des menus .
post_parent – Trier par parent.
post_id – Trier par ID.
post_rand – un ordre aléatoire.
Order ici ont affichera les articles par ordre décédant order=desc pour les affiché dans un ordre ascendant ont utilisera order=asc qui est la valeur par défaut.
vous pouvez obtenir plus d’information sur le codex wordpress
Offset permet de retirer des articles que vous vous pas affichez, prenons un exemple :
Vous avez créé une page pour une catégorie d’articles en entête vous voulez affichez le dernier article de cette catégorie et en dessous vous voulez affichez une liste de dix articles de la même catégorie :
La boucle pour afficher le dernier article de la catégorie sera :
<?php query_posts('cat=2&showposts=1'); while (have_posts()) : the_post(); ?>// début de la boucle
<?php the_content(); ?>// affiche du contenu de votre article
<?php endwhile; ?> // fermeture de la boucle
La boucle pour afficher les dix autres articles de la même catégorie sera :
<?php query_posts('cat=2&showposts=10&offset=1'); while (have_posts()) : the_post(); ?>// début de la boucle
<?php the_content(); ?>// affiche du contenu de votre article
<?php endwhile; ?> // fermeture de la boucle
Dans la première boucle j’ai combine cat=2 qui est l’identifiant de ma catégorie et(&) showpost=1 qui indique que je veux qu’un seul article (le dernier publier dans la catégorie).
Dans ma deuxième boucle j’ai combiné cat=2 qui est l’identifiant de ma catégorie et(&) showpost=10 qui indique que je veux afficher dix articles et(&) offset=1 retire le premier article (( le dernier publier dans la catégorie).
Voila a quoi peu servir la fonction quey_post.
Voici une liste des fonction query_posts et que vous pouvez combiné selon vos besoins.
query_posts("tag=voiture"); //Affiche les articles qui ont le tag (mot clé) "voiture"
query_posts("tag=voiture,vert"); //Affiche les articles qui ont le tag (mot clé) "voiture" OU "vert"
query_posts("tag=voiture+vert+marque"); //Affiche les articles qui contiennent les 3 tags( mots clé)
query_posts("author_name=auteur-m,admin"); //Affiche les articles de l'auteurs "auteur-m" et "admin"
query_posts("author=6"); //Affiche les articles de l'auteur avec l'identifiant 6
query_posts("author=-8"); //Exclu les articles de l'auteur avec l'identifiant 8
query_posts("hour=01"); //Affiche les articles qui ont été publiés pendant l'heure 1
query_posts("minute=30"); //Affiche les articles qui ont été publiés pendant la 30ème minute
query_posts("second=07"); //Affiche les articles qui ont été publiés pendant la 7ème seconde
query_posts("day=1"); //Affiche les articles qui ont été publiés le 1er jour de la semaine
query_posts("monthnum=1"); //Affiche les articles qui ont été publiés pendant le 1er moi
query_posts("year=2010"); //Affiche les articles qui ont été publiés pendant l'année 2010
query_posts("posts_per_page=10"); //Affiche 10 articles par page
Conclusion
La fonction query_posts est très utile si ont veut personnaliser son site créer une page d’accueil, une page pour une catégorie d’article…. et bien d’autre, et sa vous permet de vous initiez au codage de wordpress et a sont fonctionement.