Le Pic

Installer des plugins

manu — 2014-11-07T22:14:16Z

Qu'est-ce qu'un plugin ?

Un plugin c'est comme une option lorsque vous achetez une nouvelle voiture : un petit truc bien sympa qui apporte une nouvelle fonctionnalité, et dont vous ne sauriez vous passer.
Avec SPIP, un plugin est un petit peu de code informatique qui procure une fonctionnalité non prévue nativement dans notre CMS préféré. Un plugin peut s'installer à tout moment.

Beaucoup ou peu de plugins ?

La règle d'or est : installez le moins de plugins possible ! Si vous en avez besoin n'hésitez pas à installer un plugin, mais seulement si vous en avez besoin !
Sachez que les plugins risquent de vous compliquer la vie lors des mises à jour, alors moins il y en a mieux on se porte ! Sauf que parfois on en a besoin...

Qui peut installer les plugins ?

Seuls les utilisateurs ayant les droits Administrateur et Webmestre (les "super-administrateurs" donc) peuvent installer (ou supprimer) les plugins.

Comment faire ?

Tout d'abord le répertoire plugins/auto doit être créé, et auto doit avoir les droits d'écriture pour le groupe (si vous ne comprenez pas ce que cela veut dites-le nous, nous le ferons pour vous)
Cliquez alors sur Configuration/Gestion des plugins
Cliquez sur Ajouter des plugins/Dépôts
Ajoutez au moins (le plus souvent c'est d'ailleurs suffisant) le dépôt SPIP-Zone
Cliquez alors sur Plugins, et vous pourrez rechercher, puis installer, de nouveaux plugins. Après l'installation, il faut activer les plugins pour les rendre fonctionnels. Certains nécessitent en plus une configuration pour être opérationnels : dans la liste des plugins actifs leurs noms apparaissent suivis du logo de configuration.

Mise à jour des plugins

Il faut de temps en temps regarder la liste de vos plugins, et voir si SPIP ne vous propose pas une mise à jour : si oui faites-la, elle corrigera sans doute quelques bogues.

Voir en ligne : Les plugins de spip

Publier son site SPIP local

Jean-Pierre — 2013-11-13T16:15:36Z

Avoir un site SPIP local sur son ordinateur est commode lors de la construction d'un nouveau site, avant de le publier.
Si le site de production existe déjà, cela permet d'éviter à l'internaute de subir les dysfonctionnements consécutifs à une mise à jour majeure de SPIP ou à la mise à jour de plugins ou à des modifications importantes du squelette. Le fonctionnement est d'abord assuré en local avant la mise en ligne...

Prérequis :

disposer d'un compte d'administrateur du site SPIP local avec les droits de webmestre,
avoir les données d'accès FTP (URL, login et password)
avoir les données d'accès PHPMyAdmin à la base de données (URL ou localhost ; login et password)

Précaution :

Faire une sauvegarde du site de production au cas où il y aurait besoin de faire marche arrière.

Remarque importante :

Lorsqu'une importation de la base de données locale a été faite sur le serveur de production, la connexion à l'espace privé de ce dernier se fait avec le login et le mot de passe du site local...

Mise en œuvre d'une MAJ majeure :

Se reporter à l'article Mises à jour majeures
Attention : Un certain temps risque de s'être écoulé entre la sauvegarde initiale du site publié et la mise au point de la mise à jour majeure sur votre machine. Dans cet intervalle, les nouveaux articles introduits en ligne seront absents de votre ordinateur...
Ceci peut être résolu en déroulant sur le site en ligne toute la démarche effectuée avec succès sur la machine locale.

Première installation au PIC :

Utiliser l'éditeur de texte de votre choix (type Notepad++ sous Windows ou similaire sur Linux), et éditer le fichier www/monsite/config/connect.php.
Nota : Pour pouvoir continuer à utiliser le site local après sa publication, sauvegarder d'abord ce fichier sous www/monsite/save-config/connect.php afin de garder son contenu d'origine, puis ré-ouvrir le fichier www/monsite/config/connect.php.
Repérer une ligne qui ressemble à celle-ci :
spip_connect_db('localhost','','monsite','mon-mot-de-passe', 'ma_base_de_donnees', 'mysql', 'spip','');
Remplacer les mots placés entre quotes par les données de connexion à la base MySQL fournies par le PIC :
1. monsite par le nom d'utilisateur (typiquement monsite-v1)
2. mon-mot-de-passe par le mot de passe d'accès à la base
3. ma_base_de_donnees par le nom de la base de données (typiquement monsite_v1).
Sauvegarder et fermer ce fichier.
Se connecter par FTP avec les identifiants fournis par le PIC et transférer (avec FileZilla ou similaire) tous les fichiers (plus de 1000, cela prend du temps...) situés sous la racine du site local (typiquement www/monsite) vers la racine du futur site de production (répertoire /).
Sauvegarder la base de données locale au format .sql avec PHPMyAdmin :
1. Se connecter sur http://127.0.0.1/phpmyadmin,
2. Sélectionner le nom de la base (volet de gauche) cliquer sur Exporter,
3. Sélectionner le format SQL (par défaut),
4. Cliquer sur Exécuter.
  La fenêtre qui s'ouvre ensuite indique le nom attribué par défaut au fichier (nom_base.sql). Sélectionner le mode Ouvrir avec en spécifiant l'éditeur de texte de votre choix (type Notepad++ ou similaire).
  Rechercher avec l'éditeur de texte la table spip_meta puis repérer le champ adresse_site qui se présente sous la forme suivante :
  ('adresse_site', 'http://127.0.0.1/monsite', 'non', '2013-09-25 08:52:06'),
  Il faut remplacer, en respectant bien la syntaxe, l'URL du site local par l'URL du site de production (du style 'http://monsite.le-pic.org').
  Enregistrer le fichier de sauvegarde ainsi modifié.
