Mot-clef « Plugin »

Plugin Post-lister pour Wordpress - version 0.2

Je viens de mettre en ligne la version 0.2 de mon plugin post-lister avec quelques nouveautés :

  • gestion de listes de commentaires en plus des listes d'articles.
  • séparation de l'attribut showdate en deux attributs distincts showdate et showtime.
  • importante refactorisation du code pour utiliser le générateur de plugin que j'ai commencé à développer (et qu'il serait bien que je continue un jour, d'ailleurs...).
  • diverses petites corrections.

N'hésitez pas à tester cette nouvelle version et à me remonter les bugs éventuels !

J'ai fait la demande pour l'intégration au repository officiel, reste plus qu'à attendre la validation et traduire la doc en anglais...


Mon premier plugin WordPress dans le repository

Après d'abord plusieurs semaines d'attente de validation, puis deux semaines pour reprendre le temps de m'en occuper, je viens de "commiter" mon premier plugin (Open Search) dans le repository officiel WordPress.

Alors en passant, quelques remarques sur la façon dont ça fonctionne :

  • la récupération des informations à afficher dans la page du plugin est bizarre : certaines infos sont reprises de l'en-tête du fichier PHP principal du plugin, d'autres de fichier readme.txt... Alors qu'une partie est présente dans les deux... Pas très cohérent... J'aurais mieux vu l'ensemble pris dans le "readme" (c'est d'ailleurs ce que je pensais à l'origine).
  • je serais curieux de savoir pourquoi il n'affiche pas dans la page du plugin les onglets "Installation", "FAQ" et "Screenshots", alors qu'ils sont bien présents dans le fichier "readme"...
  • il semblerait bien que les infos affichées soient prises dans le "trunk" et non dans la dernière version stable... D'un côté c'est pas con parce que ça permet de les corriger sans "taguer" de nouvelle version exprès mais d'un autre côté ça veut dire que si on "commite" des modifications dans le trunk pour une nouvelle version, ben c'est ça qui va s'afficher alors que cette nouvelle version n'est pas celle qui est disponible en téléchargement par défaut, ce qui ne me semble pas très malin.

Bref, maintenant faut que je me motive pour finaliser la nouvelle version de Post-lister et traduire la doc pour pouvoir le publier aussi :p


Plugin Open search pour Wordpress - version 1.0.1

Je viens de mettre en ligne une nouvelle version de mon petit plugin Open search. Cette nouvelle version n'apporte rien fonctionnellement mais inclus le fichier readme.txt nécessaire à l'ajout sur le repository officiel, un fichier de traduction en anglais et une page de documentation en anglais ( enfin, en anglais de développeur qui se débrouille plus ou moins, hein... je suis preneur de toute suggestion de correction qui en ferait du "vrai" anglais ;:).

Prochaine étape, faire de même avec Post-lister une fois qu'il sera à peu près arrivé à maturité... D'ailleurs la version 0.2 ne devrait pas tarder, maintenant que je suis en vacances, j'ai un peu de temps :smile: Au passage s'il y a un volontaire pour la traduction de la doc, il est le bienvenu (pas forcément tout de suite, vu qu'elle va pas mal bouger avec la prochaine version) :p


Preview : générateur de plugin WordPress

J'ai déjà développé quelques plugins WordPress, même si peu sont publiés (pour diverses raisons, la plupart du temps parce qu'ils sont encore trop limités ou pas assez finalisés).

Le dernier en date est Post-lister qui permet d'ajouter des listes d'articles soit dans un message grâce à un shortcode, soit en tant que widget. Au final c'est pas loin de 600 lignes qui mènent à ce résultat (si on vire les nombreux commentaires, on descend pas mal ce chiffre mais bon, les commentaires ça fait partie du code).

Et 600 lignes c'est beaucoup.

Surtout si l'on considère que moins de 200 d'entre elles concernent directement le listage de messages et que le reste serait quasiment identique si au lieu de lister des messages, on affichait une photo de Chuck Norris !

