Elegant Themes a réécrit Divi de fond en comble. Divi 5 n’est pas une mise à jour de plus : c’est un autre moteur, avec une autre façon de décrire les modules. Nos vingt-six modules WP-Apidae ont donc été réécrits pour lui.

Vous n’aurez qu’une extension à gérer. La version 2.0 fonctionne sous Divi 4 comme sous Divi 5. C’est le même paquet, qui reconnaît le constructeur en place et s’y adapte. Vous n’avez pas à choisir une version selon votre Divi, ni à changer d’extension le jour où vous passerez à Divi 5.

Deux modules nouveaux au passage : un champ dynamique, pour afficher une donnée Apidae précise où vous voulez dans une page, et une carte de fiche, distincte de la carte de liste. Le détail des vingt-six modules est sur la page de l’extension.

Ce que la migration fait à votre place

Vos pages décrivent les modules dans l’écriture de la 1.4. La 2.0 en utilise une autre. Un assistant s’en occupe : il ouvre chacune de vos pages, traduit les modules WP-Apidae qu’il y trouve, et les réécrit.

Il traite vos pages, vos articles, vos modèles de fiche et vos gabarits du Theme Builder, partout où vous avez posé un module WP-Apidae.

Il traduit aussi les réglages : deux cent treize au total, dont cent quarante et un ont changé de nom. Et il écrit explicitement les réglages que vous n’aviez jamais touchés. Ce détail compte : Divi n’enregistre pas les valeurs par défaut, et les défauts de la 2.0 ne sont pas tous ceux de la 1.4. Sans cette précaution, votre liste de douze fiches par page serait passée à vingt sans que vous ayez rien changé.

Ce qu’il ne fait pas, et qu’il vous dit

Le dernier écran liste ce qui demande votre regard, avec un lien vers chaque contenu. Rien n’est modifié en silence.

Quatre situations ne sont pas reprises automatiquement.

  • Une carte ou des filtres posés seuls sur une page, sans liste à côté. En 2.0, ces deux modules prennent leur sélection dans la liste qui les accompagne. Seuls sur leur page, ils n’ont plus rien à afficher. Ajoutez-y une liste, quitte à la masquer.
  • Une hauteur de carte exprimée en pourcentage. À reprendre en pixels.
  • Le mode agenda d’une liste, qui devient un module à part entière.
  • L’habillage que vous aviez donné à un module depuis l’onglet « Style » de Divi : fond, marges, bordure, ombre.

Ce dernier point mérite une explication, parce qu’il touche les sites soignés.

Les modules de la 2.0 n’ont plus d’onglet « Style ». C’est ce qui leur permet de se comporter à l’identique sous Divi 4 et sous Divi 5. Un module qui n’exposerait pas les mêmes réglages selon le constructeur serait une fausse compatibilité. Si vous aviez donné un fond gris à votre liste d’hébergements, ou 40 pixels de marge à votre carte, ces réglages restent dans votre page et ne produisent plus rien.

L’assistant vous les signale un par un, avec le lien vers la page. Refaites-les sur la ligne ou la section qui contient le module : Divi y propose les mêmes réglages, au même endroit, pour le même rendu. Ouvrez la page à côté de votre site d’origine et reportez ce qui manque.

Sur les gros sites, l’assistant travaille par paquets de cent contenus, pour ne pas dépasser le temps d’exécution de votre serveur. L’écran revient alors avec un bouton « Convertir les contenus restants ». Relancez-le autant de fois qu’il le propose.

Pourquoi sur un site de développement, et pas en production

C’est la partie la plus importante de cet article.

Entre le moment où vous mettez WP-Apidae à jour et celui où la migration est terminée, vos contenus Apidae ne s’affichent plus sur les pages publiques de votre site. Une partie s’affiche sous forme de code, visible de tous vos visiteurs.

Nous l’avons mesuré sur un site de test reproduisant un office de tourisme réel : 508 fiches, des pages de liste, des filtres, des cartes, des fiches avec leurs gabarits. Voici ce que voyait le public à chaque étape.

À ce moment-làPages dégradées
WP-Apidae mis à jour, extension Divi 1.4 désactivée11 sur 11
Extension 2.0 installée, assistant pas encore lancé11 sur 11
Assistant terminé, réindexation en cours9 sur 11
Réindexation terminée1 sur 11, une carte seule, cas connu

Trois choses à retenir de ce tableau.