Créer la base de données sur le serveur de production avec PHPMyAdmin :
1. Se connecter sur http://services.le-pic.org/phpmyadmin/ avec le nom d'utilisateur et le mot de passe qui vous ont été fournis par le PIC.
2. Cliquer sur "Bases de données" et créer la base de données de nom monsite_v1 (spécifié par le PIC) et d'interclassement utf8_general_ci
3. Cliquer sur Exécuter
Importer la sauvegarde nom_base.sql dans la base de données nouvellement créée, toujours avec PHPMyAdmin :
1. Cliquer sur Importer.
2. Cliquer sur le bouton Parcourir pour rechercher sur votre ordinateur le fichier de sauvegarde ; le sélectionner ensuite.
3. Cliquer sur Exécuter
Vérifier l'activation de vos plugins :
Aller dans la partie privée du site de production dans l'onglet Configuration puis cliquer sur Gestion des plugins.
Vérifier que tous vos plugins (y compris les non verrouillés) sont bien activés. Procéder à l'activation des plugins restés inactifs (un simple clic dans la case située derrière le nom de chaque plugin).

En fin d'opération, toutes les caractéristiques du site local (URL exceptée bien sur) seront reproduites à l'identique sur le site de production.

Nota : Pour rendre le site local utilisable, supprimer son fichier www/monsite/config/connect.php puis renommer www/monsite/save-config/connect.php en www/monsite/config/connect.php

Copier son site SPIP

manu — 2013-11-01T15:07:32Z

Pourquoi copier mon site ?

Plusieurs raisons peuvent vous conduire à disposer d'une copie d'un site SPIP opérationnel :

Vous souhaitez changer d'hébergeur.
Vous avez mis au point votre site sur votre PC, en ayant installé SPIP sur celui-ci en suivant ces conseils pour une machine Windows, ou ceux-ci pour une machine Linux, et maintenant vous voulez le mettre en ligne sans tout reprendre à zéro.
Vous avez un site sous SPIP hébergé au PIC (ou ailleurs), et vous souhaitez en faire une copie chez vous, histoire de bricoler tranquillement le squelette ou expérimenter les plugins sans risquer de tout casser.
Vous souhaitez faire une mise à jour majeure de votre site, comme expliqué sur cet article et vous préférez l'expérimenter d'abord sur votre ordinateur.

Prérequis

Être webmestre du site à copier.
Posséder les droits d'accès et de modifications d'accès suffisants sur les répertoires de la machine "source" (émettrice) et ceux de la machine "cible" (réceptrice).
Posséder les droits suffisants sur la machine source pour exporter la base de données Mysql du site.
Posséder les droits suffisants sur la machine cible pour créer une base de données Mysql et un utilisateur ayant tous les droits sur cette base.
Avoir l'usage d'un outil de transfert de fichiers (par exemple Filezilla décrit ici).

Opérations de transfert

Sur le site à copier : vider le cache
Sur la machine source aller dans le répertoire contenant le source SPIP du site à transférer
Sur la machine cible créer un répertoire "mon_site"
Transférer tous les fichiers SPIP du site à copier dans le répertoire ainsi créé à l'aide de l'outil de transfert choisi.
- Attention un site même de taille modeste peut contenir plus de 1000 fichiers. Le transfert peut durer un certain temps !!
- Attention : se souvenir du mot de passe utilisé pour avoir accès aux fichiers, il sera réutilisé dans la nouvelle base.
Sur la machine source : aller dans PhpMyAdmin et exporter la totalité de la base de données du site à transférer. Utiliser le format SQL. Enregistrer sur la machine cible le fichier .sql ainsi créé. (mon_site.sql)
Sur la machine cible, à l'aide de PhpMyAdmin créer une base de données mon_site (interclassement utf8_general_ci). Créer un utilisateur nom_user qui a tous les droits sur cette base. Le mot de passe sera celui utilisé pour accéder aux répertoires de la machine source.
Sur la machine cible donner des droits d'accès 770 aux répertoires config, local, IMG et tmp.
Sur la machine cible vérifier que le fichier config/connect.php contient bien une ligne
spip_connect_db('localhost','','nom_user','mdp','mon_site','mysql','spip','');

En principe, le site est prêt à fonctionner sur la nouvelle machine.

Mettre à jour son site SPIP : mises à jour majeures

manu — 2013-10-22T09:16:40Z

Qu'est-ce qu'une mise à jour majeure ?

