Joomla 1.5 vers 4 : planification et migration étape par étape

Passer de Joomla! 1.5 à 4.x est considéré comme une migration majeure. Cela signifie que des changements considérables dans le fonctionnement de Joomla, les tables, la technologie se sont produits, nécessitant une migration plutôt qu'une mise à niveau ou une mise à jour. Les extensions du noyau de Joomla ainsi que toutes les extensions tierces devront migrer vers Joomla 4.x. Cela inclut le template du site. Chaque élément doit être examiné, planifié, décidé et exécuté. Vous devrez faire preuve de rigueur pour rester organisé tout au long du processus.

Intro

Le point formidable avec la migration, c'est que c'est un excellent moment pour réévaluer les objectifs, créer un nouveau look (template), faire le ménage et développer d'autres zones/éléments de votre site. Plus vous êtes organisé dans vos idées/réflexions/plans, mieux c'est. Planifier facilite l'exécution.

Commencez à planifier en vous posant les questions suivantes ou en effectuant les tâches listées ci-dessous. Vous pourriez avoir d'autres éléments à planifier selon la complexité de votre site. Malheureusement, il n'est pas possible de lister tous les scénarios possibles.

Planning Action Items

Général

1. Évaluez les objectifs initiaux de votre site. La migration est l'occasion de se recentrer sur vos objectifs ou de changer de direction.
2. Votre serveur répond-il aux exigences techniques minimales pour Joomla 4 ? Si ce n'est pas le cas, vous devrez changer d'hébergeur. Il n'y a pas de meilleur moment pour changer d'hébergeur que pendant une migration.
3. Quel type d'environnement de développement utiliserez-vous ? Un environnement de développement sur votre appareil local ? Un sous-domaine ou un sous-répertoire sur votre serveur ? Un nouveau serveur/compte d'hébergement en raison des spécifications techniques ?

Joomla Core

1. Nettoyez votre site actuel. Jetez un œil à vos sections, catégories et articles. Les sections sont converties en catégories de niveau supérieur depuis Joomla 2.5. Y a-t-il un nettoyage à effectuer pour ne pas migrer de contenu inutile ? Documentez ce que vous souhaitez supprimer. Vous pouvez également préférer documenter ce que vous souhaitez conserver selon la quantité.
2. Organisez le contenu de votre site actuel. Les catégories que vous avez s'appliquent-elles toujours ? Documentez les nouvelles catégories que vous souhaitez ajouter sur votre nouveau site.
3. Avez-vous des articles dans la corbeille ? Si oui, supprimez-les (ainsi que tout média associé qui ne serait pas utilisé ailleurs sur le site). Les articles (ainsi que les catégories et les liens de menu) laissés dans la corbeille peuvent causer des problèmes de doublons d'alias une fois migrés.
4. Le gestionnaire de médias : Décidez si vous souhaitez transférer l'intégralité de votre répertoire /images ou seulement une partie. Si votre gestionnaire de médias est devenu un désastre, vous pouvez choisir de transférer des images spécifiques via FTP ou cPanel plutôt que de migrer tout le répertoire. À l'avenir, organisez les dossiers dans le gestionnaire de médias afin d'éviter de vous retrouver avec un grand désordre.
5. Si vous utilisez des composants du noyau comme les contacts Joomla, les liens web ou les fils d'actualités, documentez-le car vous devrez les transférer.
6. Vérifiez vos menus et déterminez si vous allez tous les transférer ou seulement des menus et liens de menu spécifiques. Supprimez tout lien de menu de la corbeille pour éviter les doublons d'alias.
7. Si vous repensez ou modifiez la conception ou la navigation de votre site, aurez-vous des pages obsolètes nécessitant une redirection ? Suivez toutes les URL nécessitant des redirections dans un tableur ou un bloc-notes.
8. Avez-vous « piraté le cœur » de votre site 1.5 ? Si c'est le cas, ces modifications ne seront pas migrées vers Joomla 4. Vous devrez trouver des alternatives au piratage du cœur dans Joomla 4 (Understanding Output Overrides, Layout Overrides in Joomla).
9. Vérifiez votre gestionnaire d'utilisateurs. Avez-vous l'intention de tous les transférer ? Un nettoyage est-il nécessaire ? Peut-être des super utilisateurs qui ne devraient plus avoir accès ou des utilisateurs spammeurs à supprimer ? Utilisez-vous une extension tierce pour améliorer les profils utilisateurs ? Cette partie nécessite une planification minutieuse, surtout si les données utilisateur changent fréquemment.
10. Y a-t-il de nouvelles fonctionnalités de Joomla que vous souhaitez utiliser, telles que les niveaux de contrôle d'accès (ACL), les étiquettes, les flux de travail ou les champs personnalisés ? Commencez dès maintenant à planifier cela. La planification des ACL est une affaire délicate. Il est très important d'être minutieux.

