Premiers pas avec SPIP

Maintenant que nous avons vu comment mettre en place notre serveur SPIP et comment accéder a l'interface d'administration. La première chose sera de rajouter les différentes dépots au projet afin de pouvoir faciliter l'installation des dépendances de nos plugins.

NOTE: Un plugin SPIP est la jointure entre les scripts (PHP) et notre interface d'administration. Cela va par exemple nous etre utile notamment pour gérer notre site ou pour rajouter des comportement particulier, mais nous aurons le temps de voir ensemble des cas d'usages.

Pour cela, allez dans l'onglet "Configuration", puis "Gestion des plugins".

Cliquez sur "Dépôts" en haut a droite. Un premier dépôt est renseigné, vous n'aurez qu'a saisir le mot de passe (celui saisie pour vous connecté précédemment) et vous pouvez cliquer sur "Ajouter".

Il vous faudra certainement ajouter le dépôt SPIP-Core. Pour cela cliquez sur le lien "Liste des dépôts disponibles" situé au niveau de l'encadré a droite de "Fichier XML du dépôt". Accéssible également en cliquant ici.

Sur cette page copiez l'URL de SPIP-Zone - Core (https://files.spip.org/core/archives.xml).

Retournez ssur l'écran vu précédemment et collez l'URL, avec votre mot de passe pour ajoutez également ce dépôt.

Ajoutez également ce dépôt : https://repo.apps-ipeos.com/spip/liste.xml.

Vous devriez donc voir l'ensemble des dépôts que nous venont d'ajouter au dessus:

.

Au niveau de votre répertoire, la ou se trouve votre projet avec le fichier docker-compose.yaml, vous devriez avoir une structure de dossiers semblable a:

votre-projet/
├─ app/
│  ├─ config/
│  ├─ IMG/
│  ├─ lib/
│  ├─ local/
│  ├─ plugins/
│  │  ├─ auto/
│  ├─ squelettes/
│  ├─ tmp/
├─ mariadb/
├─ plugins_data/
docker-compose.yaml

Il nous faudra configurer les droits d'accès pour la suite.

D'abord se mettre les droits sur le dossier app/plugins:

sudo chown -R <votre nom d'utilisateur>: app/plugins 

IMPORTANT: Remplacez par votre nom d'utilisateur sur votre machine

Ensuite ddonnez les droits d'accès a www-data sur le dossier app/plugins/auto:

sudo chown -R www-data app/plugins/auto  

Bravo ! Votre projet est plutot bien préparez pour la suite.

Vous pouvez créer un plugin qui va vour servir a ochestrer vos templates et faciliter la maintenabilité de votre site.

...
plugins/
├─ auto/
├─ itemplate-<nom de votre projet>/

REMARQUE: itemplate-... est le nommage généralement employé pour un plugin de gestion du template propre au site, mais afin de faciliter la suite, nous appelerons ce dossier monplugin afin que se oit plus générale aux différentes cas d'uasages que l'on peut avoir.

Nous allons ajouter dans ce dossier d'autres éléments, afin d'indiquer a SPIP qu'il s'agit bien d'un plugin. Ajoutez les éléments suivants, afin d'avoir la même arborescence:

...
monplugin/
├─ lang/
├─ paquet.xml

Nous verrons ensuite en détail comment fonctionne un plugin.