La conclusion est donc évidente : ce code répétitif doit être factorisé d'une manière ou d'une autre, il est exclu de faire des copier/coller à chaque plugin, ce qui serait un cauchemar à maintenir. Pour cela je vois en gros trois possibilités :

  1. modifier plein de trucs dans WordPress pour qu'ils facilitent l'intégration de ce genre de plugin : je l'ai déjà fait avec phpBB (pas le choix faut dire vu qu'il ne gère absolument pas de plugins...) mais c'est un cauchemar pour les mises à jour puisqu'on ne peut plus se contenter de remplacer les fichiers... Résultat, je n'utiliserai probablement jamais phpBB3 vu que je devrais tout migrer... et intégralement recommencer pour la version suivante... Donc niet.
  2. développer un petit framework annexe à WordPress sous forme d'un plugin à part proposant des classes de base pour pas mal de trucs : ça pourrait être une solution, j'y viendrai probablement à terme d'ailleurs mais c'est pas super pratique parce que ça empêche d'utiliser deux plugins basés sur des versions différentes dudit framework et ça complexifie l'installation (puisqu'il faut installer la dépendance avant).
  3. développer un générateur de code : et là où c'est cool c'est qu'à peu de choses près j'avais déjà tout ce qu'il fallait dans ma tentative avortée de développer un script de forum perso : intégration de Smarty, quelques petites classes pour palier au manque flagrant de PHP en matière d'homogénéité des fonctions de traitements de chaines et autres.

C'est donc dans cette troisième voie que je me suis lancé il y a quelque temps et ça commence à prendre forme : en me basant sur un modèle en XML listant les différents paramètres, leur type et quelques autres infos, je génère automatiquement une classe de base contenant le nécessaire pour implémenter un "bloc" affichable sous forme de shortcode et/ou de widget, avec pour ce dernier un formulaire back-office et un fichier .pot pour les chaines localisées associées. Une fois tout ce petit monde généré on peut se concentrer sur la partie intéressante : le fonctionnel réel du plugin, pas son enrobage pour l'intégrer dans WordPress.

Bon, à l'heure actuelle ce n'est pas encore prêt à être publié (c'est chiant à installer et ça ne s'utilise qu'en ligne de commandes) et certains trucs manquent encore à la génération comme la page de configuration des préférences en back-office. Mais ça viendra...

Et du coup la prochaine version de Post-lister ne devrait pas tarder, avec un code refactoré pour être majoritairement généré, quelques options supplémentaires pour la liste des articles et la possibilité d'afficher également des listes de commentaires (c'est à peu près fonctionnel, donc peut-être ce weekend ^^).


Plugin "Post-lister" pour WordPress

À l'origine de ce plugin il y avait Query inside post de k-ny qui permet d'intégrer dans un article une liste d'articles générée automatiquement selon certains critères via une balise ShortCode.

En voulant corriger un bug de ce plugin (si l'on intégrait une liste de messages, les données affichées en bas de l'article, comme le lien vers le flux RSS ou la liste des catégories étaient ceux du dernier article de la liste et non celles de l'article courant) à force de refactoring, j'en suis finalement arrivé à le ré-écrire intégralement ainsi qu'à y ajouter certaines fonctions supplémentaires :

  • paramètres d'affichages : afficher pour chaque article de la liste l'auteur et/ou la date et/ou le nombre de commentaires.
  • widgetisation : on peut également intégrer une ou plusieurs listes d'articles à sa sidebar sous la forme d'un widget (le fait de définir un widget pouvant être utilisé plusieurs fois en même temps fut d'ailleurs étonnamment laborieux, du fait du caractère passablement brouillon de l'implémentation de la fonctionnalité dans WordPress et du codage du seul widget de base qui l'utilise et peut donc servir d'exemple : le widget d'affichage d'un flux RSS).

Le plugin final étant entièrement recodé, j'ai finalement décidé d'en faire un plugin distinct que voici : Post-lister v0.1

EDIT : Ajout de la page de documentation dédiée.