Extensions tierces

1. Dressez une liste de toutes les extensions tierces utilisées. Cela comprend les composants, les modules, les plugins, les langues et les templates. Vous pouvez les copier/coller depuis la page Gestion dans un document pour référence si vous le souhaitez. Une feuille de papier et un stylo suffiront. Indiquez si ces extensions sont utilisées intensivement, modérément, rarement ou pas du tout.
2. Déterminez si les extensions tierces dont vous dépendez sont prêtes pour Joomla 4.
3. Déterminez si vous avez vraiment besoin de toutes les extensions que vous utilisez. Peut-être que Joomla 4 dispose de fonctionnalités intégrées qui pourraient éliminer le besoin de l'extension tierce.
4. Qu'en est-il de votre template de site ? Si vous avez acheté votre template auprès d'une source tierce, existe-t-il une version 4.x publiée pour celui-ci ? Souhaitez-vous continuer à l'utiliser ? Y a-t-il un chemin de migration publié par le développeur ? La nouvelle version est-elle responsive ? Votre template est-il un template personnalisé ? Ou a-t-il été fortement personnalisé à partir d'un template tiers ? Pour en savoir plus sur les considérations liées aux templates, voir Template Considerations During Migration.
5. Si vous changez de template pour en adopter un nouveau, nécessitera-t-il de nouvelles images ? Par exemple, si votre site actuel a un arrière-plan blanc et que votre logo ou d'autres images sont des fichiers .jpg avec un arrière-plan blanc, cela ne rendra pas très bien sur un nouveau template avec un arrière-plan blanc cassé ou coloré.

Voici les instructions étape par étape pour migrer votre site 1.5 vers Joomla 4.x. Bien qu'il existe de nombreuses façons de migrer votre site, celles-ci vous donneront la procédure de base à suivre.

Introduction

La migration de Joomla! 1.5 vers 4.x est une migration majeure. Il y a de nombreux changements dans les fonctionnalités et les tables de base de données entre ces deux versions. Ce n'est pas une mise à jour en un clic. Vous allez construire et installer une nouvelle installation de Joomla! 4, puis migrer (déplacer) vos données vers celle-ci. Si vous ne l'avez pas déjà fait, vous voudrez peut-être commencer par le document Self Assessment.

Distinguons d'abord les données du cœur de Joomla des données des extensions tierces. Les données du cœur de Joomla (composants) sont :

• Catégories
• Articles
• Menus
• Modules (modules du cœur - pas les modules tiers)
• Bannières
• Contacts
• Messagerie
• Fils d'actualité
• Redirection
• Rechercher
• Recherche avancée

Étape par étape

Déplacer les données du cœur de Joomla est assez simple avec l'utilisation d'un outil de migration. Tout le reste est une extension tierce ou une extension personnalisée. Cela inclut le template. Chaque extension tierce doit faire l'objet de recherches pour déterminer si elle est prête pour Joomla 4.x et si elle dispose d'un chemin de migration. Vous avez peut-être déjà fait cela dans le processus de planification ci-dessus. Si ce n'est pas le cas, faites-le maintenant. Certaines extensions tierces peuvent être migrées avec un outil tiers. D'autres non. Lisez. Recherchez. Planifiez.

Comme il existe de nombreuses façons de migrer des données et que chaque site est différent, les étapes exactes seront légèrement différentes pour chaque site.

Préparer un Emplacement pour Joomla 4

1. Assurez-vous que votre environnement serveur répond aux exigences techniques pour Joomla! 4 avant de poursuivre.
   Remarque Si votre hébergeur ne répond pas aux exigences techniques, vous devrez changer d'hébergeur. Si vous devez changer d'hébergeur, configurez un nouveau compte d'hébergement chez un hébergeur qui répond aux spécifications et installez votre site Joomla 4.x fraîchement installé à la racine du serveur sur un domaine temporaire. Cela facilitera les choses au moment de la mise en ligne. Vous pouvez également configurer un Emplacement de développement sur un appareil local. (Voir ci-dessous.)
2. Créez une nouvelle base de données et un nouvel utilisateur pour votre site Joomla! 4.x. Notez le nom de la base de données, l'Identifiant de la base de données et le mot de passe de la base de données, car vous en aurez besoin lors de l'installation de Joomla 4.

Configurer un Emplacement de Développement

