L’editor non compare.

Learn DXPR BuilderManage the siteEen probleem oplossen

Apri una pagina e non succede nulla quando indichi il contenuto, oppure i controlli si vedono ma la finestra delle impostazioni non si apre mai. Segui le cause sotto in ordine. Le prime quattro coprono la maggior parte dei casi.

Sono nel form di modifica del nodo

L’editor gira nella pagina stessa, non nel form di modifica. Salva il nodo, apri la pagina e indica l’area di contenuto. L’editor resta spento anche nelle pagine di revisione, come /node/12/revisions/34/view.

La pagina mostra un messaggio su chiave prodotto o licenza

L’editor resta spento mentre è visibile uno di questi messaggi:

  • "DXPR Builder needs a product key to work". Nessuna chiave prodotto è impostata. Vai in DXPR Studio > DXPR Builder > General Settings (/admin/dxpr_studio/dxpr_builder/settings) e compila la sezione License.
  • "Oops, the no-code editor is not loading here". Il messaggio indica la causa: troppe poche licenze utente, il limite di contenuti del tuo piano, o un account senza un indirizzo email valido. Segui Errori di licenza e chiave prodotto.
  • "Access to DXPR Builder is blocked because of a payment or licensing problem". DXPR ha bloccato il dominio del sito. Contatta DXPR tramite il link nel messaggio.

La console mostra errori 401 o 403 da cdn2.dxpr.com

Con Asset source impostato su Cloud, gli script dell’editor si caricano da cdn2.dxpr.com con la tua chiave prodotto nell’URL. Un 401 o 403 significa che il CDN ha rifiutato la chiave. Controlla la sezione License delle General Settings, poi segui Errori di licenza e chiave prodotto. Se invece le richieste vanno in timeout, un firewall blocca il CDN; vedi Usare DXPR Builder dietro un firewall.

L’editor si è fermato dopo un aggiornamento

  1. Esegui drush updb -y (oppure visita /update.php).
  2. Esegui drush cr.
  3. Apri una pagina builder e salvala di nuovo.

Se il log riporta un file mancante dentro la cartella del modulo, il codice sul server è incompleto. Reinstalla il codice:

  1. Cancella la cartella modules/contrib/dxpr_builder.
  2. Esegui composer require drupal/dxpr_builder.
  3. Esegui drush cr.

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

I controlli si vedono, ma le finestre impostazioni non si aprono mai

La console mostra bootstrap is not defined, o un errore su getOrCreateInstance. Le finestre dell’editor girano su JavaScript Bootstrap 5. La pagina non ne ha, oppure il tema carica JavaScript Bootstrap 3 o 4 al suo posto.

  1. Vai in General Settings e apri la sezione Bootstrap.
  2. Se il tuo tema non carica Bootstrap 5, imposta Sideload Bootstrap files su Bootstrap 5 e fai clic su Save settings.
  3. Se il tuo tema carica JavaScript Bootstrap 3 o 4, smetti di caricarlo o passa a un tema Bootstrap 5.

La console mostra un errore JavaScript da un altro script

Un altro script nella pagina rompe l’editor. Nei ticket di assistenza i colpevoli erano banner di consenso cookie, tag manager, un embed MailChimp e un agente browser New Relic. Anche i temi lo causavano, tramite un bundle Webpack o il loro JavaScript Bootstrap 3 o 4, e così facevano i minificatori JavaScript.

  1. Vai in Configuration > Development > Performance e disattiva l’aggregazione JavaScript. Ricarica.
  2. Disattiva moduli di consenso, analisi e monitoraggio uno alla volta. Ricarica dopo ciascuno.
  3. Passa a un tema core come Olivero per una prova.

Cosa ti dice il risultato:

  • Risolto al passaggio 1: la causa è un minificatore. Le librerie ausiliarie dell’editor, come Sortable, sono aggregate con il resto della pagina, quindi Sortable is not defined con aggregazione attiva punta qui. Con Advanced CSS/JS Aggregation, cambia il minificatore da JSqueeze a JSMin.
  • Risolto al passaggio 2: tieni quel modulo disattivato nelle pagine di modifica, oppure segnala il conflitto al suo manutentore.
  • Risolto al passaggio 3: la causa è il JavaScript del tema. Smetti di caricare JavaScript Bootstrap 3 o 4 dal tema, e imposta Sideload Bootstrap files su Bootstrap 5.

La pagina mostra "The website encountered an unexpected error"

Il log mostra uno stack trace attraverso DxprBuilderService che cita una vista o una classe blocco di un altro modulo.

Per gli editor, il builder elenca ogni visualizzazione di vista e plugin di blocco così puoi aggiungerli alle pagine. Per ogni visitatore, rende i blocchi e le viste messi nella pagina. Una vista o un blocco rotto che solleva un errore in uno dei due passaggi manda giù la pagina.

  1. Apri Reports > Recent log messages e trova la vista o il modulo citato nel trace.
  2. Sistema o cancella quella vista, oppure disattiva quel modulo.
  3. Svuota tutte le cache.

L’editor non si mostra mai su un tipo di contenuto

  1. Vai in Structure > Content types > (tipo) > Manage display.
  2. Imposta il formato del campo builder su DXPR Builder.
  3. Ripeti per ogni modalità di vista che rende il campo, non solo Default.

Nota: l’editor ha bisogno di un campo con un valore a cui agganciarsi. Quando salvi un nodo, DXPR Builder riempie un campo vuoto che usa il formato DXPR Builder nella visualizzazione Default. Un nodo salvato prima che cambiassi il formato resta vuoto: modificalo e salvalo una volta.

Solo alcuni utenti vedono l’editor

Controlla questi punti per l’account che non vede l’editor:

  1. In People > Permissions (/admin/people/permissions), il ruolo ha Edit with DXPR Builder.
  2. Il ruolo può anche modificare quel contenuto, per esempio Basic page: Edit any content. L’editor si carica solo per gli utenti che possono aggiornare la pagina.
  3. L’account ha un indirizzo email valido. La licenza ne ha bisogno.
  4. Nel form di modifica dell’utente, Exclude from DXPR builder editing non è selezionato.
  5. In DXPR Studio > DXPR Builder > User Profiles, il profilo per quel ruolo ha Start editor when page loads selezionato. Quando è spento, i controlli compaiono solo dopo un clic sull’icona occhio dei controlli del contenitore.

Un altro editor ha bloccato il contenuto

Un avviso dice "The content ... is locked by" un collega, e il contenitore mostra solo un pulsante Locked. Quell’editor è entrato nel contenitore e non ha ancora salvato; il blocco si cancella quando salva. Chiedigli di salvare, oppure fai clic su Locked e conferma per prendere il controllo. Se continuate a modificare entrambi, vince l’ultimo salvataggio.

Verifica che il problema sia risolto

Ricarica in una finestra privata e indica l’area di contenuto. La barra del contenitore mostra View mode, More e Save, e la console non mostra errori rossi.

E adesso?

Problemi dopo l’aggiornamento se l’editor si è rotto subito dopo una release.