L’extension 1.4 se désactive d’elle-même quand vous mettez WP-Apidae à jour. C’est voulu : elle n’est pas compatible avec le nouveau cœur, et la laisser active mettrait votre site en erreur. Cette désactivation est enregistrée : revenir à la version précédente de WP-Apidae ne la lève pas, il faut réactiver l’extension depuis l’écran des extensions. Mais dès cet instant, vos pages de liste n’affichent plus une seule fiche, et les pages qui ne portaient qu’un filtre ou qu’une carte affichent le code du module en toutes lettres.

Installer la 2.0 ne répare rien en soi. La deuxième ligne est identique à la première. Tant que l’assistant n’a pas converti vos contenus, ils restent écrits dans une langue que la nouvelle extension ne parle plus.

La dernière étape est invisible et il faut l’attendre. Une fois l’assistant terminé, la réindexation de vos fiches continue en tâche de fond. Vos pages sont converties, mais vos listes n’ont encore rien à afficher. Sur notre site de test, les 508 fiches ont représenté 48 411 lignes d’index. Suivez son avancement dans Outils > Actions planifiées.

La marche à suivre

  1. Faites une copie de votre site, base et fichiers, ou travaillez sur votre préproduction.
  2. Mettez WP-Apidae à jour en premier.
  3. Installez WP-Apidae Divi 2.0.
  4. Parcourez l’assistant de migration jusqu’au dernier écran.
  5. Attendez la fin de la réindexation.
  6. Vérifiez, puis refaites l’opération en production.

Comptez le temps de la réindexation dans votre planning. C’est elle qui décide du moment où votre site redevient complet.

Le parcours, écran par écran

L’assistant s’ouvre après la mise à jour, depuis WP-Apidae > Assistant de migration. Il annonce ce qu’il va faire avant de commencer.

Écran d'accueil de l'assistant de migration WP-Apidae
L’assistant s’ouvre sur ce que la migration va faire, avant toute écriture.

L’étape de l’index recrée la table tout de suite, puis lance la réindexation en tâche de fond. C’est celle qu’il faut laisser finir.

Étape de changement de structure de l'indexeur
La table est recréée immédiatement, la réindexation des fiches se poursuit après cette page.

L’inventaire montre ce qui va être touché, contenu par contenu. Il ne modifie rien : c’est une simulation, et vous pouvez la relire autant de fois que vous voulez.

Inventaire des contenus à convertir, avant toute modification
L’inventaire est une simulation. Rien n’est écrit à cette étape.

La conversion est la seule étape qui écrit. Sur un site de plus de cent contenus, elle revient avec un bouton « Convertir les contenus restants », et le décompte de ce qu’il reste réellement à faire.

Écran de conversion après un premier paquet de cent contenus
Cent contenus convertis, trente-quatre restants : l’écran revient tant qu’il reste du travail.

L’écran final récapitule ce qui a été fait et ce qui vous revient. Il se conserve : si vous fermez l’onglet, vous le retrouvez. Il s’exporte aussi, en JSON et à l’impression, pour comparer ce que vous avez obtenu sur votre copie et ce que vous obtiendrez en production.

Écran final de l'assistant, récapitulatif et points à vérifier
Le récapitulatif, et la liste des points qui demandent votre regard.

Le parcours compte sept étapes en tout. Les autres remettent vos réglages et vos modèles en ordre, sans demander de décision de votre part.

Et si quelque chose se passe mal

Chaque contenu est sauvegardé avant d’être touché. Un contenu dont la sauvegarde échoue n’est pas converti.

Pour vos pages et vos articles, cette sauvegarde est une révision WordPress ordinaire. Vous la retrouvez dans l’écran d’édition, sous le titre, et vous y revenez sans nous. Les modèles de fiche et les gabarits du Theme Builder n’acceptent pas les révisions : leur original est conservé à part.

Il n’y a pas de bouton « tout annuler ». La restauration se fait contenu par contenu. Raison de plus de travailler sur une copie.

Un prérequis à vérifier avant tout

La 2.0 demande PHP 8.2 au minimum. Si votre hébergement est en deçà, WordPress refusera l’installation. Le changement de version de PHP se fait chez votre hébergeur.

Elle demande aussi WP-Apidae 6.3.8, disponible depuis fin août : c’est elle qui expose au module l’édition des modèles et le montage des cartes. Nous détaillons cette version dans l’article qui lui est consacré, et elle corrige au passage plusieurs pannes silencieuses qui concernent tous les sites, Divi ou non.

Une question ?

Le support répond à vos questions sur l’extension. Ouvrez un ticket depuis votre espace client.