Retour : Page Principale > sommaire aide > sommaire aide-mémos

Aide-MĂ©mo pour la migration des wikini


Actuellement la base de code mutualisée provient d'une archive déjà présente dans le dossier des wikini, nommées "yeswiki-cercopitheque-tb-sso" elle a été déplacée dans le dossier _SOURCES_.
Ce code n'est pas compatible PHP7, mais possède un style à jour (pas de problème de CSS au niveau de la boite de recherche et du bouton home) versionné là : https://github.com/telabotanica/yeswiki-theme
Une version de  YesWiki compatible PHP7 est versionnĂ© lĂ  : https://github.com/telabotanica/yeswiki
Il reste maintenant à finaliser les scripts de migration, l'objectif étant de passer tous les wikis sur du code commun, le code versionné.
Les scripts eux-mĂŞmes sont dans https://github.com/telabotanica/ep-plugin/tree/master/scripts

Le contenu de https://github.com/telabotanica/yeswiki-theme est Ă  placer dans le dossier themes/bootstrap/ ou sinon tools/templates/themes/bootstrap/ des sources.

Procédure ci-dessous périmée

L'idée est d'avoir une seule base de code symlinkée dans chaque wikini, pour la maintenabilité.


  1. Créer les dossiers suivant sur votre ordinateur :
    • ~Stockage/migration_wikini/
    • ~Stockage/migration_wikini/Archives/
  2. Récupérer le wikini _modele_ présent sur le serveur à /home/telabotap/www/wikini/yeswiki-0.2.zip dans votre dossier ~Stockage/migration_wikini/
  3. Copier le dossier du wikini à migrer présent sur le serveur dans votre dossier ~Stockage/migration_wikini/Archives/
  4. Vérifier que le contenu du wikini a été bien copié !
  5. Sur le serveur, renomer le wikini avec un ".save" Ă  la fin du nom de son dossier
  6. Copier votre dossier ~Stockage/migration_wikini/_modele_/ en le renommant avec le nom du wikini Ă  migrer
  7. Envoyer sur le serveur votre copie renomée de _modele_
  8. Rendez-vous Ă  l'adresse : http://www.tela-botanica.org/wikini/mon_wikini_entrain_d_etre_migre
  9. Suivez la procédure d'installation :
    • Adresse email du WikiAdmin : wikiadmin [at] tela-botanica [dot] org
    • Cocher "Autoriser l'insertion de HTML brut"
  10. Vous devriez être maintenant avec un wikini installé (sinon regardé la liste d'erreur possible à la fin de cette page)
  11. Renvoyer sur le serveur les Ă©ventuels dossiers : upload, files ou bibliotheque du wikini original s'ils contiennent des docs
  12. Supprimer les utilisateurs qui sont du spam (courriel terminant par @list.ru ou @mail.ru)
  13. Vider la table _links (car un bogue de wikini peut bloquer la suppression, le contenu de cette table sera recré automatiquement)
  14. Modifier le fichier wakka.config.php (voir ci-dessous)
  15. VĂ©rifier que le wikini fonctionne correctement
  16. Sur le serveur, supprimer le dossier du wikini ".save"
<?php
// wakka.config.php cr&eacute;&eacute;e Mon Mar 18 17:18:31 2013
// ne changez pas la wikini_version manuellement!

$wakkaConfig = array (
  'wakka_version' => '0.1.1',
  'wikini_version' => '0.5.0',
  'debug' => 'no',
  'mysql_host' => 'localhost',
  'mysql_database' => 'tela_prod_wikini',
  'mysql_user' => '',// ICI VOTRE UTILISATEUR SERA PRÉSENT
  'mysql_password' => '',// ICI VOTRE MOT DE PASSE SERA PRÉSENT
  'table_prefix' => 'prefixe_',// PREFIXE DU WIKINI BASÉ SUR SON NOM (voir table sql)
  'root_page' => 'PagePrincipale',
  'wakka_name' => 'NomWikini',// NOM DU WIKINI
  'base_url' => 'http://www.tela-botanica.org/wikini/site/wakka.php?wiki=',
  'rewrite_mode' => '0',
  'meta_keywords' => '',// VOS MOTS CLÉS
  'meta_description' => '',// VOTRE DESCRIPTION
  'action_path' => 'actions',
  'handler_path' => 'handlers',
  'header_action' => 'header',
  'footer_action' => 'footer',
  'navigation_links' => 'DerniersChangements :: DerniersCommentaires :: ParametresUtilisateur',
  'referrers_purge_time' => 1000000,
  'pages_purge_time' => 1000000,
  'default_write_acl' => '+',// LIGNE MODIFIÉE : +
  'default_read_acl' => '*',
  'default_comment_acl' => '+',// LIGNE MODIFIÉE : +
  'preview_before_save' => '0',
  'allow_raw_html' => '1',
  'favorite_theme' => 'bootstrap',// LIGNE AJOUTÉE
  'favorite_style' => 'telabotanica.css',// LIGNE AJOUTÉE
  'favorite_squelette' => '2cols-left-tb.tpl.html',// LIGNE AJOUTÉE
  'hide_action_template' => ''// LIGNE AJOUTÉE
);
?>


Erreur : Creation compte admin ... ECHEC Fin de l'installation.
Il faut supprimer le compte WikiAdmin de la table users et triple.

Wikini migrĂ©s vers  YesWiki 0.2
Voir la liste des wikini migrés sur la page d'index des wikini installés.

Wikini supprimés ;
  • ambroisie
  • carnetenlignevdeux
  • floratest
  • FloreElectronique
  • Coste
  • Cucurbitaceae
  • Daniel
  • flora
  • outilsterrain
  • phototheque
  • ProtocoleIdentiplante
  • RefBryo

Nouveau wikini :
  • floreafriqueouest
  • gdr-parcs
  • AnimateursSauvages

Amélioration des tools développés par Tela Botanica
TODO :
Sur l'action de gestion des utilisateurs :
  • pouvoir supprimer toutes les anciennes pages d'un utilisateur
  • ajouter les action dans le log du wikiadmin

Thèmes graphiques

Le thème graphique est défini pour l'ensemble du wiki, mais il peut être redéfini pour chaque page (config stockée dans la BDD). Ainsi, il est possible que même avec un code source tout frais et à jour, un wiki tente de charger un ancien thème sur certaines pages.
Pour forcer l'utilisation du thème par défaut, ajouter ceci dans la config :
'hide_action_template' => '1'

Pour plus d'informations : https://yeswiki.net/wakka.php?wiki=DocumentationChangerThemeGraphique

Migration ponctuelle d'un très vieux wikini

Une procédure de mise à jour automatique existe pour les très vieilles versions de wikini/yeswiki. Dans un tel cas (ex: wiki "stages" de l'intranet) :
  • remplacer le code source du wiki par le nouveau, mais conserver la config de l'ancien
  • dans la config de l'ancien, ne modifier que base_url et mysql_* si nĂ©cessaire
  • afficher la page d'accueil du wiki
  • remplir le formulaire, valider, et PAF un wiki tout neuf avec le thème par dĂ©faut.

Attention cela ne marche pas si la wikini_version est trop récente.