Faire une mise à jour majeure signifie passer par exemple de la version 2.1.x à la version 3.0.x. Il y a actuellement trois versions de SPIP maintenues (on dit trois "branches") : la 2.0.x, la 2.1..x, et la 3.0.x. Contrairement à une mise à jour mineure, détaillée dans cet article, la mise à jour majeure concerne le passage dans une autre branche ; ce n'est pas beaucoup plus compliqué dans le principe, mais il y a beaucoup moins de garanties de bon fonctionnement. Il sera donc nécessaire de vérifier que tout est correct sur le site à la fin de l'opération et de prendre des précautions importantes, au cas où tout ne fonctionnerait pas et où il y aurait un peu de travail pour tout remettre d'équerre.

Est-ce important et urgent de mettre mon site à jour ?

Oui, c'est important, mais ce n'est pas encore (automne 2013) urgent : [1]
Tant que la branche que vous utilisez est maintenue, les mises à jour mineures sont suffisantes. Mais un jour, l'équipe de développement de SPIP va décider de cesser de maintenir les branches les plus anciennes : les bogues ne seront plus corrigés, ce qui peut être très ennuyeux lorsqu'il s'agit de bogues de sécurité. Ceux-ci vont demeurer, votre site restera vulnérable ; dès lors, la mise à jour majeure sera urgente ! Il est donc préférable de la préparer sereinement avant qu'elle ne soit impérative, plutôt que d'agir dans la précipitation...

Ce qui suit évoque le cas (Septembre 2013) d'une mise à jour d'un site sous 2.1.x vers 3.0.x. [2]

Prérequis :

disposer d'un compte d'administrateur du site SPIP avec les droits de webmestre,
avoir les données d'accès FTP (URL, login et password)
avoir les données d'accès PHPMyadmin à la base de données (URL ou localhost ; login et password)

Les grandes étapes de la mise à jour majeure

D'abord une sauvegarde !
Comme toujours avant de faire des choses importantes, commencez par sauvegarder votre site.

