Problemi dopo l’aggiornamento.

Impara DXPR BuilderGestisci il sitoRisolvi un problema

Completa un aggiornamento andato storto. In quasi ogni caso il codice è stato aggiornato ma il database no, una copia residua del modulo è di intralcio, o manca una dipendenza.

Esegui l’aggiornamento nell’ordine giusto

  1. Fai un backup del database.
  2. Esegui composer require drupal/dxpr_builder, con un vincolo di versione se fissi le release.
  3. Esegui drush updb -y (oppure visita /update.php).
  4. Esegui drush cr.
  5. Apri una pagina builder e salvala di nuovo.

Importante: non disinstallare mai il modulo per aggiornarlo. Disinstallarlo cancella modelli salvati, profili e impostazioni.

Composer mostra un errore

  • "Could not find a version of package drupal/dxpr_builder matching your minimum-stability". La 3.x è pubblicata come release beta. Consentile nel vincolo: composer require 'drupal/dxpr_builder:^3.0@beta'.
  • "Could not find a matching version of package dxpr/dxpr_builder". Il pacchetto su drupal.org è drupal/dxpr_builder. Sostituisci dxpr/dxpr_builder con drupal/dxpr_builder in composer.json, poi esegui composer update drupal/dxpr_builder.
  • Composer rifiuta perché la cartella non è gestita da Composer. Una copia è stata caricata a mano. Cancella modules/contrib/dxpr_builder ed esegui di nuovo il comando require.
  • "Disk quota exceeded" o "write failed". Libera spazio disco sul server prima di riprovare.

L’aggiornamento del database non riesce

  • "Unable to install modules key due to missing modules key". La 3.x richiede il modulo Key e l’aggiornamento 9020 lo installa. Il suo codice manca perché il modulo non è stato installato con Composer. Esegui composer require drupal/key, poi di nuovo drush updb -y.
  • Un hook di aggiornamento nominato non riesce. Esegui drush updb -vvv e includi l’errore completo nel tuo ticket.
  • "module 'dxpr_builder_page' is missing its dependency module field_group". Il sottomodulo DXPR Builder Drag and Drop Page richiede Field Group. Esegui composer require drupal/field_group, poi drush en dxpr_builder_page -y.

Le pagine sembrano rotte dopo l’aggiornamento

Alcune release convertono vecchio markup, come caroselli Owl e contatori circolari, in batch durante drush updb. Gli elementi che non riescono restano in attesa.

  1. Vai in DXPR Studio > DXPR Builder > Content items > Migrations (/admin/dxpr_studio/dxpr_builder/migration-status).
  2. Se una migrazione mostra Pending, fai clic su Run now, oppure Run all pending migrations.
  3. Controlla Reports > Recent log messages per gli elementi saltati da un batch.

Composer rifiuta un major upgrade del core Drupal

DXPR Builder 3.x supporta Drupal 10.2 e successivi, e Drupal 11.

  1. Controlla le note di release di DXPR Builder, DXPR Theme e DXPR Theme Helper per la versione che supporta il nuovo major.
  2. Esegui Upgrade Status per vedere quali pacchetti non sono pronti.
  3. Fissa il major del core in composer.json. Un composer require drupal/core-recommended senza vincoli può tirare dentro il major successivo per sbaglio.

L’editor si è rotto subito dopo l’aggiornamento

Segui L’editor non compare. Le cause principali lì sono quelle che seguono un aggiornamento parziale: aggiornamenti del database in attesa, file obsoleti e una cache di aggregazione costruita dalla vecchia release.

Sto migrando da Glazed Builder

DXPR Builder 3.x non converte più i nomi di classe Glazed nei contenuti salvati. Aggiorna prima all’ultima release 2.x ed esegui i suoi aggiornamenti del database, poi aggiorna alla 3.x. Vedi Migrazione da DXPR Builder 1.x o 2.x.

Verifica che il problema sia risolto

drush updb non riporta aggiornamenti in attesa, drush pm:list --filter=dxpr mostra le versioni previste e una pagina builder risalvata si rende uguale nell’editor e per un visitatore.

E adesso?

Aggiornare DXPR Builder per la procedura di aggiornamento ordinaria.