migration hautetfort vers wordpress (Créer un compte)

Migration d’un site haut et fort vers wordpress, 
à l’aide de l’utilitaire importation-hetf.php de Jérôme.

1.	Avant-propos
La procédure qui va être décrite ci-dessous vous permet de récupérer le contenu d’un blog rédigé sur la plateforme hautetfort (ou blogspirit, qui utilise le même logiciel) pour le réinjecter dans un blog Wordpress éventuellement déjà démarré. Les articles et commentaires importés vont donc pouvoir se rajouter aux articles et commentaires déjà existants, et non s’y substituer
2.	Mises en garde
Attention ! Contrairement aux utilitaires de migration fournis par Wordpress, cette méthode « artisanale » souffre de plusieurs défauts :
1.	Elle nécessite, de la part de son utilisateur, un minimum de compétences informatiques notamment en base de données (SQL) et en programmation PHP, pour être capable de traiter les éventuels aléas qui pourraient surgir
2.	Cette procédure a été initialement développée par un béotien en matière de Wordpress et de PHP (ayant toutefois quelques compétences en informatique, je vous rassure). En conséquence, le code est fonctionnel mais un peu « bourrin ». Le contenu migré est inséré en base directement par des ordres SQL au lieu d’utiliser d’éventuelles API Wordpress, qui auraient permis à ce code une plus grande stabilité avec les évolutions Wordpress. Initialement développée pour une version WP2.3, elle montre déjà quelques faiblesses avec WP2.5. Si un développeur veut reprendre le flambeau, il est le bienvenu !
3.	À cause des défauts ci-dessus, elle nécessite donc d’être adaptée à votre propre besoin. Le processus décrit ci-dessous est celui de la migration finale. Nous ne saurions trop vous recommander de procéder auparavant à ce que l’on appelle des « tirs à blanc », pour vérifier que la procédure fonctionne.

3.	Pré-requis
Outre les quelques compétences indiquées ci-dessus, vous aurez besoin, pour effectuer la migration depuis Windows, des outils suivants : 

–	WinHTTrack, http://www.httrack.com , afin d’importer sur votre disque dur l’ensemble du site, avant de le convertir pour wordpress.
–	Wamp, pour pouvoir faire tourner une version locale de wordpress.
–	Le plugin maintenance mode pour wordpress http://wordpress.org/extend/plugins/maintenance-mode/

NB : des équivalents de ces outils existent sans doute sur les plateformes Linux ou Mac. Les auteurs n’étant pas spécialistes de ces plateformes, nous ne détaillerons ici que le processus sous Windows, mais il est probablement transposable.

La migration consistera à :
–	aspirer les données du site haut et fort
–	installer une version locale de wordpress 
–	importer le contenu du site wordpress en production dans le wordpress local
–	convertir le contenu provenant de hautetfort et à l’injecter dans le worpress local
–	migrer le contenu du wordpress local dans le wordpress de production.

4.	Importation en local du site haut et fort

Le but de cette phase est d’aspirer le contenu de votre site haut et fort à l’aide du logiciel Httrack pour en faire une réplication locale sur votre PC.

Comme indiqué sur la copie d’écran ci-dessous, on modifie les règles de filtrage comme suit, en remplaçant xxxx par le nom de votre site haut et fort :
-*
+xxxx.hautetfort.com/archive/*.html
+xxxx.hautetfort.com/*.gif
+xxxx.hautetfort.com/*.png
+xxxx.hautetfort.com/*.jpg
+xxxx.hautetfort.com/*.css 

De plus, dans l’onglet Fouineur, on désactive la lecture du fichier robots.txt, à la ligne spider, en sélectionnant : pas de règles robots.txt


 


Si vous voulez migrer l’intégralité de vos commentaires, nous vous recommandons de les interdire sur le site H&F le temps d’effectuer la migration, pour ne pas en perdre. Vos lecteurs bavards pourront reprendre le fil de la discussion sur votre site wordpressien.
5.	Installation d’une version locale de Wordpress

A l’aide de Wamp, on installe une version de wordpress en local. On se réfèrera, en cas de problème, à l’abondante documentation existant déjà sur Internet sur ce sujet.

On place maintenant en mode maintenance le wordpress de production afin d’éviter tout commentaire supplémentaire pendant la migration.
Dans le wordpress, on exporte le contenu actuel en allant dans « gérer » puis en cliquant sur exporter. On télécharge alors le fichier d’exportation.

Attention à bien conserver ce fichier intact en cas de problème !

On importe ensuite ce fichier dans le wordpress local via gérer, puis importer.

A l’aide de phpMyadmin, il faut modifier en base de donnée les options qui indiquent l’url du site afin d’éviter d’être rediriger vers le site de production. 
On effectuera la manœuvre inverse à la fin (ancien et nouveau sont les adresses des sites) :

update wp_options 
set option_value = REPLACE(option_value,’ancien’,’nouveau’) 
where option_value like ‘%ancien%’;

Remarque : il semblerait que cette modification ne soit plus aussi efficace sur la version WP2.5+ qu’elle ne l’était sur la version 2.3.
6.	Conversion haut et fort vers Wordpress

A présent, nous allons convertir les fichiers haut et fort et les intégrer dans la base locale wordpress, à l’aide de l’utilitaire importation-hetf.php

En éditant importation-hetf.php à l’aide d’un éditeur de texte, on modifie dans le fichier les chaînes de caractères associés au nom du site haut et fort (monsitehetf.hautetfort.com), et on indique le nom, login et mot de passe pour accéder à la base.

Dans la section // Décorticage d’une page, il est nécessaire de modifier les expressions régulières pour qu’elles correspondent au modèle de la page H&F. Le programme recherche en effet des séquences particulières pour repérer le contenu de la note, sa date de publication, les mots-clés associés, etc. Ce contenu est facilement identifiable à l’œil nu pour un humain, mais un programme est moins subtil et a besoin d’information précise. Les repères dans le code HTML de la page varient d’un thème H&F à un autre, c’est pourquoi l’adaptation des expressions régulières est indispensable.



Il faut également, à l’aide de Phpmyadmin, ajouter dans deux des tables de la base une colonne supplémentaire permettant de stocker des informations de migration : 

alter table `wp_posts` add column `migrationcui_url` varchar (200) CHARSET utf8  COLLATE utf8_general_ci   NULL  after `comment_count` ;
alter table `wp_comments` add column `migrationcui_id` varchar (30) CHARSET utf8  COLLATE utf8_general_ci   NULL  after `user_id` ;


On lance importation-hetf.php que l’on aura placé dans l’arborescence accessible via WAMP à partir du navigateur internet, une fois ces modifications effectuées.

On importe sur le site de production, via ftp, tous les médias dans le répertoire : 

/wp-content/import-hetf/

7.	Exportation vers le wordpress de production

A présent, à l’inverse du départ, on exporte le contenu du wordpress local vers le wordpress de production :

Menu Gérer, puis exporter.

Et l’on importe ce fichier sur le wordpress de production, menu gérer, importer.

On modifie les options de la base de données sur le serveur de production cette fois :

update wp_options 
set option_value = REPLACE(option_value,’ancien’,’nouveau’) 
where option_value like ‘%ancien%’;

Voilà, la migration est terminée.