SPIP est le système de publication développé par le minirézo pour la gestion du site uZine. Nous le livrons à chacun, sous licence de logiciel libre (GPL). Vous pouvez donc l’utiliser librement pour votre propre site, qu’il soit personnel, associatif, institutionnel ou marchand.

Comment installer SPIP ?

L’installation de SPIP est très simple : il n’y a pas, en particulier, de fichier à modifier « à la main » avec des variables ésotériques. La procédure est très simple (elle est détaillée ci-après) :

image 400 x 400

1. Récupérez le fichier de SPIP sur notre serveur, et le décompacter sur votre ordinateur personnel. Vous obtenez un dossier « SPIP… » contenant l’ensemble des fichiers du système SPIP.

2. Installez le contenu de ce dossier sur votre site (par FTP, comme vous le faites habituellement pour installer vos pages sur votre site).

3. Connectez-vous avec votre navigateur sur votre site, dans un dossier intitulé « ecrire », où SPIP vous proposera une interface graphique vous permettant de configurer le système. Une fois ces quelques informations de configuration fournies, SPIP sera totalement installé et vous pourrez commencer à travailler sur votre site.

Configuration nécessaire

Vous devez disposer d’un hébergement Web avec :
— un accès FTP pour l’installation des fichiers ;
— le support de PHP ;

Historique Les versions de Spip antérieur à [SPIP 1.9] doivent supporter PHP3

— un accès à une base de données MySQL.

Avant l’installation, vous devez avoir une base mySQL disponible. Sur de très nombreux hébergements, il faut soit demander l’activation d’une base mySQL à l’administrateur, soit suivre une procédure automatique en ligne (dans tous les cas, l’activation de la base mySQL n’a rien à voir avec SPIP ; si vous avez des difficultés, seul votre hébergeur peut vous fournir les mots de passe nécessaire et vous expliquer comment activer votre compte mySQL).

Vous devez connaître les données de votre connexion MySQL (fournies par l’hébergeur) :
— l’adresse de la base MySQL : par exemple sql.free.fr, ou localhost, ou vide ;
— votre login MySQL : souvent le même login que votre compte Web ;
— votre password MySQL : souvent le même que le compte Web ;

Lors de l’installation, une fois ces informations indiquées, il faudra aussi préciser :
— le nom de la base de données : souvent le même login que votre compte Web - il est possible que le serveur vous offre la possibilité de créer vous même cette base.

