Carnet Wiki

Comment distribuer ma super contrib dans SPIP ?

Version 5 — August 2012 — jsb

Remarque : une fois cet article complété, il devra être déplacé dans les pages d’aide de plugins.spip.net.
 [1]

1/ Fabriquer un truc

2/ Rédiger son mode d’emploi

Et publier ça quelque part sur le Web : sur SPIP-Contrib dont c’est la vocation initiale ou n’importe où ailleurs.

Cela suffit pour distribuer ma super contrib. Mais ce n’est pas très pratique. Voici comment faire mieux encore :

3/ Transformer ce truc en plugin pour SPIP, en ajoutant un fichier plugin.xml (ou paquet.xml si c’est pour SPIP3 ou ?). Voir : Rédaction des plugin.xml
[spip . xml ou ? org/@Plugin-xml" class='spip_out' rel='external'>Attention aux bornes à * dans plugin.xml : parfois incompatible vieux SPIP2 ? Un lien vers une Doc plus “precise” que [ /YannX]]

Pour les squelettes, on pourra voir les articles de Maïeul : http://geekographie.maieul.net/Jeux-de-squelettes-sous-forme-de-93 http://geekographie.maieul.net/Jeux-de-squelettes-sous-forme-de

Ne pas oublier le mode d’emploi : soit en le laissant dans le plugin, soit en le publiant ailleurs, sur contrib avec un lien depuis le plugin .spip.net notamment, et avec un lien depuis le plugin, dans le fichier .xml.

Vous pouvez ensuite compresser ce plugin en paquet zip vous-même, pour le distribuer plus facilement. Ou le déposer sur la Zone de SPIP, qui est capable de générer des paquets toujours à jour.

4/ Déposer le truc via SVN sur la zone. Voir : Comment récupérer les sources mais aussi comment en ajouter

_ Avantage : facilite le travail collaboratif : d’autres peuvent corriger un bug, améliorer le plugin, etc.
_ Attention : nettoyez votre code, documentez-le, et éliminez les fichiers accessoires...

5/ Générer le zip

je déclare mon truc dans le fichier archivelist.txt
_ ?  [2]

Le zip est généré dans l’heure qui suit.

Il est ensuite affiché dans la liste de files.spip.org et sur le site officiel plugins.spip.net.
_ [3]

6/ Le distribuer dans SPIP

Il n’y a rien de spécial à faire pour ça

auparavant, mais désormais facultatif : publier un article sur contrib + y ajouter le zip en doc joint + coller le mot clé pour le chargeur =>
mon zip est dispo dans la page « ajouter des plugins » de l’espace privé dé spip