SPIP
Article proposé
L’article « ** Utiliser les plugins**
(SPIP) » est proposé
à la publication depuis le mercredi 15 novembre 2023.
Utiliser les plugins
mercredi 15 novembre 2023 , par
cy_altern ,
erational ,
jack ,
Maïeul
Sommaire
- Qu’est ce qu’un plugin ?
- Organisation de plugins
- Utiliser SVP le gestionnaire des plugins de SPIP
- Gérer les dépôts
- Chercher et trouver le plugin
- Ajouter un plugin
- Mettre à jour un plugin
- Désactiver, Désinstaller et/ou Supprimer
- Méthodes alternatives pour gérer les plugins
- Ajouter un plugin manuellement via l’interface SVP
- Gestion des plugins par FTP
- Gestion des plugins par SPIP-Cli
- Créer son plugin
Qu’est ce qu’un plugin ?[|Retour au
sommaire](#s-Qu-est-ce-qu-un-plugin)
SPIP est fourni avec un nombre de fonctionnalités standard (le noyau ou
« core »).
Il arrive souvent qu’on ait besoin d’autres fonctionnalités comme par
exemple un agenda, une newsletter … Pour répondre à ces besoins
particuliers, SPIP dispose d’une système de plugins (parfois appelé
« extensions ») à travers une API normalisée qui permet de se brancher
(« plug » en anglais) au système pour y ajouter ou compléter des fonctions.
Organisation de plugins [|Retour au
sommaire](#s-Organisation-de-plugins)
Il existe deux types de plugins :
– Les plugins fournis par défaut dans SPIP
Ils sont placés dans le répertoire réservé ./plugins-dist/. Ces
« plugins-dist » sont verrouillés et il n’est pas possible de les
désinstaller. Ils sont mis à jour lors de chaque mise à jour de SPIP.
– Les plugins spécifiques au site
Ils sont placés à placer dans le répertoire ./plugins/
Si vous souhaitez pouvoir les installer et mettre à jour automatiquement,
il faudra créer un sous-répertoire ./plugins/auto/. (Ce
sous-répertoire est automatiquement créé si vous installez SPIP via le
spip-loader (SPIP))
Utiliser SVP le gestionnaire des plugins de SPIP[|Retour au
sommaire](#s-Utiliser-SVP-le-gestionnaire-des-plugins-de-SPIP)
SPIP dispose d’un système automatisé pour gérer les plugins qui
s’appelle SVP (acronyme de « SerVeur d’information et de
téléchargement des Plugins »).
Il permet de gérer et de mettre à jour au quotidien les plugins.
La gestion des plugins est réservée aux adminstrateurs-trices complet-es
du site.
L’ajout, la mise à jour et suppression des plugins sont restreints aux
webmestres.
Gérer les dépôts|Retour au sommaire
SVP va chercher les plugins disponibles dans un « dépôt ».
Lors de la première installation le webmestre doit installer le dépôt et
valider avec son mot de passe.
Par défaut le dépôt « principal » « SPIP-Zone - Plugins » est proposé.
Il est possible d’ajouter d’autres dépôts.
Certains dépôts sont listés sur
https://plugins.spip.net/spip.php?page=depots
Pour des raisons de sécurité, il est nécessaire de saisir son mot de
passe pour installer un nouveau dépôt.
Chercher et trouver le plugin[|Retour au
sommaire](#s-Chercher-et-trouver-le-plugin)
Il est possible de rechercher le plugin via l’interface de SVP, « ajouter
un plugin »
Il est peut être utile de rechercher le plugin adapté à votre besoin sur
le site dédié aux plugins SPIP : https://plugins.spip.net/
Ajouter un plugin|Retour au sommaire
Lorsque vous avez trouvé votre plugin, vous le sélectionnez et demandez
son installation « télécharger et installer » ; SVP va alors proposer
d’installer le plugin avec toutes les dépendances nécessaires à son
fonctionnement.
Une fois installés certains plugins proposent un bouton « Configurer » qui
permet d’ouvrir un formulaire de configuration.
Mettre à jour un plugin[|Retour au
sommaire](#s-Mettre-a-jour-un-plugin)
Un plugin comporte un numéro de version sous la forme x.y.z où
- z représente une correction mineure,
- y représente un ajout de fonctionnalités,
- x représente un changement majeur présentant des risques
d’incompatibilité.
Lorsqu’une mise à jour est disponible (et que l’installation a été
faite par SVP) une information s’affiche :
- Une mise à jour corrective est disponible (up de z)
- Une mise à jour fonctionnelle est disponible (up de y)
- Une mise à jour majeure est disponible (X.0.0). Pensez à vérifier
les incompatibilités. (up de x)
Désactiver, Désinstaller et/ou Supprimer[|Retour au
sommaire](#s-Desactiver-Desinstaller-et-ou-Supprimer)
Les webmestres ont plusieurs options pour retirer un plugin installé :
- **Désactiver : ** le plugin passe dans les plugins inactifs,
- **Désinstaller : ** supprime les données et les paramètres de
configuration du plugin, le plugin passe dans les plugins inactifs,
Lorsque le plugin est inactif il est maintenant possible de le :
- **Supprimer : ** supprime les fichiers du plugins, pas les données ;
- **Réactiver : ** si le plugin a été désactivé (et non
désinstallé) on retrouvera toutes les données et les paramètres.
NB :
– Par conséquent, pour retirer complètement un plugin et ses
données, il faut d’abord le désinstaller, puis le supprimer.
– Attention, ne pas oublier que désinstaller entraîne une perte de
données
Méthodes alternatives pour gérer les plugins[|Retour au
sommaire](#s-Methodes-alternatives-pour-gerer-les-plugins)
Ajouter un plugin manuellement via l’interface SVP[|Retour au
sommaire](#s-Ajouter-un-plugin-manuellement-via-l-interface-SVP)
Il est possible d’installer un plugin manuellement via l’interface SVP,
avec par exemple une version de zip récupérée sur git.spip.net.
Pour des raisons de sécurité il est nécessaire de saisir son mot de
passe webmestre lors de toute installation de plugin de cette manière.
Gestion des plugins par FTP[|Retour au
sommaire](#s-Gestion-des-plugins-par-FTP)
On peut déposer les plugins avec transférant par FTP les fichiers des
plugins dans le répertoire ./plugins/. Une fois déposé, il faudra
activer les plugins via SVP.
Attention, cette méthode ne permet pas de mettre à jour automatiquement
les plugins.
Gestion des plugins par SPIP-Cli[|Retour au
sommaire](#s-Gestion-des-plugins-par-SPIP-Cli)
SPIP-Cli permet de gérer un site en ligne de commande. Il existe plusieurs
commandes dédiées à la gestion des plugins. Pour en savoir plus se
reporter à la documentation officielle de SPIP-Cli
Créer son plugin|Retour au sommaire
Si vous ne trouvez le plugin correspondant à vos besoins, il est toujours
possible de le créer !
Pour apprendre à coder, vos propres plugins :
A noter : le plugin La fabrique permet de créer d’une façon simple
et rapide un plugin à partir de zéro
— Envoyé par SPIP (https://www.spip.net/)