1. Créez un site de test ou une zone de construction pour travailler avec l'une des options suivantes :
   • Un sous-domaine
   • Un sous-répertoire
   • Un appareil local via WAMP, MAMP, LAMP, XAMPP.
   • Un nouveau compte d'hébergement sur un domaine temporaire à la racine (si vous souhaitez changer d'hébergeur pendant le processus de migration)
     • Restaurer un site sur un appareil local. Voir Installer Joomla en local et Configurer votre poste de travail pour le développement Joomla.
     • Restaurer un site avec Akeeba Backup. (Lisez la documentation pour développeurs ou regardez les vidéos expliquant comment restaurer une sauvegarde à partir d'un fichier Akeeba Backup.)
2. Installer une nouvelle installation de la dernière version de Joomla 4.x dans l'emplacement de votre site de test en utilisant le nom de votre nouvelle base de données et les identifiants correspondants.
   Ne pas installer les données d'exemple.
   Remarque Si vous migrez des extensions principales qui seront découplées de Joomla! 3.4+, vous devrez installer Joomla 4.x et l'extension prise en charge par le noyau. Les extensions principales prises en charge seront accessibles via le Répertoire des extensions Joomla et via l'onglet Installer depuis le web du Gestionnaire d'extensions. Assurez-vous d'installer toutes les extensions principales prises en charge avant de migrer les données. Consultez la feuille de route du projet pour plus de détails sur ce qui sera découplé/supprimé. En août 2021, seuls les Liens Web ont été découplés.
3. Effectuer une sauvegarde de votre site Joomla 4. (Les bases de la sauvegarde pour un site web Joomla! ou voir Outils suggérés)

Préparer Votre Site 1.5 Actuel

1. Sur votre site 1.5, mettez-le à jour vers la dernière version 1.5.26 après l'avoir sauvegardé.
2. Nettoyer vos sections, catégories, articles, modules, liens de menu. Assurez-vous qu'ils ont tous des alias uniques.
3. Vider la corbeille dans le gestionnaire de contenu (sections, catégories, articles), le gestionnaire de menus, le gestionnaire de modules.
   Remarque Les sections n'existent plus dans Joomla 4. Les sections deviennent une catégorie parente. Les catégories deviennent des catégories imbriquées de la catégorie parente.
4. Prévenir les utilisateurs que toute modification apportée au site actuel à partir de ce moment devra être ressaisie sur le nouveau site. Pour les migrations complexes avec des données changeantes, voir l'article de magazine Complex Joomla! 1.5 Migration With Minimal Downtime et la vidéo Complex Migrations.

Choisir un Outil de Migration

1. Il existe de nombreux outils de migration. Certains sont gratuits, d'autres coûtent un peu d'argent. Certains ne migrent que certaines données. Certains migrent plus de types de données que d'autres.
2. Les outils de migration se trouvent dans la catégorie Migration & Conversion du Répertoire d'Extensions Joomla.
3. Vérifier que l'outil de migration candidat a été mis à jour pour fonctionner avec Joomla 4.
4. Chaque outil de migration dispose de sa propre documentation étape par étape sur la façon de déplacer les données. (S'il n'en dispose pas, ne l'utilisez pas.) Certains outils de migration nécessiteront que le site 1.5 et le site 4 soient sur le même serveur. Si vous changez d'hébergeur, vous voudrez restaurer un *sous-domaine* de votre site 1.5 sur votre nouveau compte d'hébergement pour en extraire les données. Supprimez-le ensuite une fois terminé.
5. Lorsque vous choisissez un outil, sélectionnez-en un qui permet de préserver les ItemID. Ceci est nécessaire pour conserver intact votre classement dans les moteurs de recherche, sinon vous devrez faire plus de redirections. Plus d'informations sur les redirections suivent.
6. Si vous avez un petit site, vous pouvez faire la migration manuellement. Créez des catégories et des articles et copiez le code HTML dans votre nouveau site. Copiez ensuite le répertoire des images. Conservez le répertoire /stories (qui n'est plus le répertoire d'images par défaut dans Joomla 4.x), sinon vos liens d'images seront cassés jusqu'à ce que vous les corrigiez un par un.
7. L'un des outils de migration (un gratuit) permet d'importer les articles et uniquement les images associées à ces articles. Ceci est utile si votre Gestionnaire de médias est hors de contrôle.

Migration

1. Migrer toutes les données principales que vous souhaitez déplacer vers Joomla 4.x. Si votre outil de migration demande à déplacer les Sections et Catégories, faites absolument les deux. La conversion s'effectuera automatiquement sur les catégories et les catégories imbriquées.
2. Exécutez la correction de la base de données en allant dans Gestionnaire d'Extensions → Base de données et en cliquant sur le bouton Corriger dans la barre d'outils supérieure.
3. Installez votre nouveau template ou votre template converti afin de pouvoir voir votre contenu. Voir plus d'informations sur les Considérations relatives aux templates.
4. Ajoutez de nouveaux menus si l'outil que vous avez choisi d'utiliser n'a pas importé les menus. Si vous souhaitez utiliser des menus divisés, configurez-les maintenant.
5. Ajoutez des modules si l'outil que vous avez choisi d'utiliser n'a pas importé les modules. Si l'outil que vous avez choisi d'utiliser a importé les modules, changez les positions de module pour celles de votre nouveau template si nécessaire afin que vos modules s'affichent et que vous puissiez voir ce sur quoi vous travaillez.
6. Vérifiez les problèmes d'alias en double et corrigez-les.
7. Vérifiez vos liens internes. Si certains sont cassés, corrigez-les.
8. Effectuez une sauvegarde.
9. Installez d'autres extensions tierces et configurez-les. (Par exemple des éditeurs, Akeeba backup, des diaporamas, ou des plugins.)
10. Effectuez une sauvegarde.
11. Si vous avez de grosses extensions avec des données à migrer, faites chacune d'elles selon la documentation du développeur, puis effectuez une sauvegarde après chacune d'elles.
12. Si votre outil de migration n'a pas déplacé les images, vous voudrez déplacer vos images du site 1.5 vers le site 4.x. Remarque : conservez le répertoire /stories à moins que vous ne vouliez relier toutes vos images. Vous pouvez démarrer une nouvelle structure organisationnelle dans le répertoire /images à partir de maintenant si stories est en désordre.
13. Recommandé mais non obligatoire sauf en cas de problème : Corriger les problèmes d'assets. Voir ci-dessous pour un outil utile.
14. Si vous prévoyez d'ajouter quoi que ce soit à votre site ou d'utiliser de nouvelles fonctionnalités du noyau telles que les Étiquettes ou les Champs personnalisés, configurez-les dès maintenant.
15. Vérifiez vos URL sur le site Joomla 4 et comparez-les à celles du site Joomla 1.5. Si elles sont différentes, documentez chaque URL 1.5 et l'URL Joomla 4.x correspondante afin de pouvoir effectuer des redirections et conserver votre classement. (Un tableur Excel est utile pour cela.) Voir :
    • Migration SEO Tips Series - Part 1 - Planning Your Link Migration Strategy ; et
    • Migration SEO Tips Series - Part 2 - Monitoring Your Migrated Site's Health.
16. Faites une sauvegarde.
17. Vérifiez tout.
18. Nettoyez davantage.
19. Testez tout.
20. Faites une sauvegarde.
21. Déplacez, modifiez ou ajoutez des données mises à jour du site 1.5 vers le site Joomla 4.
22. Ajoutez Google Analytics au template ou utilisez un plugin tiers.
23. Vérifiez la Configuration Générale et assurez-vous que tout est comme il se doit.
24. Faites une sauvegarde finale du site Joomla 4.x.
25. Faites une sauvegarde finale du site 1.5.
26. Déplacez votre site 1.5 de la racine vers un autre sous-domaine ou sous-répertoire, ou supprimez-le simplement. (Cela vous permet de le conserver brièvement au cas où vous auriez besoin de vous y référer.)
27. Sauvegardez et restaurez en utilisant un outil suggéré (ci-dessous) ou déplacez simplement les fichiers pour restaurer votre site 4.x à la racine de votre hébergement.
    Remarque Si vous changez d'hébergeur, vous pouvez laisser votre site Joomla 4.x où il se trouve et simplement modifier les serveurs de noms du domaine pour le mettre en ligne. Assurez-vous d'avoir résolu au préalable tout problème lié aux e-mails.
28. Activez .htaccess si nécessaire pour des URL conviviales pour les moteurs de recherche.
29. Créez un plan de site et soumettez-le à Google Webmaster Tools ou à tout autre moteur de recherche de votre choix.
30. Effectuez toutes les redirections à partir du tableur que vous avez créé précédemment pour les URL modifiées lors du processus de migration.
31. Apportez toute autre modification qui devait attendre la mise en ligne du site 4.x.
32. Testez à nouveau.
33. Faites une autre sauvegarde.
34. Supprimez toute(s) instance(s) du site 1.5 dès que possible.
35. Supprimez tous les autres sites de développement avec lesquels vous avez pu travailler, ou maintenez-les à jour s'ils exécutent une version actuelle, afin d'éviter les tentatives de piratage sur votre serveur.
36. Bienvenue sur Joomla! 4.x!

Outils suggérés

• Akeeba Backup pour la sauvegarde et la restauration.
• PWT ACL pour corriger les problèmes d'assets en quelques clics.