Installer un site de test de la mise à jour majeure :
Vous aurez besoin de tester votre site de manière approfondie avant de conclure que tout est correct après le passage à la version finale. Il faudra installer à cette fin un site de test avec SPIP dans la version actuelle du site en ligne, puis les données de personnalisation (le répertoire squelettes s'il existe, les répertoires plugins et IMG), et enfin la base de données, le tout issu du site public. La mise au point se fera sans inconvénient à partir de cette copie fidèle du site initial.
Deux possibilités :
1. Installer le site sur votre machine personnelle : Voir ici pour Windows ou là pour Linux.
2. Demander au PIC (picca@le-pic.org) de vous ouvrir un site de test en ligne : Après installation, mise à jour majeure et tests du site, le PIC pourra le rendre opérationnel, à votre demande, en faisant en sorte de faire pointer l'URL du site web sur sa nouvelle version.

Introduire la mise à jour majeure sur votre site de test
Le détail des opérations est donné sous les titres suivants.

Tester le fonctionnement

Mettre en ligne votre site de test

Faites l'inventaire des squelettes et des plugins installés

Les squelettes et les plugins peuvent poser problème...
Tout d'abord, si vous avez installé des plugins ou des squelettes particuliers, faites-en l'inventaire, et allez rechercher le site correspondant pour s'assurer que les plugins ou les squelettes sont compatibles avec SPIP 3.0.x ou si des mises à jour sont nécessaires, etc. Si le squelette ou un plugin ne sont pas développés dans la nouvelle version, peut-être devrez-vous en chercher de nouveaux, donc vous remettre au travail sur votre site... Raison de plus pour vous y mettre sans attendre, ça peut prendre quelque temps...

Désactivez plugins et squelette

Le plus sûr semble être de désactiver les plugins et le squelette.

Pour les plugins : Allez dans l'interface de gestion des plugins et désactivez tous les plugins un par un.
Pour le squelette : Renommez le répertoire squelettes, s'il existe, en squelettes.sauvegarde.
Ensuite, videz le cache de SPIP et videz le cache de votre navigateur.

Maintenant, votre site a probablement une tête un peu inhabituelle... mais ce n'est pas grave, vous n'avez rien cassé !

Faites d'abord une mise à jour mineure

Sur votre site de test, faites en premier la mise à jour mineure. Plus votre logiciel sera à jour, plus il y aura de chances que le fonctionnement soit correct lors du passage à la version finale.

Faites la mise à jour majeure

Le processus de mise à jour est le même que pour les mises à jour mineures :

Téléchargez la bonne version sur le site de SPIP, décompressez-la.
Transférez les fichiers.
Connectez-vous sur la partie privée avec votre mot de passe administrateur et les droits de webmestre.
Cliquez là où on vous dit de le faire.

La mise à jour de la version de SPIP se déroulera probablement sans difficulté.

Remettez en place le squelette

Renommez le répertoire squelettes.sauvegarde en squelettes.
Videz le cache de SPIP et celui de votre navigateur.

Les squelettes que vous avez éventuellement installés ou écrits vous-même dans le répertoire squelettes ne devraient normalement pas vous causer de soucis [3].

Remettez en fonction les plugins

Pour cela allez dans l'interface de gestion des plugins de la partie privée du site de test :

Activez les plugins l'un après l'autre.
Mettez à jour les plugins qui le demandent (dans SPIP 3.0, il suffit de cliquer sur un bouton pour mettre à jour les plugins).

[1] Sauf si votre site (ce n'est pas le cas au PIC) est encore dans une version 1.x.x : c'est non seulement important, c'est également urgent !

[2] Si vous êtes sous 2.0.x, (là encore personne n'est concerné au PIC) et souhaitez passer en 2.1 ou 3.0 je pense (mais ne l'ai pas expérimenté) que la méthode préconisée ici est également valable. Cependant, dans ce cas redoublez de précautions !

[3] Voir toutefois ici http://contrib.spip.net/Migration-d-un-squelette-de-SPIP2-vers-SPIP3

Mettre à jour son site SPIP : mises à jour mineures

manu — 2013-09-08T07:55:51Z

Une démarche sûre et efficace pour mettre à jour son site sous SPIP, lors de la publication de correctifs de bogues (mises à jour mineures).

Qu'est-ce qu'une mise à jour mineure ?

Comme tout logiciel, SPIP vient avec un numéro de version, composé de trois parties : 2.1.23, 3.0.11, etc. Les deux premiers chiffres correspondent à des "branches" de développement.

Entre la 2.0 et la 2.1 il y a des différences importantes de fonctionnement, et entre la 2.1 et la 3.0 les différences sont encore plus grandes : certains plugins fonctionneront avec une version et pas avec une autre, etc. Par contre, entre la 2.1.x et la 2.1.y, il n'y a (en principe) aucune différence notable, si ce n'est des corrections de bogues (on dit aussi bugs), c'est-à-dire d'erreurs de programmes.

Mettre à jour SPIP, cela signifie remplacer le logiciel par une version plus récente de celui-ci. Et faire une mise à jour mineure, cela veut dire passer par exemple de la version 2.1.20 à la version 2.1.21.

Cet article aborde uniquement le cas des mises à jour mineures : elles doivent normalement se passer sans problème.

Pourquoi mettre à jour SPIP ?

Il est important de suivre les différentes versions mineures de SPIP : des bogues sont corrigées d'une version à l'autre, et quelque chose qui ne fonctionne pas dans certaines conditions avec une version donnée se met brusquement à fonctionner correctement lorsqu'on a fait la mise à jour !

Mais surtout certains bogues peuvent toucher à la sécurité de votre installation : par exemple si quelqu'un découvre un moyen de se connecter sur la partie privée du site sans connaître le mot de passe, cela veut dire qu'il y a une défaillance dans SPIP. Les concepteurs de SPIP se remettent au travail dès que la vulnérabilité est connue, la corrigent rapidement, et annoncent la sortie de la version mineure suivante. [1] L'ennui, c'est que tant que vous n'avez pas fait la mise à jour de votre site vous êtes toujours vulnérable, de plus l'information sur la méthode à utiliser pour s'introduire chez vous étant largement diffusée vous êtes de plus en plus en danger : il devient urgent de faire la mise à jour.

Comment savoir qu'une nouvelle version est sortie ?

La seule manière de le savoir est d'aller régulièrement voir le site de SPIP, ou de s'abonner aux listes de diffusion relatives à SPIP... Une autre manière est d'être adhérent du PIC, nous envoyons généralement un courriel sur la liste des adhérents lorsque des mises à jour importantes (en particulier celles touchant à la sécurité) apparaissent.

Prérequis :

disposer d'un compte d'administrateur du site SPIP avec les droits de webmestre,
avoir les données d'accès FTP (URL, login et password)
avoir les données d'accès PHPMyadmin à la base de données (URL ou localhost ; login et password)

Videz le cache

Le cache de SPIP peut perturber le processus de mise à jour, car il garde des données qui seront peut-être incompatibles avec la nouvelle version du programme. Alors, avant toute chose : videz le cache de SPIP.

D'abord une sauvegarde !

Il est prudent de commencer par sauvegarder votre site comme expliqué sur cette page : la mise à jour peut se mal passer, vous-même pouvez faire une erreur de manipulation et tout casser, bref commençons par prendre nos précautions.

Récupérez la version adhoc

La première chose à faire est de récupérer la bonne version de SPIP. Attention à ne pas vous tromper :

Si vous êtes en SPIP 2.0 utilisez la dernière version de la branche 2.0 téléchargeable à partir de http://files.spip.org/spip/archives/
Si vous êtes en SPIP 2.1 utilisez la dernière version de la branche 2.1 téléchargeable à partir de http://files.spip.org/spip/archives/ [2]
Si vous êtes en SPIP 3.0 utilisez la dernière version de la branche 3.0 téléchargeable à partir de http://files.spip.org/spip/stable/spip-3.0.zip

Ne mélangez pas les versions : une mise à jour en 2.0.23 à partir d'un site en 2.1.22 pourrait bien tout casser... heureusement pas de manière irréversible, si toutefois vous avez des sauvegardes.

Comment savoir quelle est ma version ?

Ben vous devriez le savoir ! Bon, comme je vois que vous n'êtes pas sérieux, je vais vous expliquer : connectez-vous sur la partie privée du site, et regardez ce qui est indiqué tout en bas de la page à droite...

Téléchargez la bonne version et décompressez-la

Vous avez donc téléchargé la version de SPIP qui va bien, il s'agit d'un fichier zip : vous pouvez le décompresser en utilisant votre outil d'archive préféré (c'est-à-dire le plus souvent en cliquant sur le fichier, bouton de droite). Cela va vous générer un répertoire plein de fichiers (environ un millier, répartis en plusieurs sous-répertoires), appelé spip.

Transférez les fichiers

Vous êtes maintenant prêt pour démarrer Filezilla, ou n'importe quel autre client FTP. La suite de cet article supposera que vous utilisez Filezilla.

Positionnez le répertoire spip dans la fenêtre de gauche (correspondant à votre ordinateur local)
Connectez-vous à votre site en utilisant le mot de passe FTP que le PIC vous a fournis.
Vous devez voir dans la fenêtre de droite les mêmes fichiers ou répertoires que dans la fenêtre de gauche (en tous cas les mêmes noms, le contenu est différent).
Mettez la souris sur la fenêtre de gauche et appuyez sur CTRL-A afin de sélectionner tous les fichiers.
Laissez la souris dans la fenêtre de gauche et cliquez avec le bouton de droite, puis sur Envoyer
Le transfert démarre, une fenêtre s'ouvre alors, vous mettant en garde car vous transférez un fichier qui existe déjà : cliquez sur la case Remplacer, puis vers le bas de la fenêtre cochez les cases : Toujours exécuter cette action et Appliquer uniquement à la file d'attente actuelle (sinon il vous posera la question pour chaque fichier, or il y en a plus de 1000).
Lorsque le transfert est terminé, vérifiez en bas de la fenêtre FileZilla que tous les fichiers ont été correctement transférés, et si ce n'est pas le cas transférez à nouveau les fichiers en cause.

Mise à jour de la base de données

Peut-être faudra-t-il mettre à jour la base de données : d'une version à l'autre celle-ci évolue. Le procédé est très simple : rendez-vous sur la partie privée, avec un compte "webmestre" [3] et faites ce qu'on vous dit ! Si on ne vous dit rien c'est qu'il n'y a pas de mise à jour à faire, s'il y en a une vous le verrez tout de suite : cliquez tout simplement, ça mouline quelques secondes et c'est fini !

Vérifications

Tout d'abord, à partir de l'interface privé, allez voir toujours en bas à droite de la page, si la version de SPIP a changé, signe que la mise à jour a été faite.

Il est par ailleurs prudent de vérifier que tout a l'air de marcher comme avant. Si vous avez des messages bizarres c'est probablement qu'il faut vider le cache : videz-le pour les faire disparaitre. Sauf que ça ne devrait pas arriver puisque vous avez suivi mon conseil et que le cache a déjà été vidé ! Oui, mais il y a un autre cache : celui de votre navigateur. Donc avant de chercher plus avant, videz tous les caches : celui de SPIP, et celui de votre navigateur [4] Allez dans l'interface de gestion des plugins, et si vous êtes en version 3 mettez à jour (il suffit de cliquer) les plugins qui le demandent. Mais surtout vérifiez bien que tous vos plugins sont toujours opérationnels.

Et si ça ne marche pas ?

D'abord, à moins que vous n'ayez fait des bêtises, ça marche toujours [5] ! Donc n'ayez aucune crainte. Si ça ne marche pas, repartez à partir des sauvegardes pour réinstaller la version précédente de votre site, et si vous vous sentez complètement paumé, n'hésitez pas à nous contacter, nous faisons régulièrement des sauvegardes du serveur du PIC, donc nous devrions pouvoir remettre votre site dans l'état dans lequel vous l'avez trouvé en démarrant.

Et si tout ça vous ennuie...

Si tout cela vous semble très ennuyeux et très compliqué, contactez le PIC (picca@le-pic.org), nous pouvons nous occuper de la mise à jour de votre site !

[1] En fait, puisque pour l'instant (Septembre 2013) trois branches sont toujours maintenues : la 2.0, la 2.1 et la 3.0, ce sont souvent plusieurs versions mineures qui sortent le cas échéant : une pour corriger le souci dans la 2.0, une autre pour la 2.1 et une autre pour corriger le souci dans la 3.0

[2] Attention les fichiers n'apparaissent pas dans l'ordre, il est assez facile de se tromper

[3] Pour pouvoir faire ces manipulations, il faut en effet utiliser un compte administrateur ayant les droits webmestre

[4] Si vous utilisez Firefox le plus simple est de taper sur CTRL_GAUCHE-SHIFT-SUPPR (les trois en même temps), puis de cocher et décocher les cases proposées).

