Comment fonctionne ce plugin
Ce plugin sert à importer des objets DC (post, commentaires ...) en objets SPIP (articles, forums ...) en passant leurs contenus d’une base de donnée à l’autre.
Ce plugin :
- convertit les raccourcis Dotclear en raccourcis SPIP.
- transforme les category DC en rubriques SPIP.
- transforme les post DC en articles SPIP, le champs texte des post DC se retrouvant dans le champ texte des articles de SPIP, le champs introduction de DC se retrouve dans le descriptif des articles de SPIP.
- transforme les tags DC en mot-clefs SPIP.
- transforme les commentaires DC en forums SPIP.
- transforme les sites réferéncés DC en sites réferencés SPIP
- transforme les utilisateurs DC en auteurs SPIP, en essayant de faire correspondre autant que faire ce peut les statuts. Comme il n’est pas possible de migrer les mots de passe, pour des raisons de sécurités, le plugin en génère des nouveaux, qu’il envoie par email s’il peut.
- transforme les medias DC (sauf les documents distants) en documents SPIP. Le plugin s’occupe de copier depuis le dossier /private de DC vers le dossier /IMG de SPIP.
Comme certains post DC peuvent ne pas être dans une catégorie, alors que tout article SPIP doit être dans une rubrique, le plugin crée une rubrique intitulée « Rubrique d’import DC ».
Ce plugin ne convertit pas des thèmes dotclear en squelettes SPIP. Vous pouvez toutefois vous tourner vers SPIP-Clear
Préalable : préparer Dotclear
Il vous faut un blog sous Dotclear 2. Si votre blog est sous Dotclear 1, il faudra auparavent le "migrer". Par ici : http://fr.dotclear.org/documentation/2.0/admin/1-to-2
Le plugin est prévu pour fonctionner sur une base SPIP "vierge" (sans contenu éditorial). En théorie il pourrait fonctionner avec un SPIP déjà rempli, mais cela n’a jamais été testé.
Le mieux est de travailler « en local » car le plugin nécessite pas mal de calcul.
Il faut donc installer un SPIP (dernière version).
A la racine du dossier de SPIP, (à coté de ecrire, squelettes-dist etc,) déposer le dossier public de Dotclear, qui contient les documents de dotclear.
Les tables de la base de donnée de DC doivent se trouver dans la même base que SPIP. Ainsi, lorsque vous installer votre SPIP, il est nécessaire de bien choisir la base de donnée.
Les urls de dotclear doivent être les urls "standards".
Installer le plugin
Il s’installe comme n’importe quel plugin.
Il nécéssite :
- SPIP 2.1
- le plugin médiathèque
- le plugin sale (zip)
- le plugin CRUD (zip).
Il vaut mieux faire la migration depuis dotclear sur une base vide, avant toute écriture de contenu. En revanche, il est possible de configurer SPIP avant (par exemple, activer l’annuaire de site WEB).
Migrer le site
Une fois le plugin activé, rendez-vous dans le menu Configuration->Migration depuis Doctlear.
Le plugin liste tous les blogs DC disponible. Choisissez ceux que vous souhaitez migrer. Chaque blog sera recopié avec sa hiérarchie de catégories / rubriques, sans fusion.
Il vous faudra confirmer votre choix. Laissez le plugin mouliner.
Après la migration
Gestion des documents problématiques !
La première chose a faire est de supprimer le plugin pour éviter de migrer plusieurs fois par erreur.
Ensuite, il vous faudra regarder dans le dossier tmp de SPIP. Vous pourrez trouver un fichier prive_dot_attention.log : ce fichier liste les éventuels documents qui n’auraient pas pu être migrés, post par post. Il s’agit des documents distants pour la plupart.
Il vous faudra donc repérer ces posts, retrouver les documents, et les ajouter à la main dans les articles SPIP correspondants.
Récupération des anciennes urls (A partir de la version 0.2 du plugin)
Pour permettre de ne pas perdre les liens que certains ont fait vers votre site, récupérez le fichier local/htaccess.tex.
Remplacez dedans http://exemple.tld par l’adresse du site SPIP. Mettez le résultat dans le fichier .htaccess de l’ancien site Dotclear.
A faire
Certains champs des post DC — des champs d’importance secondaire — n’ont pas leurs équivalent dans les articles de SPIP.
Ainsi :
- le champs "post_tz" de la table dc_content et dc_user.
- le champs "post_creadt" de la table "dc_content" n’a pas d’équivalent.
- le champs "post_upddt" de la table "dc_content" n’a pas d’équivalent.
J’attends vos suggestions pour définir ces équivalences.
Ps : Si vous utilisez ce plugin, merci de me faire vos retours d’expériences.
dotclear2spip.zip
Vos commentaires
# Le 12 mai à 12:09, par Valéry
En réponse à : Doctlear vers SPIP
Après avoir suivi le processus depuis dotclear2 vers spip 2.1 le plugin a récupéré les rubriques et les commentaires mais ni les billets ni les documents.
# Le 14 mai à 00:48, par Maïeul
En réponse à : Doctlear vers SPIP
étrange :(
peut tu m’envoyer par mail la BDD, j’essaierai de regarder dans le courant de la semaine …
Répondre à ce message
# Le 11 septembre 2011 à 23:55, par Olivier
En réponse à : Doctlear vers SPIP
Bonsoir,
On m’a demandé de migrer un site Dotclaar vers Spip. Le plugin de Maïeul semble très bien faire ça et je vais l’utiliser.
Maintenant, la question qui tue : comment migrer l’album photos de ce site, géré avec le module « Gallery » de Dotclear (des dizaines d’albums, des centaines de photos, des milliers de commentaires !) ?? Je n’ai rien trouvé jusqu’à présent. Si quelqu’un a une idée, une piste, une ébauche de commencement d’indice ... je suis preneur !
Bien cordialement à tou(te)s !
# Le 12 septembre 2011 à 00:11, par Maïeul
En réponse à : Doctlear vers SPIP
a par faire ce que je fais, a savoir coder en php pour automatiser tout cela, je ne vois pas trop :-(
Répondre à ce message
# Le 24 janvier 2011 à 23:18, par Yffic
En réponse à : Doctlear vers SPIP
Salut Maïeul
Petit retour d’expérience :
Ca a été un peu laborieux car je partais d’un Dotclear 1.2.5 pour lequel j’ai du importer la base en local à l’aide de phpmyadmin (ça ne fonctionnait pas avec l’import/export de dotclear). Je n’ai d’ailleurs pas réussi à trouver l’archive zip d’une version 1.2.5.
J’ai du passer ensuite en 1.2.8 avant de pouvoir migrer en 2.2.2... Faut surtout pas essayer de raccourcir les méthodes de mise à jour décrites sur le site de dotclear sinon on perd la table des médias dc_media sur laquelle se base le présent plugin.
Lors du passage en dc2, tous les médias ont été recopié en vrac dans /public/ et donc les codes d’insertion d’images des billets étaient faux. Pour pallier à ce « désagrément », j’ai modifié la fonction dot_decomposer_chemin_media pour qu’elle renvoie $dossier=".", la valeur présente dans la table dc_media
Le champ media_upddt n’étant pas renseigné dans ma table dc_media, j’ai dû modifier le source dans dot_medias.php pour utiliser plutôt le champ media_dt
Il manque le plugin Iterateurs dans les « necessite »
Dans le cadre d’une utilisation sur un spip mutualisé, le dossier public est bien à placer au même niveau que le dossier ecrire et non dans sites/monsite
# Le 24 janvier 2011 à 23:22, par Maïeul
En réponse à : Doctlear vers SPIP
cool pour ce retour.
honnettement je crois que l’organisation de DC est tellement complexe qu’on peut pas prévoir tout les cas.
par contre ce plugin n’a pas besoin d’itrateur, vu qu’il ne l’utilise pas :p
surtout qu’il était pas sorti quand je l’ai codé
# Le 24 janvier 2011 à 23:42, par Yffic
En réponse à : Doctlear vers SPIP
Oui, c’est complexe, c’est pour ca que j’apporte ce petit témoignage, tant qu’a y avoir passé toute l’après midi autant que ca serve.
Pour Itérateur, tu as raison, je me suis sans doute un peu mélangé les pinceaux
Ah et une autre truc, les images avec des caractères accentués ou des espaces dans les noms de fichiers ne sont pas importées et y’a pas de message d’erreur. L’absence de message d’erreur est dû a Crub qui oublie de le signaler si la source n’existe pas. Dans la fonction crud_documents_create_dist, faudrait rajouter un else à if (intval($id = $id[0])). Je voudrais bien le faire mais je ne comprends rien au retour de cette fonction.
# Le 24 janvier 2011 à 23:45, par Maïeul
En réponse à : Doctlear vers SPIP
moi non plus j’y comprend rien ... faudrait envoyer un mail sur la zone
# Le 24 janvier 2011 à 23:48, par Yffic
En réponse à : Doctlear vers SPIP
Oui, je l’ai fait
Répondre à ce message
# Le 3 octobre 2010 à 19:10, par noé de naama
En réponse à : Doctlear2SPIP
A quoi sert le plugin crud ?
Je suppose qu’il s"agit d’une surcouche aux fonctionsde gestion de base de données de spip mais qu’ajoute-t-il ?
# Le 3 octobre 2010 à 19:16, par Maïeul
En réponse à : Doctlear2SPIP
le crud c’est un modèle de gestion d’objet.
Il permet (en théorie) de faire abstraction de la table pour se contenter de réflechir au contenu (si j’ai bien compris).
J’avoue ne pas trop saisir l’utilité en soi, mais on m’a conseillé fortement d’utiliser cela pour la maintenabilité à long terme du plugin.
http://www.ethnoinformatique.fr/mod/resource/view.php?id=1732
Répondre à ce message
# Le 2 octobre 2010 à 14:26, par Sergio
En réponse à : Doctlear2SPIP
Acceuil -> Accueil !
Pour la migration DC1->DC2, il faut que je trouve l’outil de migration (indisponible sur le site de CD, voir mon message dans le forum SPIP).
_
# Le 2 octobre 2010 à 18:14, par Maïeul
En réponse à : Doctlear2SPIP
jamais si dans quel ordre on place ces lettres.
# Le 2 octobre 2010 à 18:24, par Maïeul
En réponse à : Doctlear2SPIP
et pour la migration http://fr.dotclear.org/documentation/2.0/admin/1-to-2
Répondre à ce message
# Le 2 octobre 2010 à 09:28, par Sergio
En réponse à : Doctlear2SPIP
Tenté le truc...
Je suis en DC 1.2, pas de bol...
Néanmoins une faute de frappe :
« * Acceuil > * Migration Dotclear 2 SPIP »
# Le 2 octobre 2010 à 13:03, par Maïeul
En réponse à : Doctlear2SPIP
pas compris ou était la faute de frappe.
Pour migrer vers SPIp il faudra que vous migriez depuis DC 1 vers DC 2
Répondre à ce message