Webinventif

Query Inside Post (QIP) est un plugin qui va vous permettre d'insérer une boucle personnalisée à l'intérieur d'un billet via un tout petit bout de code !

A qui s'adresse "Query Inside Post" ?

Principalement aux personnes qui font régulièrement des listings de leur billets. Le coté pratique, c'est que l'on va pouvoir créer un listing personnalisé très facilement.
Edit 22/04/08: permet aussi d'afficher une liste de liens n'importe où dans votre thème !

Installation

1. Téléchargez le plugin
2. Uploadez le dossier du plugin dans le dossier /wp-content/plugins/ de votre blog
3. Activez le plugin depuis l'interface d'administration de votre blog (Plugins)

Voilà c'est installé !

Utilisation

Commencez un nouveau billet, et à l'endroit où vous voulez insérer le listing personnalisé, utilisez le code suivant:

[wlist attribut1=valeur1 attribut2=valeur2]

Il vous faut remplacer les attributs selon ce qui vous conviens. Par exemple, pour afficher une liste des 5 derniers billet contenant le tag google, placez le code suivant:

[wlist tag=google showposts=5]

Simple non ?

Et si vous voulez afficher une liste directement dans votre thème:

Donc par exemple, pour afficher la liste des 10 derniers billets de la catégorie 5 dans une liste ordonnée:

Voici la liste des attributs possible (voir aussi query_posts()):

Par défaut, affiche la liste des 5 derniers billets sous forme de lien.

• request: Vide par défaut. Pour les utilisateurs expérimentés, permet d'envoyer sa propre requête (ex: request="tag=google&showposts=5")
• cat: Vide par défaut. Permet de préciser l'ID de la catégorie (ex: cat=5 ou cat="5,6,7" ou cat=-5)
• category_name: Vide par défaut. Permet de préciser le nom de la catégorie (ex: category_name="Web Design")
• tag: Vide par défaut. Permet de préciser le nom (slug) du tag (ex: tag=vie-personelle ou tag="vie-personelle,photos" ou tag="vie-personelle+photos")
• order: "desc" par défaut. Permet de préciser l'ordre de tri (ex: order=asc ou order=desc)
• orderby: "post_date" par défaut. Permet de préciser le paramètre de tri (ex: orderby=post_title ou orderby=post_date ou orderby=random)
• author: Vide par défaut. Permet de préciser l'ID de l'auteur (ex: author=1 ou author=1,2 ou wlist author=-1)
• author_name: Vide par défaut. Permet de préciser le nom de l'auteur (ex: author_name="Julien")
• showposts: 5 par défaut. Permet de préciser le nombre d'éléments a retourner (ex: showposts=10)
• offset: Vide par défaut. Permet de préciser l'offset (ex: offset=3)
• beforelist: <ul class="wlist"> par défaut. Permet de préciser la tag se trouvant au début de la liste (ex: beforelist="<ol>")
• afterlist: </ul> par défaut. Permet de préciser la tag se trouvant à la fin de la liste (ex: afterlist="</ol>")
• beforeitem: <li> par défaut. Permet de préciser la tag se trouvant au début de chaque élément (ex: beforeitem="<li><p>")
• afteritem: </li> par défaut. Permet de préciser la tag se trouvant à la fin de chaque élément (ex: afteritem="</p></li>")

Chaque attribut est facultatif.
On peut évidement cumuler les attributs (ex: tag=google showposts=5)
/! N'utilisez pas l'attribut "cat" en même temps que l'attribut "tag" (bug wordpress), c'est ou l'un ou l'autre

Vous pouvez tout à fait insérer plusieurs listes, avec des paramètres différents, dans le même billet.

Quelques exemples

Par exemple, vous administrez un blog "People" et vous voudriez faire un article résumé sur la "Star Academy" (oh, le beau sujet !). Et évidement vous voudriez afficher tous vos articles parlant de Bertrand et de Lucie ...

Tous connaitre sur Bertrand:
[wlist tag=Bertrand showposts=50]

Et tout sur Lucie:
[wlist tag=Lucie showposts=50]

Vive la Star Academy

Enfin voilà, vous avez compris le principe !

Conclusions

Si vous utilisez vraiment beaucoup de listes dans vos billets, vous devriez envisager d'utiliser le plugin wp-cache pour WordPress. Car celà engendre pas mal de requêtes qui peuvent se révéler gourmande en ressources CPU.

Vous pouvez évidement personnaliser la manière dont s'affiche la liste en éditant le fichier qip.php. Gardez juste en tète que ça affectera toutes vos listes !

Je n'ai pas vraiment le temps ni les moyens d'approfondir ce plugin, mais si un développeur motivé passe dans le coin, voici les fonctions qu'il serait bon d'ajouter:

• ajout d'une page d'administration
• possibilité de créer plusieurs templates de liste (via la page administration)