Comment mettre un nouveau plugin sur la zone de SPIP

Préambule

Le but ici n’est pas de vous expliquer comment réaliser un plugin mais comment déposer le plugin que vous avez créé au préalable.
Je vais prendre pour exemple le plugin "Partenaires" que j’ai créé par plus tard que ce matin.

Mise en place

Il faut d’abord créer un répertoire qui va réceptionner tous nos plugins en devenir. J’ai créer dans mon répertoire "Document" un dossier "svn_repositories" contenant la structure suivante :

• _galaxie_
• _graphismes_
• _plugins_
• _squelettes_
• _themes_
• archivelist

Cela prend dans les grandes lignes la structure des répertoires de la zone à voir ici. Cela permet d’être cohérent et de s’y retrouver plus facilement si on reprend le développement de plugins plusieurs semaines ou mois plus tard.

Étape 1

On va dans panneau de ligne de commande (Terminal sous MacOSX) pour commencer à taper nos commandes svn.
Première chose, se positionner dans le répertoire "Documents/svn_repositories/_plugins_" :

svn cd Documents/svn_repositories/_plugins_

Attention de bien rester dans ce répertoire pour pouvoir faire un "checkout". Cette dernière commande créera le répertoire de plugin venant de la zone…

Étape 2

On crée le répertoire de notre plugin sur la zone :

svn mkdir svn://zone.spip.org/spip-zone/_plugins_/partenaires/ -m "Dépôt initial du plugin Partenaires"

cf. 69939

Étape 03

On lance un checkout pour avoir une bonne version svn de notre répertoire :

svn checkout svn://zone.spip.org/spip-zone/_plugins_/partenaires/

Cela aura créé un répertoire "partenaires". Il faut se positionner depuis le Terminal dans ce répertoire pour en faire les commits plus tard :

cd partenaires

Maintenant, on copie dans notre répertoire local les répertoires et fichiers du plugin que nous avons créé. Pour ma part, avec "Partenaires", j’ai 2 répertoires contenant mes fichiers et sous-répertoires :

• branches
• trunk

Cela fait, on passe à l’étape 4.

Étape 04

On tape la commande suivante :

svn st

Cela nous indiquera ce qui est ajouté par rapport au répertoire de dépôt. Cela vous donnera quelque chose comme ça :

Le point d’interrogation indique que nous devons indiqué à svn ce que nous devons faire de ces répertoires. Eh bien, on va les ajouter un par un :

svn add branches
svn add trunk

Cela fait, on peut enfin passer à l’étape 5, l’étape finale.

Étape 05

On va enfin commiter nos fichiers sur la zone :

svn commit -m "Dépôt complet de plugin Partenaires qui permet de référencer la liste complète de nos partenaires et le type de partenaires (Exemple: officiel, fourniture, alimentaire, etc.)
On peut renseigner pour le partenaire les infos suivantes :
- Son nom ;
- Un descriptif ;
- et l'url de son site.
Pour le type de partenaires :
- Le titre ;
- un descriptif.
Ces 2 nouveaux objets éditoriaux peuvent avoir un logo. Pour le type de partenaire, en général, le logo n'est pas nécessaire mais je garde pour le moment cette possibilité.

La documentation est bientôt à venir sur Contrib."

cf. 69943

ET voilà, c’est fini.

Amusez vous à créer de nouveaux plugins pour la communauté SPIP. On vous sera reconnaissant ! ;-)