L’installation de la distribution MediaSPIP se fait en plusieurs étapes :
- la récupération des fichiers nécessaires. À ce moment là deux méthodes sont possibles :
- en installant l’archive ZIP contenant l’ensemble de la distribution ;
- via SVN en récupérant les sources de chaque modules séparément ;
- la préconfiguration ;
- l’installation définitive ;
[mediaspip_zip]
Installation de l’archive ZIP de MediaSPIP
Ce mode d’installation est la méthode la plus simple afin d’installer l’ensemble de la distribution MediaSPIP.
Un fichier zip est généré automatiquement à intervalle régulier contenant l’ensemble de la distribution (SPIP + extensions + plugins + thèmes) à jour.
[mediaspip_svn]
Installation via SVN
L’installation via SVN est manuelle, longue et périlleuse car il est important de ne pas oublier certaines extensions. Cependant elle permet de mettre à jour facilement et rapidement l’ensemble de MediaSPIP.
Dans un premier temps nous allons récupérer les sources de SPIP dans sa dernière version stable à savoir la version 2.1 avec la commande :
- svn co svn://trac.rezo.net/spip/branches/spip-2.1 ./
Récupération des extensions obligatoires
Après la récupération des sources de SPIP nous allons récupérer les sources de chaque extensions en prenant soin d’être dans le bon répertoire :
- cd extensions
- svn co svn://zone.spip.org/spip-zone/_plugins_/afficher_objet
- svn co svn://zone.spip.org/spip-zone/_plugins_/ajaxforms
- svn co svn://zone.spip.org/spip-zone/_plugins_/auteurs_syndic
- svn co svn://zone.spip.org/spip-zone/_plugins_/cfg2/extensions/compat cfg2_compat
- svn co svn://zone.spip.org/spip-zone/_plugins_/cfg2/core cfg2_core
- svn co svn://zone.spip.org/spip-zone/_plugins_/cfg2/extensions/interface cfg2_interface
- svn co svn://zone.spip.org/spip-zone/_plugins_/contact
- svn co svn://zone.spip.org/spip-zone/_plugins_/crayons
- svn co http://svn.aires-de-confluxence.info/svn/plugins_spip/diogene
- svn co http://svn.aires-de-confluxence.info/svn/plugins_spip/diogene_complements/diogene_gerer_auteurs
- svn co svn://zone.spip.org/spip-zone/_plugins_/doc2img
- svn co http://svn.aires-de-confluxence.info/svn/plugins_spip/import_video/emballe_medias
- svn co http://svn.aires-de-confluxence.info/svn/plugins_spip/import_video/emballe_medias_spipmotion
- svn co svn://zone.spip.org/spip-zone/_plugins_/facteur
- svn co svn://zone.spip.org/spip-zone/_plugins_/fonctions_images
- svn co svn://zone.spip.org/spip-zone/_core_/branches/spip-2.1/plugins/forum
- svn co svn://zone.spip.org/spip-zone/_plugins_/getID3
- svn http://svn.aires-de-confluxence.info/svn/plugins_spip/html5
- svn co svn://zone.spip.org/spip-zone/_plugins_/job_queue
- svn co svn://zone.spip.org/spip-zone/_plugins_/jquery_ui
- svn co http://svn.aires-de-confluxence.info/svn/squelettes_spip/mediaspip_config
- svn co http://svn.aires-de-confluxence.info/svn/MediaSPIP/plugins/mediaspip_core
- svn co http://svn.aires-de-confluxence.info/svn/MediaSPIP/plugins/mediaspip_init
- svn co svn://zone.spip.org/spip-zone/_plugins_/menus
- svn co svn://zone.spip.org/spip-zone/_plugins_/nospam
- svn co svn://zone.spip.org/spip-zone/_plugins_/palette
- svn co svn://zone.spip.org/spip-zone/_plugins_/pcltar
- svn co svn://zone.spip.org/spip-zone/_plugins_/saisies
- svn co svn://zone.spip.org/spip-zone/_plugins_/spip-bonux-2
- svn co svn://zone.spip.org/spip-zone/_plugins_/spipmotion
- svn co svn://zone.spip.org/spip-zone/_plugins_/step
- svn co http://svn.aires-de-confluxence.info/svn/plugins_spip/swfupload
- svn co svn://zone.spip.org/spip-zone/_squelettes_/zpip
Vous pouvez vous arrêter à cette étape pour la version minimale. Cependant plusieurs autres plugins sont également compatibles avec MediaSPIP et permettent d’augmenter ses fonctionnalités. La liste de ces plugins en question est définie ici. La méthode suivante décrit comment les installer.
Dans un premier temps il est nécessaire de créer le répertoire plugins
qui n’est pas créé par défaut lors de la récupération de SPIP, puis nous nous rendons dans ce nouveau répertoire :
- cd ..
- mkdir plugins
- cd plugins
Puis comme pour les extensions, nous allons récupérer chaque plugin compatible les uns après les autres. Comme ces plugins ne sont pas nécessaires, vous pouvez choisir ceux que vous souhaitez mettre à disposition [1]. On réalisera cette action comme ceci :
- svn co svn://zone.spip.org/spip-zone/_plugins_/ancres_douces
- svn co svn://zone.spip.org/spip-zone/_plugins_/bigbrother
- svn co svn://zone.spip.org/spip-zone/_plugins_/champs_extras2/core cextras2
- svn co svn://zone.spip.org/spip-zone/_plugins_/champs_extras2/extensions/interface cextras2_interface
- svn co svn://zone.spip.org/spip-zone/_plugins_/criteres_suivant_precedent
- svn co http://svn.aires-de-confluxence.info/svn/plugins_spip/diogene_complements/diogene_geo
- svn co http://svn.aires-de-confluxence.info/svn/plugins_spip/diogene_complements/diogene_licence
- svn co http://svn.aires-de-confluxence.info/svn/plugins_spip/diogene_complements/diogene_spipicious
- svn co svn://zone.spip.org/spip-zone/_plugins_/fulltext
- svn co http://svn.kupaia.fr/svn/plugins/gis2
- svn co svn://zone.spip.org/spip-zone/_plugins_/google_analytics
- svn co svn://zone.spip.org/spip-zone/_plugins_/gravatar
- svn co http://svn.aires-de-confluxence.info/svn/plugins_spip/inscription3
- svn co svn://zone.spip.org/spip-zone/_plugins_/legendes
- svn co svn://zone.spip.org/spip-zone/_plugins_/licence
- svn co svn://zone.spip.org/spip-zone/_plugins_/mediabox
- svn co svn://zone.spip.org/spip-zone/_plugins_/metadonnees_photo
- svn co svn://zone.spip.org/spip-zone/_plugins_/microblog
- svn co svn://zone.spip.org/spip-zone/_plugins_/multilang
- svn co svn://zone.spip.org/spip-zone/_plugins_/notation
- svn co svn://zone.spip.org/spip-zone/_plugins_/notifications
- svn co svn://zone.spip.org/spip-zone/_plugins_/nuage
- svn co svn://zone.spip.org/spip-zone/_plugins_/authentification/openid
- svn co svn://zone.spip.org/spip-zone/_plugins_/opensearch
- svn co svn://zone.spip.org/spip-zone/_plugins_/pages
- svn co http://svn.aires-de-confluxence.info/svn/plugins_spip/podcast
- svn co svn://zone.spip.org/spip-zone/_plugins_/polyhierarchie
- svn co http://svn.aires-de-confluxence.info/svn/plugins_spip/porte_plume_documents
- svn co svn://zone.spip.org/spip-zone/_plugins_/recommander
- svn co svn://zone.spip.org/spip-zone/_plugins_/saveauto/2.1 saveauto
- svn co svn://zone.spip.org/spip-zone/_plugins_/selecteur_generique
- svn co svn://zone.spip.org/spip-zone/_plugins_/socialtags
- svn co svn://zone.spip.org/spip-zone/_plugins_/sparkstats
- svn co svn://zone.spip.org/spip-zone/_plugins_/spipicious_jquery
- svn co svn://zone.spip.org/spip-zone/_plugins_/spip_piwik/spip_piwik_2_0 spip_piwik
- svn co svn://zone.spip.org/spip-zone/_plugins_/verifier
- svn co svn://zone.spip.org/spip-zone/_plugins_/zen-garden
- svn co svn://zone.spip.org/spip-zone/_plugins_/zeroclipboard
Préconfiguration
Création du répertoire lib
MediaSPIP installe par défaut de nombreux plugins, qui eux mêmes nécessitent de nombreuses librairies disséminées sur le web. Afin de pouvoir récupérer ces librairies, les décompresser et pouvoir les utiliser, SPIP nécessite un répertoire lib
à sa racine. Il est donc nécessaire de le créer manuellement.
Cela peut se faire via un client FTP quelconque où si vous avez accès à la machine, a la racine du répertoire contenant les fichiers de SPIP et MediaSPIP :
- mkdir lib
Modification des droits des répertoires
SPIP a besoin de pouvoir écrire dans certains répertoires (pour sa configuration, ses logs, ses fichiers de cache et les documents mis en ligne par les utilisateurs...), pour ce faire il est nécessaire de changer les droit de ces répertoires, 755
semble le plus conventionnel. On lancera donc les commandes suivantes à la racine du répertoire contenant les fichiers de SPIP et MediaSPIP :
- chmod 755 config
- chmod 755 IMG
- chmod 755 local
- chmod 755 tmp
- chmod 755 lib
Il ne faut pas oublier également que le serveur Apache doit pouvoir accéder et exécuter ces fichiers. Il est donc important de modifier l’utilisateur et le groupe d’utilisation des fichiers de SPIP et de MediaSPIP. Sur Debian, Apache a comme utilisateur www-data
et comme groupe www-data
mais cela peut être différent sous d’autres distributions Linux (sur centos par exemple, Apache a comme utilisateur apache
et comme groupe apache
).
Pour réaliser cette opération, en étant à la racine du répertoire, on lancera la commande :
- chown -Rvf www-data:www-data *
Installation du htaccess
Il vous faut ensuite copier le fichier htaccess.txt
fournit par SPIP en le renommant .htaccess
. Ce fichier permet notamment de :
- gérer les réécritures d’URL (propres, arborescentes...) ;
- d’avoir à disposition, sans autre action, un fichier
favicon.ico
(cf : Favicon) ; - d’avoir à disposition, sans autre action, un fichier
robots.txt
(cf : Robots.txt) ; - d’avoir à disposition, sans autre action, un fichier
sitemap.xml
(cf : Site map) ;
Installation finale
Lorsque les fichiers sont placés sur le serveur et que votre virtualhost
d’Apache pointe sur le bon répertoire, vous pouvez dorénavant lancer l’installation définitive de SPIP et MediaSPIP en vous rendant à l’adresse : http://votre.domaine.ext/ecrire/
.
L’installation se fait en quatre étapes :
- le choix de la langue ;
- donner les informations de la base de donnée à utiliser ;
- donner les informations du premier utilisateur ;
- installation des extensions ;
Lors de la dernière étape, il vous sera demandé de télécharger les librairies externes obligatoires une à une afin de terminer l’installation des extensions.