Mettre à jour DXPR Builder.

Apprendre DXPR BuilderCommencer iciInstaller et mettre à jour

Mettez à jour DXPR Builder pour obtenir les corrections de bogues, les nouveautés et les correctifs de sécurité. Mettez à jour le code avec Composer, puis laissez Drupal convertir les réglages et le contenu avec drush updatedb. Cette page couvre les mises à jour au sein de la série 3.x. Si vous venez de 1.x ou 2.x, suivez Migrer depuis DXPR Builder 1.x ou 2.x à la place.

Avant de commencer

  • Sauvegardez la base de données :

    drush sql:dump > backup-$(date +%Y%m%d).sql

  • Lisez le Journal des changements et la page des versions GitHub pour repérer les changements qui exigent une action, comme le passage à Font Awesome 7.

  • Testez d’abord la mise à jour sur une copie de préproduction du site.

Mettre à jour le module

  1. Mettez à jour le code :

    composer update drupal/dxpr_builder --with-dependencies

  2. Exécutez les mises à jour de la base de données. Vous pouvez aussi passer par /update.php :

    drush updatedb

    Certaines mises à jour convertissent chaque valeur de champ DXPR Builder par lots. Sur les grands sites, elles prennent des minutes, pas des secondes.

  3. Reconstruisez les caches, pour que les navigateurs reçoivent les nouvelles feuilles de style et les nouveaux scripts :

    drush cache:rebuild

Ce que vous voyez

Les pages au contenu DXPR Builder gardent leur aspect. Survolez-en une en tant que rédacteur et les barres de contrôle apparaissent ; faites une petite modification et cliquez sur Enregistrer pour vérifier que l’enregistrement fonctionne. General Settings affiche toujours votre clé produit sous License.

Page des réglages généraux de DXPR Builder

Puis ouvrez Reports > Status report (/admin/reports/status). À côté de DXPR Builder content migrations, il est indiqué All migrations completed.

Si vous ne voyez pas la nouvelle version

  • L’éditeur se comporte encore comme l’ancienne version. Le navigateur garde les anciens fichiers de l’éditeur. Rechargez avec Ctrl+Maj+R, ou Cmd+Maj+R sur Mac.
  • Le Status report indique « Some DXPR Builder content migrations have not been completed ». Du contenu attend encore sa conversion. Ouvrez View migration status dans ce message, ou allez à /admin/dxpr_studio/dxpr_builder/migration-status et cliquez sur Run all pending migrations.
  • Les pages s’affichent mal ou des éléments manquent. Voir Problèmes après la mise à jour pour les causes et les correctifs.

Si la mise à jour casse le site et que rien ci-dessus n’aide, revenez en arrière :

  1. Restaurez votre sauvegarde de la base de données :

    drush sql:cli < backup-20260901.sql

  2. Restaurez la version que vous aviez, par exemple 3.0.0-beta19 :

    composer require 'drupal/dxpr_builder:3.0.0-beta19'

  3. Reconstruisez les caches :

    drush cache:rebuild

Et ensuite ?