SPIP
Article validated
The article « ** Utiliser les plugins**
(Utiliser les plugins - SPIP) » was validated by jack.
Utiliser les plugins
Monday 4 December 2023 , by cy_altern
, erational ,
jack ,
Maïeul
Table of contents
- 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 ?[|Back to the table of
contents](#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’un 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 [|Back to the table of
contents](#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 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[|Back to the table of
contents](#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 administrateurs-trices complet-es
du site.
L’ajout, la mise à jour et suppression des plugins sont restreints aux
webmestres.
Gérer les dépôts|Back to the table of contents
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[|Back to the table of
contents](#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|Back to the table of contents
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[|Back to the table of
contents](#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[|Back to the table of
contents](#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[|Back to the table of
contents](#s-Methodes-alternatives-pour-gerer-les-plugins)
Ajouter un plugin manuellement via l’interface SVP[|Back to the table
of contents](#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[|Back to the table of
contents](#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[|Back to the table of
contents](#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|Back to the table of contents
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
— Sent by SPIP (https://www.spip.net/)