Exemple : si vous disposez d’un compte nommé « monsite » chez Free (adresse http://monsite.free.fr), l’adresse de la base mySQL est « sql.free.fr », le nom de la base de données est « monsite », votre login est « monsite » et le mot de passe est celui de votre compte. Il vous suffit d’activer votre base de données pour php

Ces éléments sont indispensables : si vous ne les connaissez pas, contactez votre hébergeur et demandez-lui de vous les rappeler.

Aucune configuration spéciale n’est nécessaire sur votre ordinateur personnel, SPIP se gère entièrement sur le Web. Tout ce dont vous avez besoin, c’est d’un navigateur Web (n’importe lequel), et d’un logiciel de transfert FTP pour installer les fichiers sur votre compte.

Installation automatique (« spip_loader »)

Il existe pour SPIP une procédure d’installation ultra-simplifiée : un fichier à télécharger sur votre serveur et ça s’installe. Attention : cette procédure ne fonctionne pas sur tous les serveurs. Si elle ne fonctionne pas (vous vous en rendrez compte immédiatement), passez à l’étape 1 ci-dessous.

Récupérez le fichier spip_loader.php à l’adresse ci-dessous (si le fichier s’affiche dans votre navigateur, faites « Enregistrer sous… ») :
— http://rezo.net/spip-dev/INSTALL

et téléchargez-le tel quel sur votre serveur (chez votre hébergeur) par FTP. « Visitez » cette page avec votre butineur Web habituel (à l’adresse du style : http://www.moncompte.com/spip_loader.php) et suivez la procédure indiquée.

Si la procédure fonctionne, ce petit fichier va récupérer SPIP sur notre propre serveur et l’installer chez votre hébergeur. Ensuite la procédure de configuration démarre automatiquement (étape 3 ci-dessous).

1. Récupérer SPIP

SPIP est disponible en téléchargement par le Web à l’adresse : Télécharger SPIP.

Dans ce dossier vous trouverez :
— un fichier spip.zip : il s’agit de la version complète de SPIP, comprenant toutes les traductions existantes ;
— un sous-dossier où sont déposées les versions monolingues de SPIP (identifiées par le code de la langue en deux ou trois lettres) ; celles-ci peuvent être utiles pour minimiser l’espace d’hébergement occupé et/ou le temps de téléchargement.

Choisissez la version qui vous intéresse, décompactez l’archive sur votre ordinateur dans un répertoire de votre choix, puis transférez le contenu de ce répertoire chez votre hébergeur via FTP.

2. Installer les fichiers

Installez l’ensemble des fichiers de SPIP sur votre site, à l’endroit où vous voulez que le site géré par le système soit accessible au public : le plus souvent à la racine de votre site, mais ce n’est pas impératif.

À titre d’information, la structure est la suivante :

  • répertoire racine
    • index.php
    • spip.php
    • htaccess.txt (à renommer en .htaccess pour le support des urls propres)
    • INSTALL.txt et UPGRADE.txt (à lire)
    • inc-public.php3 (pour support des anciens squelettes)
    • dossier /CACHE (vide)
    • dossier /IMG
    • dossier /dist (ne pas supprimer !)
    • dossier /formulaires
    • dossier /oo (pour l’affichage en texte seulement)
    • dossier /ecrire (le plus important)
      • fichier inc_connect.php
      • dossier /AIDE
      • dossier /inc
      • dossier /img_pack
      • dossier /data (vide)
      • dossier /lang
      • dossier /upload (vide)

Historique : Dans les versions précédente à SPIP 1.9, la structure était :

  • répertoire racine
    • squelettes .html
    • nombreux fichiers .php3
    • dossier /CACHE (vide)
    • dossier /IMG
    • dossier /NAVPICS
    • dossier /ecrire (le plus important)
      • nombreux fichiers .php3
      • dossier /AIDE
      • dossier /img_pack
      • dossier /data (vide)
      • dossier /lang
      • dossier /upload (vide)

3. Procédure de configuration

Désormais tout se déroule en ligne. Il vous suffit d’aller « visiter » votre dossier « /ecrire » par le Web.

Exemple : selon notre exemple précédent, il s’agirait de l’adresse http://monsite.free.fr/ecrire.

Lors de la première connection à cette adresse, une procédure d’installation pas-à-pas démarre. L’interface est très simple, il suffit d’entrer les informations demandées (essentiellement les informations concernant la base de données mySQL indiquées au début). Une fois que c’est terminé, le système vous demande l’identification que vous avez indiquée et vous pouvez commencer à gérer votre site. Par la suite, c’est toujours dans ce dossier « /ecrire » que vous irez travailler, muni de vos codes d’identification.

À chaque étape de la procédure d’installation, vous trouverez un lien vers l’aide (comme ceci : ), qui provoque l’affichage d’une aide en ligne expliquant chaque détail de l’utilisation de SPIP. (La seule opération un peu complexe apparaît sur certains serveurs : il vous faudra peut-être modifier les « droits d’accès » de certains dossiers ; l’opération n’est pas bien méchante, et l’aide en ligne vous fournit tous les détails nécessaires.)

Si tout s’est bien déroulé jusqu’ici, la procédure d’installation est terminée, et vous pouvez créer et gérer votre site sans aucune autre manipulation ésotérique…

En cas de grosse erreur (du genre : vous avez oublié votre propre accès au site - fréquent au début…), pour « relancer » cette procédure d’installation, il faut utiliser votre logiciel FTP et effacer les fichiers suivants :
— /ecrire/inc-connect.php3
— /ecrire/.htaccess (s’il existe)

La connexion suivante dans le dossier « ecrire » relancera alors la procédure de configuration (en réalité, c’est l’absence de fichier « inc-connect.php3 » qui provoque le lancement de cette procédure).