(article mis-à-jour le 8 août 2009)


La version 2 de spip étant une version majeure, la mise à jour d’un site en version 1.9.x est particulière.
Quelques conseils pour que la transition se fasse au mieux

-  désactiver tous les plugins par la page : ecrire/ ?exec=admin_plugin
-  faire une sauvegarde de la base de données en utilisant la procédure de spip 1.9.x : ecrire/ ?exec=admin_tech
-  récupérer cette sauvegarde par ftp (elle se trouve dans tmp/dump/ ou, pour des versions plus anciennes, dans ecrire/data/) et la conserver soigneusement en local.

-  créer un répertoire à la racine de spip (par exemple ancien_spip/)
-  déplacer à l’intérieur de ce répertoire tous les fichiers et répertoires de spip 1.9.x SAUF les répertoires IMG/ et config/
-  si vous aviez un fichier mes_options.php le déplacer dans config/

• ne devrait donc rester à la racine que :
  • ancien_spip/
  • config/
  • IMG/

-  déposer par ftp, à la racine de son site, l’ensemble des fichiers et répertoires de spip 2.0.x sauf les répertoires IMG/ et config/

• devraient donc se trouver à la racine :
  • ancien_spip/
  • CHANGELOG.txt
  • config/
  • COPYING.txt
  • ecrire/
  • htaccess.txt
  • IMG/
  • index.php
  • INSTALL.txt
  • local/
  • prive/
  • rien.gif
  • spip.php
  • squelettes-dist/
  • svn.revision
  • tmp/

-  entrer avec son navigateur dans http://le_site/ecrire/ [1]
-  accepter la mise à jour de la base de données

• à ce stade, vous devriez retrouver, dans l’espace privé, l’intégralité des données de votre ancien site et une navigation dans l’espace public devrait les afficher avec les squelettes par défaut de spip (couleur mauve)
• en cas de problème (page blanche par exemple), essayer de renommer temporairement votre fichier mes_options.php (dans le répertoire config/) pour le désactiver.

-  récupérer maintenant les version adaptées à spip 2 des plugins que vous utilisiez et installer ces nouvelles versions dans un répertoire plugins/ à créer.
ou bien, après avoir créé un répertoire plugins/ puis son sous-répertoire auto/ utiliser la procédure d’auto installation des plugins proposée dans la page ecrire/ ?exec=admin_plugin

-  reste à créer un répertoire squelettes/ (si vous en avez l’utilité) et y déplacer calmement, par petits groupes, vos anciennes personnalisations récupérées depuis ancien_spip/squelettes/

-  si vous aviez un fichier mes_fonctions.php, vérifier la conformité de ses fonctions et déclarations avec les nouvelles fonctions et variables de spip 2.0.x
-  idem si des scripts php sont présents dans vos squelettes personnalisés

-  si vous n’avez pas déjà un .htaccess actif, il vous faudra renommer htaccess.txt en .htaccess pour bénéficier des urls propres, arbo...

LES SQUELETTES

rappel :
les fichiers rangés dans votre répertoire squelettes/ prennent le pas sur ceux placés par défaut dans squelettes-dist/ ou dans prive/

si vous avez, en 1.9.x, copié l’organisation de votre répertoire squelettes/ sur celle de dist/ , sachez que 2.0.x apporte des modifications importantes à cette organisation et qu’il vous faudra veiller à ne pas avoir des fichiers fantômes appelés en lieu et place des légitimes.
en particulier, un ancien squelettes/login.html tout comme squelettes/formulaires/login.html prendront le pas (et ce pourra être un problème) sur prive/login.html et prive/formulaires/login.html.

attention aussi aux fichiers de feuille de style et aux fichiers de script javascript.

-  liste des fichiers qui étaient dans dist/ (que vous avez peut-être personnalisés dans squelettes/) et qui ont été déplacés ou supprimés :

d’une manière générale, s’inspirer des nouveaux squelettes de squelettes-dist/ et prive/ pour reprendre et mettre à jour vos personnalisations dans squelettes/

si vous avez déjà effectué votre mise-à-jour en déposant les fichiers de spip 2.0.x sur votre spip 1.9.x, alors il reste sans doute d’anciens fichiers devenus obsolètes et que vous pouvez supprimer :

-  passage de 1.9.2 à 2.0.x stable [14697]
ces fichiers qui existaient en 1.9.2, sont, en 2.0.x, soit supprimés, soit déplacés
(cela concerne essentiellement le répertoire ecrire/ et ses sous-répertoires) il convient de les supprimer

-  ecrire/action/autoriser.php
-  ecrire/action/ical.php
-  ecrire/action/inscription.php
-  ecrire/action/instituer_mot.php
-  ecrire/action/instituer_rubrique_articles.php
-  ecrire/action/pass.php
-  ecrire/action/rss.php
-  ecrire/action/test_dirs.php

-  ecrire/base/db_mysql.php
-  ecrire/base/optimiser.php

-  ecrire/engines-list.txt

-  ecrire/exec/articles_ortho.php
-  ecrire/exec/editer_mot.php attention !!! ne pas confondre avec ’ecrire/exec/editer_mots.php’ (pluriel) qui est bien un fichier 2.0.x
-  ecrire/exec/export.php
-  ecrire/exec/forum_envoi.php
-  ecrire/exec/puce_statut_article.php
-  ecrire/exec/rubriquer.php
-  ecrire/exec/statistiques_svg.php

-  ecrire/extract/doc.php
-  ecrire/extract/pdf.php
-  ecrire/extract/rtf.php

-  ecrire/inc/auth_ldap.php
-  ecrire/inc/auth_spip.php
-  ecrire/inc/compacte_js.php
-  ecrire/inc/cron.php
-  ecrire/inc/editer_article.php
-  ecrire/inc/editer_mot.php attention !!! ne pas confondre avec ’ecrire/inc/editer_mots.php’ (pluriel) qui est bien un fichier 2.0.x
-  ecrire/inc/extra.php
-  ecrire/inc/indenter_xml.php
-  ecrire/inc/indexation.php
-  ecrire/inc/maintenance.php
-  ecrire/inc/ortho.php
-  ecrire/inc/popularites.php
-  ecrire/inc/sax.php
-  ecrire/inc/sites_voir.php
-  ecrire/inc/valider_xml.php
-  ecrire/inc/visites.php

-  ecrire/install/etape_5.php
-  ecrire/install/etape_6.php

-  ecrire/safehtml/classes/HTMLSax3.php
-  ecrire/safehtml/classes/safehtml.php
-  ecrire/safehtml/classes/HTMLSax3/Decorators.php
-  ecrire/safehtml/classes/HTMLSax3/States.php
-  ecrire/safehtml/license.txt
-  ecrire/safehtml/readme-SPIP.txt
-  ecrire/safehtml/readme.txt

-  ecrire/urls/propres-qs.php attention !!! ne pas confondre avec ’ecrire/urls/propres_qs.php’ (underscore) qui est bien un fichier 2.0.x

-  ecrire/xml/atom.php
-  ecrire/xml/ical.php
-  ecrire/xml/rss.php

-  ecrire/win_png.htc


-  le répertoire dist/ et tous ses fichiers (voir plus haut LES SQUELETTES)

-  le répertoire oo/ et son fichier index.php

-  les 3 fichiers à la racine :

• inc-public.php3
• UPGRADE.txt
• win_png.htc