Paroisse Saint Timothée en Forez Guide d`utilisation de SPIP

Paroisse Saint Timothée en Forez
Guide d'utilisation de SPIP
Table des matières
1 Création du site saint-timothee.fr en local.....................................2
1.1 Introduction..................................................................................................2
1.2 Sauvegarde de la base de données en local................................................2
1.3 Création de la base de données en local......................................................4
1.4 Sauvegarde de la structure SPIP en local.....................................................5
1.5 Exploiter le site en local...............................................................................5
2 Passage de Spip2 à Spip3 en local.................................................7
2.1 Procédures de mise à jour............................................................................7
2.2 Déplacement des anciens fichiers................................................................7
2.3 Installation de Spip3.....................................................................................7
2.4 Installation des plugins.................................................................................8
2.5 Récupération des fichiers de présentation du site d'origine.......................10
3 Passage de Spip2 à Spip3 sur le site distant................................11
3.1 Procédures de mise à jour..........................................................................11
3.2 Déplacement des anciens fichiers..............................................................11
3.3 Installation de Spip3...................................................................................11
3.4 Installation des plugins...............................................................................13
3.5 Récupération des fichiers de présentation du site d'origine.......................15
1 Création du site saint-timothee.fr en local
1.1 Introduction
Outils nécessaires :
• un serveur web local (wampserver, easyphp, xampp) contenant un
serveur http apache, un serveur mysql, un interpréteur de script PHP)
• un logiciel client FTP (Filezilla) pour le transfert des fichiers
• un dossier local accessible au serveur http qui contiendra les fichiers du
site web
Informations de connexion :
• OVH Manager :
• serveur mysql :
• serveur ftp :
1.2 Sauvegarde de la base de données en local
Connexion à OVH Manager « https://www.ovh.com/managerv3 » par
l’intermédiaire d'un navigateur internet.
Sélectionner « Hébergement » puis « saint-timothee.fr »
Sélectionner l'onglet « Bases de données »
puis le symbole de configuration (dernier bouton de la ligne « sainttimothee »
Puis le menu « Accéder à phpMyAdmin » pour administrer la base de données.
Il faut se connecter, avec les infos de login spécifiques à mysql. Dans la liste
déroulante « Version : », il est possible de choisir une version antérieure du
contenu de la base de données (hier et une semaine)
Après authentification, il n'y a qu'une seule base de données à administrer :
« sainttimothee ».
Sélectionner l'onglet « Exporter », puis la puce « Méthode d'exportation :
� Personnalisée »
Laisser l'option de « Sortie » sur « Diriger la sortie vers un fichier ... » et le
« Format » sur « SQL »
Cocher dans « Options de création d'objets », le choix « ☑ Ajouter un énoncé
CREATE DATABASE / USE »
puis « Exécuter »
Cette action génère un fichier « sainttimothee_mysql_db.sql » à sauvegarder
sur son disque.
Ce fichier contient toutes les instructions SQL pour reproduire la base de
données sur un autre serveur.
1.3 Création de la base de données en local
Après avoir lancer les différents serveurs (http, mysql) en local, il faut accéder
à la page d’administration du server mysql local par l'intermédiaire d'un
navigateur internet : « localhost/phpmyadmin »
Sélectionner l'onglet « Importer » puis le bouton « Parcourir ».
Sélectionner le fichier « sainttimothee_mysql_db.sql » généré à partir du
serveur mySQL d'origine et exécuter.
A l'issu du traitement (qui peut durer quelques minutes), une nouvelle base de
données contenant toutes les informations est maintenant présente.
1.4 Sauvegarde de la structure SPIP en local
Il s'agit de récupérer l'ensemble des fichiers constituant la structure SPIP du
site web.
Pour cela, il faut passer par une connexion FTP « ftp.saint-timothee.fr » avec les
bonnes infos de connexion, à l'aide par exemple de Filezilla.
Après l'établissement de la connexion, la structure du site distant est
disponible à droite.
Il faut transférer l'ensemble des fichiers distants dans un dossier accessible par
le serveur http local.
1.5 Exploiter le site en local
Pour pouvoir utiliser le site web en local, il faut faire quelques adaptations :
tout d'abord, indiquer dans le fichier « config/connect,php » les infos de
connexion à la base de données locale et non plus distante.
spip_connect_db('localhost','','root','','sainttimothee','mysql', 'sainttimothee','');
Pour le fonctionnement en local, il faut changer l'adresse URL de la racine du
site http://www.saint-timothee.fr → localhost/SaintTimothee, par exemple, pour
ne pas être redirigé vers le site distant (menu « Configuration », « Identité du
site », « Adresse URL »).
Si le site est en Spip2, beaucoup d'erreurs apparaissent sur des versions
récentes de PHP (notamment l'erreur « imagepalettetotruecolor » décrite
https://core.spip.net/projects/spip/repository/revisions/20656) et sont
fastidieuses, voire impossibles à corriger.
Il faut donc soit utiliser une version ancienne de PHP soit passer en spip 3.
2 Passage de Spip2 à Spip3 en local
2.1 Procédures de mise à jour
La procédure est décrite dans le lien suivant :
http://www.spip.net/fr_article5693.html
Il y a deux possibilités :
1. en utilisant une archive zip contenant l'ensemble des fichiers de SPIP3
2. en utilisant le fichier spip_loader.php pour la mise à jour
La seconde ne semblant pas toujours fonctionner correctement en local (droit
des dossiers sous linux, passage d'un éventuel proxy), voici la description de la
première procédure.
La version de Spip est SPIP 2.1.10 [17657] et l'encodage du site est en utf8.
La version de PHP de OVH est 5.3.29.
2.2 Déplacement des anciens fichiers
Dans le dossier local, sélectionner tout (y compris le dossier /plugins) SAUF
IMG, config, img,
et les déplacer dans un dossier « spip2 » par exemple
2.3 Installation de Spip3
Télécharger l'archive zip contenant spip3
Décomprimer l'archive dans le dossier local
Accéder à la gestion du site local : SaintTimothee/ecrire
Après connexion, un message technique de mise à jour apparaît :
Sélectionner le bouton « Mettre à jour la base de données »
Puis valider
L'invite de connexion apparaît de nouveau, et après authentification, la
procédure continue
Après validation, la partie privée est accessible.
2.4 Installation des plugins
Il faut maintenant récupérer les plugins
La méthode la plus simple est d'activer le dépôt proposé par défaut.
Après ajout du dépôt,
d'avertissement apparaît
sélectionner
l'onglet
« Plugins »,
un
message
Il faut créer les dossiers correspondants (dans le dossier local) afin que les
plugins puissent être installés
Ensuite, il suffit de rechercher les plugins souhaités par mots-clés
L’ensemble des plugins sélectionnés apparaît
•
•
•
•
Court-circuit : permet d’accéder directement à un article s'il est seul dans
sa rubrique
Menu déroulant : utilisé pour le menu « administratif » et le menu
« graphique »
Polyhierarchie : permet d'attacher un article à plusieurs rubriques
SPIP Bonux et Couteau suisse : ajout de nouvelles fonctionnalités
2.5 Récupération des fichiers de présentation du site d'origine
Pour que la présentation du site mis à jour corresponde à celle du site d'origine,
il faut reconstituer l'arborescence du dossier « squelettes » en récupérant
certains fichiers dans les dossiers « squelettes » et « squelettes-dist » de
l'ancien site.
3 Passage de Spip2 à Spip3 sur le site distant
3.1 Procédures de mise à jour
La procédure est décrite dans le lien suivant :
http://www.spip.net/fr_article5693.html
Il y a deux possibilités :
1. en utilisant une archive zip contenant l'ensemble des fichiers de SPIP3
2. en utilisant le fichier spip_loader.php pour la mise à jour
Voici la description de la seconde procédure.
La version de Spip est SPIP 2.1.10 [17657] et l'encodage du site est en utf8.
La version de PHP de OVH est 5.3.29.
3.2 Déplacement des anciens fichiers
A l'aide d'un client FTP (Filezilla), dans le dossier www, sélectionner tout (y
compris le dossier /plugins) SAUF
IMG, config, img,
et les déplacer dans un dossier « spip2 » à créer.
3.3 Installation de Spip3
Télécharger le script de mise à jour automatique spip_loader.php dans le
dossier www
Accéder à la gestion du site : www.saint-timothee.fr/spip_loader.php
Le téléchargement des fichiers de Spip3 commence immédiatement
A l'issu du téléchargement, l'invite de connexion apparaît
Puis une mise à niveau de la base de données est demandée
L'invite de connexion apparaît de nouveau
Puis la suite de la mise à jour de la base de données
Il est enfin possible d’accéder à la partie privée du site
3.4 Installation des plugins
Il faut maintenant récupérer les plugins. La méthode la plus simple est d'activer
le dépôt proposé par défaut.
Après ajout du dépôt,
d'avertissement apparaît
sélectionner
l'onglet
« Plugins »,
un
message
Il faut créer les dossiers correspondants (dans le dossier www avec FileZilla)
afin que les plugins puissent être installés
Ensuite, il suffit de rechercher les plugins souhaités par mots-clés
L’ensemble des plugins sélectionnés apparaît
•
•
•
•
Court-circuit : permet d’accéder directement à un article s'il est seul dans
sa rubrique
Menu déroulant : utilisé pour le menu « administratif » et le menu
« graphique »
Polyhierarchie : permet d'attacher un article à plusieurs rubriques
SPIP Bonux et Couteau suisse : ajout de nouvelles fonctionnalités
3.5 Récupération des fichiers de présentation du site d'origine
Pour que la présentation du site mis à jour corresponde à celle du site d'origine,
il faut reconstituer l'arborescence du dossier « squelettes » en récupérant
certains fichiers dans les dossiers « squelettes » et « squelettes-dist » de
l'ancien site.