[5] Bon, soyons honnêtes : presque toujours...

Installer SPIP sur son poste de travail Windows

Jean-Pierre — 2013-04-02T18:10:41Z

L'installation de SPIP en local, sur son ordinateur, est intéressante pour expérimenter et mettre au point son site avant de le mettre en ligne sur le serveur.

Il est tout aussi avantageux de pouvoir tester le passage de SPIP à une version supérieure, l'introduction d'un nouveau plugin etc. et de régler les problèmes éventuels sans désagréments pour l'internaute...

Après quoi il faudra mettre à jour le serveur avec la nouvelle version de SPIP (si celle-ci diffère de la version locale) puis la Base de Données et les nouveaux squelettes pour avoir en ligne toutes les fonctionnalités élaborées en local.

Pré-requis :

Avoir les droits d'administrateur sur votre système Windows, nécessaires pour installer des logiciels.
Assurer l'affichage complet des noms de fichiers (l'extension est masquée par défaut !) et démasquer les fichiers protégés du système.

Pour modifier ces options d'affichage, se placer dans l'Explorateur de fichiers (clic droit sur le bouton 'Démarrer' puis choisir 'Explorer').
Sous Windows XP ou Vista cliquer sur l'onglet 'Outils' du menu de haut de page, puis 'Options des dossiers', et enfin 'Affichage' .
Sous Windows 7 cliquer sur l'onglet 'Organiser' puis sur 'Options des dossiers et de recherche'

