De Joomla non supporté à Joomla 6
Mettre à jour un site Joomla de trois versions majeures, une marche à la fois, sans casser une seule adresse ni perdre un abonné à la newsletter : des milliers d'articles d'archive, six variantes graphiques régionales et des pages qui mettaient parfois huit secondes à s'ouvrir. Le cas : le site d'une association nationale avec des délégués dans six régions, resté pendant des années sur une version de Joomla sortie du support.
Le point de départ
Joomla 3 sur PHP 7.4 : deux technologies qui ne reçoivent plus de correctifs de sécurité. Par-dessus tournait un template d'un éditeur de logiciels qui avait fermé le projet en 2019, avec sept variantes graphiques (une neutre et six régionales) qui n'étaient pas de la décoration : elles soutenaient le flux par lequel les délégués publient les actualités de leur territoire.
À côté, une quantité d'extensions mortes : un système d'articles alternatif jamais porté sur Joomla 4, un composant de newsletter vieux de deux générations, des galeries photo issues d'une installation WordPress encore antérieure. Et une archive de milliers d'articles, chacun avec son adresse web que Google connaît depuis des années.
Le choix de cap
Deux voies étaient possibles : construire un nouveau site et y transvaser les contenus, ou mettre à jour par étapes une copie du site existant. C'est la seconde qui a été choisie : 3.10 → 4.4 → 5.4 → 6.1, une marche à la fois.
La raison est concrète : chaque contenu a un numéro interne et une adresse web que le nouveau site doit conserver, faute de quoi, au moment du basculement, des milliers de liens se cassent et la position gagnée sur Google est perdue. La mise à jour par étapes préserve ces références ; le transvasement, non.
Le travail a été fait sur une copie, à une adresse de test et avec une base de données séparée : le vrai site n'a pas été touché jusqu'au jour du déménagement. Avant le saut vers Joomla 4, toutes les extensions sans avenir ont été désinstallées, car une mise à jour contenant des composants incompatibles plante à mi-chemin.
Le template et les six régions
Le nouveau template est un « template enfant » de Cassiopeia, celui livré de série avec Joomla : il hérite de tout du parent et n'y ajoute que les différences, de sorte que les mises à jour futures n'effacent pas le travail accompli.
Pour les six variantes régionales, la solution évidente aurait été six styles de template. Elle a été écartée, et c'est le choix technique le plus intéressant du projet. Dans Joomla, un style s'attribue à un élément de menu : il aurait coloré les pages régionales, mais pas celles des articles individuels, qui n'ont pas d'élément de menu propre. Un lecteur serait entré par la page de sa région, colorée, et en cliquant sur une actualité il aurait atterri sur une page générique.
La variante a donc été rattachée à la catégorie du contenu : le template calcule à quelle région appartient la page qu'il s'apprête à afficher et applique la bonne palette, le bandeau avec le nom de la région, les en-têtes. Cela fonctionne partout, y compris dans les fiches des articles individuels.
Les droits des délégués
Ici, le travail a porté sur des règles, non sur du graphisme. Chaque région a son groupe d'utilisateurs et son niveau d'accès ; chaque groupe peut créer et corriger des actualités uniquement dans sa propre catégorie, et ne peut pas les publier : elles restent en attente jusqu'à ce que la rédaction nationale les approuve.
En contrôlant le dispositif hérité, deux vrais défauts sont apparus : les groupes régionaux avaient un droit général qui leur permettait de fait de publier n'importe quel article du site, et un groupe avait des droits aussi sur la catégorie d'une autre région. Les deux ont été corrigés, avec le droit de créer des articles retiré à la racine et réattribué uniquement là où il faut.
La newsletter
De l'ancien site, tous les abonnés à la newsletter ont été récupérés. Pas avec un export dans un tableur, qui est la manière simple et celle qui abîme les données : un CSV perd l'état de chaque abonné, les dates et surtout la clé personnelle qui rend valide le lien « me désinscrire » en bas des e-mails.
On a utilisé à la place la procédure de migration interne du composant, en extrayant de la base de données de l'ancien site uniquement les tables nécessaires. Vérification finale, abonné par abonné : aucune adresse perdue et aucune en double, toutes les clés de désinscription conservées, états et dates identiques à l'origine. Un détail apparu en chemin : sur l'ancien site, la newsletter n'était jamais vraiment partie.
Les problèmes et la vitesse
Le pire obstacle a été silencieux. Depuis le jour où la copie a été faite, le vrai site et la copie ont continué d'attribuer de nouveaux numéros aux nouveaux contenus, chacun de son côté : le même numéro pouvait désigner deux choses différentes. Avant le déménagement, 239 adresses prises sur le site en ligne ont été comparées : 226 identiques, 4 collisions. Les quatre ont été réglées une à une, avec les redirections correspondantes.
Le moteur de recherche interne, ensuite, refusait d'indexer : 280 articles avaient une adresse plus longue que ce que la table de la base de données pouvait contenir. Une fois la colonne élargie, l'index est passé des petits mille contenus d'avant à l'archive entière.
Sur la vitesse, voici les chiffres mesurés avant et après : la page d'accueil est passée de 2,3 secondes à 0,21, la page des actualités à la une de 8,2 secondes à 0,46. De plus, 1 326 images d'archive ont été recompressées de 1 gigaoctet à 298 mégaoctets, sans changer ni noms ni extensions, pour ne pas casser les liens à l'intérieur des articles.
Résultat : site sur Joomla 6 et PHP 8.3, six variantes régionales fonctionnelles jusque dans les fiches des articles individuels, tous les abonnés à la newsletter récupérés sans perte, pages servies en un dixième du temps d'avant. L'ancien site a été conservé de côté comme voie de retour, non supprimé.