Aggiornare DXPR Builder.

Impara DXPR BuilderInizia da quiInstalla e aggiorna

Aggiorna DXPR Builder per ricevere correzioni di bug, nuove funzionalità e correzioni di sicurezza. Aggiorni il codice con Composer, poi lasci che Drupal converta impostazioni e contenuti con drush updatedb. Usa questa pagina per gli aggiornamenti all’interno della serie 3.x. Vieni dalla 1.x o dalla 2.x? Segui Migrazione da DXPR Builder 1.x o 2.x invece.

Prima di iniziare

  • Fai un backup del database:

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

  • Leggi il Changelog e la pagina delle release su GitHub per individuare le modifiche che richiedono un intervento, come il passaggio a Font Awesome 7.

  • Prova prima l’aggiornamento su una copia di staging del sito.

Aggiorna il modulo

  1. Aggiorna il codice:

    composer update drupal/dxpr_builder --with-dependencies

  2. Esegui gli aggiornamenti del database. In alternativa puoi anche visitare /update.php:

    drush updatedb

    Alcuni aggiornamenti convertono tutti i valori dei campi di DXPR Builder in batch. Sui siti grandi richiedono minuti, non secondi.

  3. Ricostruisci le cache, così i browser ricevono i nuovi fogli di stile e gli script:

    drush cache:rebuild

Cosa vedi

Le pagine con contenuti di DXPR Builder hanno lo stesso aspetto di prima. Passaci sopra come editor e appaiono le barre di controllo; fai una piccola modifica e fai clic su Salva per verificare che il salvataggio funzioni. Impostazioni generali mostra ancora la tua chiave prodotto sotto Licenza.

Pagina delle impostazioni generali di DXPR Builder

Poi apri Rapporti > Rapporto di stato (/admin/reports/status). Accanto a Migrazioni dei contenuti di DXPR Builder c’è scritto Tutte le migrazioni completate.

Se non vedi la nuova versione

  • L’editor si comporta ancora come la vecchia versione. Il browser conserva i vecchi file dell’editor. Ricarica con Ctrl+Shift+R, o Cmd+Shift+R su Mac.
  • Il rapporto di stato dice “Alcune migrazioni dei contenuti di DXPR Builder non sono state completate”. Alcuni contenuti sono ancora in attesa di conversione. Apri Visualizza lo stato della migrazione in quel messaggio, oppure vai a /admin/dxpr_studio/dxpr_builder/migration-status, e fai clic su Esegui tutte le migrazioni in sospeso.
  • Le pagine si vedono male o mancano elementi. Vedi Problemi dopo l’aggiornamento per cause e soluzioni.

Se l’aggiornamento rompe il sito e niente di quanto sopra aiuta, torna indietro:

  1. Ripristina il backup del database:

    drush sql:cli < backup-20260901.sql

  2. Ripristina la versione che avevi, ad esempio 3.0.0-beta19:

    composer require 'drupal/dxpr_builder:3.0.0-beta19'

  3. Ricostruisci le cache:

    drush cache:rebuild

Passi successivi