L’article du jour concerne toujours la création de plugin pour WordPress. Cependant, on ne parlera pas de code PHP, javascript ou autre. Aujourd’hui ce qui va nous intéresser, c’est de rendre notre plugin accessible à la communauté. Quel meilleur moyen pour y arriver que d’utiliser les outils que nous propose WordPress? En effet, si vous créez un plugin WordPress, vous pouvez vous rendre sur le site officiel afin d’y créer un compte. Celui la vous donnera accès au serveur SVN pour y uploader vos fichiers.

L’intérêt du SVN est multiple. D’abord, vos fichiers sont sauvegardés en ligne et vous conservez un historique de vos anciennes versions. De plus, votre plugin devient accessible via le moteur de recherche de plugin WordPress (que ce soit celui de leur site ou celui intégré dans le CMS). L’installation de votre extension en est donc facilité, il n’y a plus besoin d’utilisé un client FTP, et l’utilisateur est prévenu lorsqu’une mise à jour est disponible. Enfin,  si vous avez correctement rédigé le fichier readme, vous pourrez fournir des informations interessantes à vos utilisateurs potentiels, ainsi que des screenshots de votre plugin (WordPress fourni aussi des statiques de téléchargement de votre plugin).

Maintenant que avons vu les avantages que nous procure SVN, nous allons voir comment il fonctionne. Si vous êtes sur système debian-like, l’installation sera des plus aisée :

apt-get install subversion

Pour Windows, plusieurs logiciels existent, le plus connu étant surement TortoiseSVN. Si vous voulez l’utiliser rendez-vous à cette adresse pour le télécharger. L’installation est classique pour un logiciel Windows, et le programme une fois installé vous créera des entrées supplémentaires dans le menu clique droit de vos dossiers, à l’instar d’un 7zip. Vous remarquerez que lorsqu’un dossier est bien synchronisés avec le serveur, TortoiseSVN y ajoute une petite coche verte dans le coin inférieur gauche.

Le SVN de WordPress se trouve à l’adresse suivante : http://svn.wp-plugins.org/[nom_de_votre_plugin]/. Le dossier de votre plugin contient 3 sous-dossiers : branches, tags, trunk. Le dossier tags contient vos anciennes versions et trunk la dernière version disponible. Créez sur votre disque dur, ou vous le souhaitez, un dossier du  non de votre plugin. Sous Windows faites un clique droit sur le dossier que vous venez de créer, puis SVN Checkout. Là il va vous demander l’adresse du serveur. Entrez : http://svn.wp-plugins.org/[nom_de_votre_plugin]/, et il se synchronise. Il va donc vous récupérer les 3 sous-dossiers que vous avons plus haut. Pour Linux, il faut faire :

svn co http://svn.wp-plugins.org/facethumb facethumb

Remplacez facethumb par le nom de votre plugin. Ensuite il faut entre dans le dossier de votre plugin:

cd facethumb

Là (sous Windows et Linux) vous pouvez copier les fichiers que vous souhaitez dans les bons dossiers. Pour synchronisé vos modifications avec le serveur, vous devez, sous Windows faire clique droit sur le dossier puis SVN Commit… TortoiseSVN vous affichera les modification qu’il y a par rapport au serveur et vous pourrez les appliquer. Ce sera la même procédure à utiliser pour tagger les anciennes versions (les déplacer dans le dossier tags).

Pour Linux, la méthode est la même. Faîtes des copier-coller des fichiers dans les dossiers que vous souhaitez. Une fois que vous avez la bonne arborescence en local, vous pouvez la synchronisez :

svn ci -m 'update'

Subversion vous affichera le listing de ce qu’il fait et vous affichera un message de fin : Commited revision #. Pour tagger une version de votre plugin, copiez le contenu du trunk, et synchronisez-le :

svn cp trunk tags/1.0

svn ci -m "tagging new version"

Et voila, le serveur reflète parfaitement l’arborescence que vous avez en local.

Mots-clefs : debian, plugin, subversion, svn, tortoisesvn, windows, wordpress