Guppy 6 : Aide pour migrer vers la version 6 de Guppy
Migration vers la version 6.00.04
Mise à jour de votre GuppyEcole 5.03.03
ATTENTION ! Cela ne concerne que les sites GUPPY en version 5.03.03 !
Si votre site est sous une autre version 5, vous devez appliquer le patch cumulatif 5.03.03 ou le patch non-cumulatif 5.03.03 pour passer votre site à la version 5.03.03.
C'est à partir de cette version 5.03.03 que vous pourrez alors effectuer la migration.
Télécharger patch cumulatif 5.03.03
Télécharger patch non cumulatif 5.03.03
Accéder à l'aide pour passer en Version 5.03.03
1. COMMENT MIGRER en V6.00.04 ?
La migration vers la version 6 ne peut pas se faire en ligne chez votre hébergeur, mais seulement en local sur votre ordinateur.
Pour cela vous devrez installer un logiciel qui permet de créer un serveur web virtuel sur votre ordinateur. La GuppyTeam vous recommande le logiciel WAMP.
Lien pour télécharger WAMP, lien vers le site officiel : https://www.wampserver.com/
Aide pour installer et configurer WAMP, ici sur centre d'aide de freeguppy.org
ALLEZ, AU BOULOT !
1. Préparez l'espace de travail :
Pour pouvoir travailler en local avec WAMP, vous devez préparer le terrain ! Dans le dossier www de WAMP, créez 2 dossiers, un qui recevra votre site en V5.03.03 que vous nommez par ex : monsiteV5amigrer et un second dossier qui lui recevra le nouveau pack Guppy6.01 pour pouvoir effectuer votre migration, que vous nommez par ex : guppy6pourmigrer.
C'est dans ce dernier dossier que, après migration, vous retrouverez votre nouveau site migré en V6 de Guppy.
2. Rapatriez votre site en V5.03.03 depuis votre serveur sur votre hébergeur par FTP sur votre ordi avec tous les dossiers et fichiers sur votre ordi dans le dossier créé dans WAMP selon mon exemple ci-dessus : monsiteV5amigrer.
Désactivez les fichiers .htaccess : Entrer dans ce dossier une fois que tous les fichiers et dossiers de votre site y sont présents. A la racine du dossier, désactivez le fichier de sécurité .htaccess en le nommant par exemple .htaccess_original. Faites de même, avec le fichier .htaccess présent dans le dossier admin. Ces fichiers sont inutiles sous WAMP et ils vous empêcheront d'afficher le site en local et de vous connecter à l'admin.
3. Téléchargez le pack complet de Guppy 6.00.04 et décompressez-le dossier .zip dans le dossier nommé : guppy6pourmigrer dans www de WAMP, . ATTENTION : veillez à ce que votre logiciel de décompression ne crée pas un dossier guppy604 dans le dossier guppy6pourmigrer. Si c'est le cas, récupérez tout le contenu du dossier guppy6.00.04 généré par le logiciel de décompression et copiez-collez-le dans le dossier guppy6pourmigrer. Supprimez alors le dossier vide guppy6.00.04
Désactivez comme précédemment les 2 .htaccess.
Téléchargez le pack complet Guppy6.00.04
4. Créer les 2 serveurs locaux virtuels (localhosts ou Virtual Host) dans WAMP
Lancez WAMP et attendre que l'icône WAMP en bas dans la barre des tâches soit verte.
Cliquez sur cette icône avec le bouton de gauche de la souris pour en ouvrir le menu.
Cliquez sur Localhost :
Le navigateur se lance et ouvre la page d'accueil de WAMP.
A noter que vous pouvez également ouvrir cette page en écrivant localhost dans la barre d'adresses URL de votre navigateur (Wamp doit être lancé).
Vous arrivez donc sur la page d'accueil de Wamp, vous cliquez en bas à gauche dans le menu Outils, sur Ajouter un Virtual Host. :
La page de création de Virtual Host s'affiche.
Dans la zone du bas vous voyez 3 lignes :
Vous allez créer le Virtual Host pour le premier dossier créé plus haut (celui où il y a votre site en V5.03.03) dans wwww, nommé selon mon exemple : monsiteV5amigrer.
Dans la ligne rouge "Nom du Virtuel Host" vous écrivez : monsiteV5amigrer Sans caractère spécial, sans espace. Il s'agit du nom tout simplement.
Dans la ligne rouge du dessous,"Chemin complet absolu du dossier Virtual Host". Donc vous écrivez le chemin absolu de votre dossier monsiteV5amigrer, c'est à dire son adresse sur votre disque dur pour que le serveur virtuel puisse le retrouver.
Moi mon disque dur se nomme E et non C, alors je vais écrire dans cette zone :
E:\programmes\wamp\www\monsiteV5amigrer
E est le nom de mon disque, programmes est le dossier où j'installe tous mes programmes, dont WAMP.
Attention en écriture du chemin absolu vous utilisez "l'antislash" \ et non le "slash"/. Cela vous servira aussi pour la migration avec Guppy. On y viendra !
Une astuce sous Windows pour copier l'adresse du chemin absolu d'un dossier : vous ouvrez l'explorateur de fichiers Windows (raccourci clavier touche windows + E), vous descendez jusqu'à votre dossier dans WAMP : monsiteV5amigrer.
Vous ouvrez ce dossier,
puis dans la barre d'adresse du haut de l'explorateur, vous cliquez sur l'adresse avec le bouton de gauche, puis sur Copier l'adresse.
Ensuite vous n'avez plus qu'à coller l'adresse pour créer votre Virtual Host dans WAMP, et voilà ! Cela vous sera aussi très utile pour la migration.
Sur la ligne verte, pas besoin d'écrire quelque chose.
Voilà ce que vous devez avoir écrit (bien-sûr avec votre chemin absolu à vous) :
Vous cliquez enfin sur le bouton à droite : Démarrez la création du VirtualHost. Comme indiqué cela peut prendre un peu de temps. En général c'est très rapide.
Une nouvelle page se charge, vous indiquant que votre Virtual Host est créé. Youpi !
Ensuite WAMP vous invite à actualiser les DNS (Domain Name System, ou Système de noms de domaine en français). Vous suivez les indications. Sur l'cône de WAMP dans la barre des tâches, un clic à droite pour afficher le menu et vous cliquez sur Outils,
puis sur Redémarrage des DNS tout en haut de la longue liste qui s'affiche.
Et là vous ne touchez plus à rien, vous attendez que le système travaille, l'icône de WAMP est orange.Cela prend un peu plus de temps que la création, quelques secondes. Vous attendez tout simplement que le voyant repasse au vert.
Vous revenez sur la page d'accueil de WAMP et vous voyez à droite dans la liste Vos Virtualhost, le nom du vôtre :
Maintenant, vous procédez de même pour la création du Virtual Host du second dossier nommé dans mon exemple : guppy6pourmigrer, celui où il y a le nouveau pack Guppy 6.00.04
5. Migration en V6.00.04
Voilà, on y est ! en 8 étapes décrites ci-dessous.
Tout d'abord, concernant votre site en V50303 sur le serveur local :
Laissez WAMP lancé, allez sur la page d'accueil de WAMP et cliquez sur votre VirtualHost pour afficher votre site en V5.03.03, dans mon exemple : monsiteV5amigrer
►1. Entrez dans l'admin de votre site V5.03.03 puis Administration Générale>>Config Générale.
Guppy vous invite à sélectionner la bonne URL du site en local. Faites-le..Dans mon exemple, ce sera : http://monsiteV5amigrer
►2. Puis toujours dans Admin Générale>> Contrôle d'intégrité.DB
Lancez un contrôle d'intégrité de la Base de Données: il ne doit pas y avoir d'erreur.
►3. Notez bien et vérifiez bien vos identifiants pseudo et mot de passe sur ce site en V5.03.03 en tant qu'admin principal, ainsi que le mail, vous en aurez besoin pour migrer vers Guppy6.00.04
Maintenant le site en local Guppy 6.00.0x.
►4. Afficher le site en V6.00.0x. A partir de la page d'accueil de WAMP, cliquez sur le second Virtual Host que vous avez fait auparavant pour le site Guppy 6.0.x nommé dans mon exemple : guppy6pourmigrer.
Le site s'affiche et une énorme popup jaune s'affiche !
►5.Se déclarer administrateur principal et s'inscrire en tant que membre : Remplissez les champs dans la popup jaune avec les mêmes identifiants que pour votre site à migrer en V5.03.03 !!!! : même Pseudo - même Mot de passe - Vérification du mot de passe - même Courriel. Puis validez.
Vous êtes maintenant redirigé(e) vers le formulaire de connexion : Devenir membre.
Vous vous inscrivez en tant que membre, mais ATTENTION ! Encore et toujours ! Vous devez saisir les mêmes pseudo et mot de passe absolument identiques !
Un bref message d'accueil vous souhaitant la bienvenue apparait, puis le site affiche les préférences de votre compte : pseudo - courriel ... Certains éléments non renseignés sont à compléter si vous le souhaitez. Pour cela vous cliquez sur le bouton Modifier. Vous complétez votre compte et vous cliquez enfin sur Enregistrer.
Vous avez maintenant accès à l'administration de votre site.
►6. Rendez-vous à l'administration pour saisir la bonne URL de ce site local : cliquez en haut à droite sur le bouton d'administration ou sur Admin dans la barre de menu de navigation.
Une popup d'avertissement s'affiche vous invitant à aller en configuration générale pour corriger l'URL locale de votre site. Cliquez sur la roue dentée.
Cliquez ensuite sur la bonne URL donnée par Guppy dans le ruban jaune. Puis enregistrez.
Concernant l'admin principal vous n'avez plus rien à modifier.
►7. Migration : on y est ! En plusieurs temps :
Toujours dans l'administration, cliquer sur la gauche sur le bouton jaune Install.
Suivez bien les indications !
Cliquez sur Allons-y !
→Installation propre
D'abord, pour supprimer tous les contenus de démo, faites une installation propre, en cochant Installation propre :
Vous obtenez :
→ Migration :
Sur la page qui s'affiche, cochez Migration des données de votre site en version 5
Cliquez sur Allons-y.
Une page s'affiche vous demandant de saisir l'URL du site à migrer. Je vous rappelle, que nous sommes en local, qu'il faut alors saisir le chemin absolu de votre dossier monsiteV5amigrer dont le chemin absolu dans mon exemple est :
E:\programmes\wamp\www\monsiteV5amigrer
et ATTENTION ! pour que ça marche, n'oubliez pas un antislash A LA FIN DE CETTE ADRESSE, soit :
E:\programmes\wamp\www\monsiteV5amigrer\
(Rappelez-vous l'astuce pour récupérer le chemin complet du dossier en ouvrant l'explorateur de fichiers Windows décrit plus haut, mais rajoutez un antislash à la fin quand même !)
Vous cliquez sur Suivant.
Une autre page s'affiche et la migration commence.
Les dossiers sont transférés 1 à 1 :
Une autre page se charge automatiquement ensuite vous annonçant que la migration est terminée ! Youpi !
Vous cliquez sur suivant et vous choisissez de revenir à la page d'accueil de votre site. Vous désinstallerez le fichier Install en dernier.
►8. Reconfigurer la skin, les boites pour enlever tous les messages Warning et revérifiez tous les précédents réglages des services.
Des messages "WARNING" en pagaille. Pas d'affolement, la plupart sont liés aux positions des boites.
→Allez en admin >> Config thème
Remettez votre skin. Moi j'ai toujours eu No skin qui s'affiche par défaut après une migration, je remets donc ma skin pour Guupy 5. Puis enregistrez.
Déjà quelques messages Warning en moins !
→Allez en Admin>>Config Boites et Config Accueil,sans oublier Config Accueil Blog pour corriger l'affichage des boites. Désormais on ne partage plus la largeur de la page en % mais en nombre de colonnes : 12 colonnes pour la largeur totale.
Vous changez donc toutes les valeurs : 100% valent 12, 50% valent 6, 30% valent 4... Il suffit de ne pas dépasser 12. Vous pouvez aussi comme auparavant laisser une valeur pour une boite sur une seule ligne à 3 et rien d'autre sur cette ligne.
→Admin>>Config services, allez tout vérifier ainsi que Config Section.
→Pour la skin qui est activée, allez dans config look pour Enregistrer la config, puis dans Config Style : Cliquez sur Modifier Style pour styleplus.css, mobstyle.css ainsi que pour chacune des pages secondaires : stylepage1.css, stylepage2.css etc.
→Langue du site. Dans Config Générale : si besoin supprimez la deuxième langue.
Maintenant, il ne devrait plus y avoir de messages sauf pour les boites des plugins qui ne sont pas encore mis à jour !
C'est le cas pour le Guppyecole concernant le plugin OPen Fiches qui engendre ces messages.
Le plugin Quizz+, doit aussi être mis à jour.
2. Comment mettre à jour les 2 plugins de votre GuppyEcole migré en V6.00.04 : Open Fiches et Quizz :
Ces 2 plugins ont été mis à jour
- openfiches version 8 du 12 Janvier 2021 (merci à Linuxmr https://www.randosnormandes.info/
- quizz + 6 de décembre 2020 (merci à Saxbar, malheureusement disparu début 2021, de la GuppYTeam et porteur du projet GuppY6) .
Téléchargez le plugin sur le site du développeur du plugin
Pour Openfiches :
https://www.randosnormandes.info/
et pour Quizz, maintenu par Papinou
https://www.saxbar.guppyland.org/
puis installez ces mises à jour avec la fonction Installer présente dans l'admin de Guppy.
Revérifiez tous les réglages des plugins.
Tout est maintenant rentré dans l'ordre et plus de messages Warning.
BRAVO ! Votre site est maintenant en Version 6.00.04.
Merci à tous les participants à cette version de Guppy.
Lavachequireve - GuppyTeam
