Carnet Wiki

Comment distribuer ma super contrib dans SPIP ?

Version 6 — September 2012 — Luis Speciale

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

Mettre à disposition votre contribution

Le moins que vous puissiez faire pour mettre à disposition une contribution pour SPIP est de
-  rédiger son mode d’emploi
-  publier ce mode d’emploi sur le Web.

C’est la vocation initiale de SPIP-Contrib d’accueillir vos modes d’emplois, donc vos contributions y sont bienvenues ! Toutefois, vous pouvez aussi déposer votre contribution ailleurs sur le web, si vous le préférez, du moment que c’est sur un site pérenne.

1/ Fabriquer un truc

2/ Rédiger son mode d’emploi

Transformer cette contribution en plugin pour SPIP

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

Si ce n’est pas déjà le cas, vous ajoutez pour cela un fichier paquet.xml (ou plugin.xml si c’est pour SPIP2).

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
 [2]

Voyez :
-  [Rédaction des plugin.
xml->http://plugins.spip.net/redaction-des-plugin-xml.html]
- http://doc.spip.org/@Plugin-xml pour SPIP2
-  pour les plugins implémentant des squelettes, voyez [Plugins pour squelettes pour SPIP2->http://geekographie.
Pour les squelettes, on pourra voir les articles de Maïeul : http://geekographie.maieul.net/Jeux-de-squelettes-sous-forme-de-93 (pour SPIP2)] ou [Plugins pour squelettes (pour SPIP3)->http://geekographie.net/Jeux-de-squelettes-sous-forme-de-93 http://geekographie.maieul.net/Jeux-de-squelettes-sous-forme-de] 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.spip.N’oubliez pas net notamment , et avec un lien depuis le mode d’emploi : plugin , dans le fichier plugin .xml ou paquet .xml doit contenir un lien vers ce mode d’emploi.

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

Déposer le plugin via SVN sur la zone

- Avantage : la zone et SVN facilitent le travail collaboratif : d’autres peuvent corriger un bug, améliorer le plugin, le faire évoluer, le maintenir, le rendre compatible avec les nouvelles versions de spip

- Autre avantage : votre plugin disposera alors d’un paquet toujours à jour

_ 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 ou personnels ...

Voyez les explications Voir :
-  
Comment récupérer les sources mais aussi comment en ajouter
- sur le carnet wiki de contrib : [->http://contrib.spip.net/La-Zone-Facile] ou [->http://contrib.spip.net/Publier-son-projet-via-SVN] 4 / Déposer le truc via SVN sur la zone .

Générer 5 / Générer le zip

zip

Si vous avez déposé votre plugin sur la zone , il suffit de le déclarer je déclare mon truc dans le fichier archivelist.txt pour qu’ensuite un zip soit automatiquement généré. Le format de ce fichier est expliqué dans ses premières lignes. Le zip est généré dans l’heure qui suit._ ?  [3]

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

Le plugin Il est ensuite automatiquement présenté affiché dans la liste de files.spip.org ainsi que et sur le site officiel [plugins.spip.net->net" class='spip_url spip_out auto' rel='nofollow external'>http://plugins.spip.net] net ].
: ce sont les informations présentes dans le fichier ._ [4]

Par ailleurs, si le lien de documentation présente dans le XML pointe vers un article de spip-contrib, alors les motclés de compatibilité avec SPIP sont automatiquement mis à jour sur spip-contrib, à partir des informations de compatibilité également présentes dans le XML.

Le 6 / Le distribuer dans SPIP

SPIP

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

Il n’y a rien de spécial à faire pour ça : dés lors qu’il est référencé sur plugins.spip.net 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.