Étape pour changer de version de Joomla

Pour faire mes migrations de site, j'ai regardé sur le site de Joomla.


INFO : avant tout changement, faire une sauvegarde de votre site et du MySQL.

1. Vérifier que votre site puisse passer en Joomla 5.

Avant de pouvoir passer de Joomla 4.4 à Joomla 5, il faut différents critères :

• PHP 8.1
• MySQL 8.0.13
• MariaDB 10.4.x (Les tests ont montré que J3, J4 et J5 sont compatibles avec MariaDB 10.4.x.)
• PostgreSQL 12.0
• Joomla 4.4 mis à jour

Pour vérifier votre système, il faut aller dans Système -> Information système.



Il faudra aussi vérifier si les extensions sont toutes compatibles avec Joomla 5. Sinon, il faudra les effacer. Pour soit remettre la version compatible Joomla 5, soit en utiliser une autre.
Pour connaitre les extensions installées, il faut aller dans Système -> Gestion / Extensions.
Le plus simple est de vérifier 1 par 1 une extension en la cherchant dans la bibliothèque de Joomla ou sur le site du créateur de l'extension.
Le risque lors de la mise à jour, si l'extension n'est pas adaptée ? Que le site bugue, voire qu'il ne fonctionne plus. Donc là il faudra réinstaller la version sauvegardée et tout recommencer.


Note : avant de faire la mise à jour, bien vérifier que toutes les extensions sont mises à jour !

2. Préparer votre site

Faire dans l'ordre : 


– Désactiver ou désinstaller toutes les extensions non compatibles avec Joomla 5.


– Désinstaller le composant de recherche (com_search). Car il ne fonctionnera plus sur Joomla 5. Il sera remplacé par Smart Search (com_finder).


– Désactiver Google reCAPTCHA, si vous l'utilisez. Car il sera remplacé par Invisible reCAPTCHA.


– Activer le débogage dans Système -> Réglages / Configuration globale -> Système -> Débogage du système sur Oui.


– Sauvegarder encore une fois votre site et vérifier que le site fonctionne bien à cette étape.


– Aller dans Système -> Mise à jour -> Joomla

Puis cliquer en haut à droite sur Paramètres.




Puis mettre le canal de mise à jour sur "Le prochain Joomla !" Ensuite, Enregistrer & Fermer.

3. Dernière étape pour la mise à jour de Joomla 5

Là, vous aurez accès à cette page de mise à jour pour vérifier les compatibilités.





Il faudra vérifier que tout est bon, y compris les extensions. Dans mon cas, le Attention, c'est pour le fichier de langue French, pourtant il est à jour, mais pour la version 4.4. Donc pas de souci, je peux mettre à jour.





Il faut cocher sur "Je prends en compte les avertissements concernant les extensions potentiellement incompatibles et souhaite effectuer la mise à jour."
Puis sur Mise à jour.

Joomla va vous demander si vous êtes sûr, et affichera cette page pour mettre à jour vers Joomla 5.






Il faudra cocher la case : "Je possède une sauvegarde du site et suis prêt à effectuer la mise à jour." Puis sur Appliquer la mise à jour.

3. Tester votre site en frontale et en backend.

Vérifier que tout fonctionne bien.

4. Finir de configurer le Joomla 5

- Désactiver Débogage, aller dans Système -> Configuration globale -> Débogage système.


- Si besoin, installer ou activer le nouveau système de recherche.