Décocher les options :
- Masquer les extensions dont le type est connu
- Masquer les fichiers protégés du Système
Cliquer sur 'Appliquer'

ATTENTION

Démasquer les fichiers système, vous permet de TOUT faire sur votre ordinateur et même de le rendre inutilisable si vous supprimez des fichiers indispensables au système !

Installation du serveur Web local et de SPIP

1/ Télécharger et installer un logiciel serveur Web local :

EasyPHP https://www.easyphp.org,
WampServer https://www.wampserver.com ou tout autre logiciel équivalent pour Windows.

2/ Lancer le serveur Web local (Double clic sur l'icône raccourci).
L'activation du serveur affiche l'icône du serveur dans la zone de notification (à la gauche de l'heure).

3/ Télécharger SPIP à partir de http://www.spip.net.
Placer l'ensemble des fichiers décompressés sous la racine du serveur Web local, (répertoire EasyPHP\www ou wamp\www).
Remplacer le nom par défaut du répertoire racine de votre site local (spip) par un nom qui identifie le site (exemple monsite).

4/ Installer SPIP :

L'écran d'accueil de l'installation de SPIP

langue par défaut : français...

Aller à l'adresse http://127.0.0.1/monsite/ecrire et dérouler la procédure d'installation :

Progression de l'installation : phase 1

Indiquer le type de base de données

Phase 1 :
- choisir le type de la base de données
- laisser localhost pour l'adresse de la base de données
- donner root comme login de connexion et laisser vide le mot de passe de connexion.
Phase 2 :
- Choix de la base : cliquer 'créer une nouvelle base de données'
- Choisir pour cette base de données un nom en rapport avec le nom de votre site
Phase 3 :
- Il sera préférable de choisir pour le SPIP local des identifiants de connexion identiques à ceux du SPIP en ligne.
  Si votre site en ligne n'existe pas encore, bien noter ce login et ce mot de passe : en cas d'oubli, vous seriez obligé de réinstaller SPIP...
Phase 4 :
- Votre système de publication s'installe.
  En fin d'installation, vous pouvez accéder à l'espace privé de votre site dans sa version de distribution.

En vue de personnaliser votre site local vous pourrez créer sous le répertoire racine du site :

le répertoire plugins et son sous-répertoire auto qui vous seront indispensables pour ajouter des plugins.
le répertoire squelettes qui recevra les fichiers de personnalisation de vos pages.
Autorisez les répertoires IMG, tmp, squelettes, plugins et plugins/auto en écriture.

N'oubliez pas de lancer le serveur Web local (Double clic sur l'icône raccourci) avant de taper dans votre navigateur l'adresse de votre site local 127.0.0.1/monsite/ sans quoi votre site local sera inaccessible...

Installer SPIP sur son poste de travail Linux

2013-04-02T18:10:35Z

L'installation de SPIP en local, sur son ordinateur, est intéressante pour expérimenter et mettre au point son site avant de le mettre en ligne sur le serveur.

Installation de SPIP sur un poste de travail Linux

Préambule : Vérifier que les logiciels Apache, Mysql, PHP et phpMyAdmin sont installés.
Sinon installer ces produits avec les outils de la distribution Linux utilisée.

Etape 0 (Facultative)

Par défaut les sites web s'installent (sous Debian ou dérivée (ubuntu)) dans le répertoire /var/www . Il peut être pratique de les installer dans son /home, par exemple pour des raisons de sauvegarde. En ce cas on peut i) créer un répertoire www dans son home directory et ii) faire un lien entre le /var/www et ce répertoire :

Par exemple

sudo ln /home/mon_repertoire/www /var/www

Etape 1

Télécharger SPIP depuis l'adresse http://www.spip.net/fr_download
Dézipper le fichier ainsi obtenu dans le répertoire www précédemment créé (sinon dans /var/www).
Renommer le répertoire spip ainsi obtenu. Par exemple : monsite
Aller dans le répertoire monsite
Modifier les droits d'accès des sous-répertoires config , tmp , IMG et local de la façon suivante :

chmod -R 777 config tmp IMG local

Etape 2

Créez la base de données à l'aide de phpMyAdmin : faites pointer votre navigateur à l'adresse http://127.0.0.1/phpmyadmin et connectez-vous en tant que root
Cliquer sur "Bases de données" crééz une base de données de nom monsite et d'interclassement utf8_general_ci [1].
Cliquer sur "Privilèges" et ajouter un utilisateur monsite
- lui attribuer un mot de passe : motdepasse Le mieux est ici de cliquer sur le bouton "Générer un mot de passe"
- lui donner tous les privilèges sur la base monsite

Etape 3

Installation du site :

Aller sur http://127.0.0.1/monsite/ecrire : la procédure d'installation de spip commence.
Renseigner le login de connexion à la base (le nom d'utilisateur que vous venez de créez avec mysql) : monsite
Renseigner le mot de passe motdepasse
Choisir monsite comme base de données
Cliquer sur "suivant"
Renseigner Signature et Mail
Puis login et mot de passe . Attention ce seront ceux qui donneront accès à l'espace privé du site. Les noter et s'en souvenir ! En cas d'oubli, il faudra nécessairement tout recommencer...
Terminer l'installation en cliquant sur "suivant"
Ne pas tenir compte du message d'erreur "htaccess inoperant"

Et voilà !

[1] cf. http://wiip.fr/content/choisir-le-bon-interclassement-mysql-pour-utf-8 pour des détails sur l'interclassement

Sauvegarder son site SPIP

Jean-Pierre — 2013-01-08T15:59:30Z

La sauvegarde est un moyen de recouvrer toutes les fonctionnalités de votre site en cas de problèmes (après introduction d'une nouvelle version de SPIP, suite aux méfaits d'un hacker ou à un incident grave sur les serveurs du PIC, etc.).

Pour commencer :

Il faut bien sûr un ordinateur et une connexion Internet.
Il faut connaître le login et le mot de passe d'un administrateur ayant les droits webmestre pour se connecter à l'espace privé du site SPIP et accéder à la fonction de sauvegarde de la base du site.
Il faut connaître le login et le mot de de passe vous permettant d'accéder à votre site en FTP. Si vous ne les connaissez pas, demandez-les nous.
Il faut enfin disposer d'un moyen de télécharger certains fichiers et dossiers depuis le serveur qui héberge le site : un logiciel tel que FileZilla [1] se connecte en FTP (File Transfer Protocol) sur le serveur d'hébergement et assure cette fonctionnalité.

Pourquoi sauvegarder ?

Pour pouvoir disposer des éléments nécessaires à la reconstruction de votre site en cas de problèmes.
Pour pouvoir installer sur votre ordinateur un site SPIP local, image de votre site en ligne, lorsque vous voulez modifier le site en profondeur (particulièrement agir sur les squelettes) : plutôt que de faire des modifications directes sur le site de production au risque d'avoir un fonctionnement dégradé, le travail se fait d'abord en local sans préjudice pour l'internaute. Quand tout est correct, les modifications sont transférées sur le serveur de l'hébergeur.
Pour être libre de changer d'hébergeur si vous le souhaitez.

Quand faut-il faire une sauvegarde ?

Avant une mise à jour de la version de SPIP
Après un volume d'ajouts ou modifications importantes des contenus du site.

Ce qu'il faut savoir :

L'utilisation d'une sauvegarde pour restaurer un site ne pose aucun problème si sa version SPIP est la même que celle du serveur.

Ce rappel figure en début de page de la fonction de sauvegarde de la base de données de toutes les versions de SPIP.

Créer un fichier de sauvegarde de la base :

Se connecter à l'espace privé avec le login et le mot de passe administrateur.
Pour démarrer la sauvegarde avec les versions 2 de SPIP :
- Cliquer sur Configuration puis Maintenance du site pour accéder à la partie Sauvegarder le contenu de la base.
- Cliquer sur le triangle qui précède la mention Options avancées puis sélectionner toutes les tables.

Pour démarrer la sauvegarde à partir des versions 3 :
- Cliquer sur Maintenance puis Sauvegarder la base.
- Garder sélectionnée l'option Sauvegarder toutes les tables

Le nom de sauvegarde que SPIP propose par défaut est toujours de la forme nom_du_site_aaaammjj
où aaaammjj correspond à la date du jour. Si une sauvegarde du même jour existe déjà le nom de sauvegarde sera suivi d'un tiret et d'un chiffre.

Cliquer sur le bouton Sauvegarder la base

Le temps nécessaire pour générer l'archive dépend d'une part du volume de la base de données, et d'autre part des performances et de l'activité du serveur.

La fin de l'opération est signalée par un message.

L'archive de sauvegarde est stockée dans le répertoire tmp/dump

Nota : Dans le cas de figure où un plugin actif a rajouté des champs aux tables de la base de données (exemple : Champs Extra 2 pour les versions 2 de SPIP) , il sera nécessaire d'utiliser PHPMyAdmin [2] [3] à la place de la fonction de sauvegarde proposée dans l'espace privé.

Ce qu'il est nécessaire de télécharger sur votre ordinateur

Le fichier de sauvegarde : Le répertoire tmp/dump contient le fichier de sauvegarde de la base de données de SPIP que vous venez de créer (c'est-à-dire tout le contenu des articles et des rubriques du site).
Le répertoire IMG qui contient les images et documents utilisés dans vos pages
Le répertoire squelettes qui contient les squelettes personnalisés (il n'existe pas obligatoirement sur votre site).
Le répertoire plugins qui contient peut-être des fonctionnalités additionnelles mises en œuvre dans les squelettes.
Le fichier svn.revision, figurant à la racine du site, car il contient le numéro de version SPIP indiqué à la fin de sa 3ème ligne.

Télécharger tous les fichiers nécessaires :

C'est là qu'intervient le logiciel FTP.

FileZilla est un logiciel libre de transfert de fichiers en FTP très populaire et simple d'utilisation. Il faut d'abord renseigner le formulaire des paramètres de la connexion situé en haut de page :

adresse de connexion : nom_de_votre_espace.le-pic.org
port : 21

login : votre nom de connexion

mot-de-passe : votre mot de passe

En cliquant sur le bouton Connexion rapide, l'écran présente face à face deux explorateurs de fichiers : à gauche les fichiers locaux (les fichiers de votre ordinateur) et à droite les fichiers de votre site sur le serveur de l'hébergeur.

Le transfert d'un fichier (ou d'un répertoire entier) se fait par simple glisser-déposer du nom du fichier (ou du répertoire) du site distant (à droite) vers le répertoire idoine de votre ordinateur (à gauche).

La navigation dans les arborescences locale et distante est tout à fait classique.

ATTENTION

Toutes les fonctions de gestion de fichiers sont présentes dans un logiciel FTP,
dont la suppression des fichiers… Et la manœuvre est irréversible…

L'utilisation doit se limiter aux transferts des fichiers, possibles dans les deux sens.

Refermer FileZilla en fin d'opération pour éviter toute fausse manœuvre.

[1] http://filezilla.fr/

[2] La doc PHPMyAdmin en français

[3] http://phpmyadmin.le-pic.org/

Je voudrais changer la présentation de mon SPIP

manu — 2013-01-04T22:37:00Z

Changer la présentation d'un site sous SPIP

La présentation des pages d'un site SPIP est dépendante d'un ensemble de fichiers appelé squelettes.
Les fonctionnalités présentes dans chaque page du site sont définies dans des fichiers qui utilisent le langage spécifique à SPIP décrit dans ce document de référence.
La mise en page est assumée par les CSS (feuilles de styles).

Vous avez le choix entre plusieurs solutions :

Exploiter à fond au départ les seuls potentiels des squelettes austères fournis par SPIP : mettre un logo à votre site, à vos rubriques, à vos articles, publier des images, etc. L'avantage c'est que durant la période où vous le ferez, votre site s'enrichira en contenus correspondant aux désirs de votre équipe, et ces éléments vous seront précieux par la suite, au moment où vous voudrez vraiment déterminer des squelettes personnalisés.
Installer tout squelette existant sous forme de plugins de SPIP. Nous vous recommandons tout particulièrement le squelette ZPIP. Mais il y en a beaucoup d'autres : on trouve pas mal de squelettes SPIP sur Internet, et il est très simple de remplacer le squelette par défaut par un autre. Les spip_contribs sont bien utiles pour ça, et pour bien d'autres choses encore.
Prendre votre courage à deux mains et écrire vos propres squelettes : si vous connaissez le HTML, il vous faudra encore lire la documentation de SPIP. C'est un peu compliqué, mais tout-à-fait abordable, même pour des non-informaticiens. Une démarche est d'ailleurs proposée ici. Bien sûr, cette solution est la meilleure, car elle vous permettra de faire du "sur-mesure". Mais c'est aussi celle qui vous demandera le plus de travail !

Bien démarrer son site sous SPIP

manu — 2005-06-15T22:33:20Z

Pour démarrer son site web sous SPIP, il faut commencer par installer le logiciel SPIP sur votre espace web. Cet article explique comment faire... sauf que le plus simple est encore de demander au PIC de le faire pour vous ! N'hésitez pas à faire appel à nous

La première chose à faire est d'installer le logiciel SPIP sur votre espace web [1] : pour cela, lorsqu'on vient de vous donner accès au serveur du pic, il vous faut vous connecter à l'aide d'un navigateur sur votre page d'accueil : elle doit ressembler à celle-ci. Cliquez alors sur le lien Installer SPIP.

SPIP vous demandera dans un premier temps les paramètres de votre base de données :

nom de serveur = laissez la valeur par défaut (localhost)
nom de login = Il est spécifié sur le mail que vous avez reçu.
mot de passe = Il est spécifié sur le mail que vous avez reçu.
nom de base de données : cocher le nom correspondant à celui que vous avez dû recevoir par courriel [2]

Ensuite, SPIP vous demande de rentrer des informations sur vous-même :

votre nom
votre adresse mail
votre nom de login
votre mot de passe

Vous êtes alors "propulsé" dans la partie privée du site SPIP : c'est elle qui vous permettra de mettre votre site à jour. Il ne faut pas la confondre avec le site intranet.

[1] Si des bénévoles du PIC ne l'ont pas déjà fait pour vous...

[2] Attention, vous avez peut-être un site intranet, dans ce cas ne vous trompez pas de base de données : celle du site intranet porte un nom dans le style asso_v1_intranet