Der Editor erscheint nicht.

DXPR Builder lernenWebsite verwaltenProblem beheben

Sie öffnen eine Seite und nichts passiert, wenn Sie auf den Inhalt zeigen, oder die Steuerungen erscheinen, aber der Einstellungsdialog öffnet sich nie. Arbeiten Sie die Ursachen unten der Reihe nach durch. Die ersten vier decken die meisten Fälle ab.

Ich bin auf dem Node-Bearbeitungsformular

Der Editor läuft auf der Seite selbst, nicht auf dem Bearbeitungsformular. Speichern Sie den Node, öffnen Sie die Seite und zeigen Sie auf den Inhaltsbereich. Der Editor bleibt auch auf Revisionsseiten aus, etwa /node/12/revisions/34/view.

Die Seite zeigt eine Produktschlüssel- oder Lizenzmeldung

Der Editor bleibt aus, solange eine dieser Meldungen erscheint:

  • „DXPR Builder needs a product key to work“. Es ist kein Produktschlüssel gesetzt. Gehen Sie zu DXPR Studio > DXPR Builder > General Settings (/admin/dxpr_studio/dxpr_builder/settings) und füllen Sie den Abschnitt License aus.
  • „Oops, the no-code editor is not loading here“. Die Meldung nennt die Ursache: zu wenige Benutzerlizenzen, das Inhaltslimit Ihres Tarifs oder ein Konto ohne gültige E-Mail-Adresse. Folgen Sie Lizenz- und Produktschlüsselfehler.
  • „Access to DXPR Builder is blocked because of a payment or licensing problem“. DXPR hat die Domain der Website blockiert. Kontaktieren Sie DXPR über den Link in der Meldung.

Die Konsole zeigt 401- oder 403-Fehler von cdn2.dxpr.com

Mit Asset source auf Cloud laden die Editor-Skripte von cdn2.dxpr.com mit Ihrem Produktschlüssel in der URL. Ein 401 oder 403 bedeutet, dass das CDN den Schlüssel abgelehnt hat. Prüfen Sie den Abschnitt License der General Settings und folgen Sie dann Lizenz- und Produktschlüsselfehlern. Wenn die Anfragen stattdessen in Timeouts laufen, blockiert eine Firewall das CDN; siehe DXPR Builder hinter einer Firewall nutzen.

Der Editor stoppte nach einem Update

  1. Führen Sie drush updb -y aus (oder besuchen Sie /update.php).
  2. Führen Sie drush cr aus.
  3. Öffnen Sie eine Builder-Seite und speichern Sie sie erneut.

Wenn das Log eine fehlende Datei im Modulordner meldet, ist der Code auf dem Server unvollständig. Installieren Sie den Code neu:

  1. Löschen Sie den Ordner modules/contrib/dxpr_builder.
  2. Führen Sie composer require drupal/dxpr_builder aus.
  3. Führen Sie drush cr aus.

Wichtig: Deinstallieren Sie das Modul niemals, um es zurückzusetzen. Deinstallieren löscht gespeicherte Vorlagen, Profile und Einstellungen.

Die Steuerungen erscheinen, aber Einstellungsdialoge öffnen sich nie

Die Konsole zeigt bootstrap is not defined oder einen Fehler über getOrCreateInstance. Die Dialoge des Editors laufen mit Bootstrap-5- JavaScript. Die Seite hat keines, oder das Theme lädt stattdessen Bootstrap 3 oder 4.

  1. Gehen Sie zu den General Settings und öffnen Sie den Abschnitt Bootstrap.
  2. Wenn Ihr Theme kein Bootstrap 5 lädt, stellen Sie Sideload Bootstrap files auf Bootstrap 5 und klicken Sie auf Save settings.
  3. Wenn Ihr Theme Bootstrap-3- oder -4-JavaScript lädt, laden Sie es nicht mehr oder wechseln Sie zu einem Bootstrap-5-Theme.

Die Konsole zeigt einen JavaScript-Fehler aus einem anderen Skript

Ein anderes Skript auf der Seite stört den Editor. In Support-Tickets waren die Schuldigen Cookie-Consent-Banner, Tag-Manager, ein MailChimp-Embed und ein New-Relic-Browser-Agent. Auch Themes verursachten es, über ein Webpack-Bundle oder ihr eigenes Bootstrap-3- oder -4- JavaScript, ebenso JavaScript-Minifier.

  1. Gehen Sie zu Configuration > Development > Performance und schalten Sie die JavaScript-Aggregierung aus. Laden Sie neu.
  2. Deaktivieren Sie Consent-, Analyse- und Monitoring-Module einzeln. Laden Sie nach jedem neu.
  3. Wechseln Sie für einen Test zu einem Core-Theme wie Olivero.

Was das Ergebnis sagt:

  • Schritt 1 behoben: Ein Minifier ist die Ursache. Die Hilfsbibliotheken des Editors, etwa Sortable, werden mit dem Rest der Seite aggregiert, sodass Sortable is not defined bei eingeschalteter Aggregierung hierauf zeigt. Ändern Sie mit Advanced CSS/JS Aggregation den Minifier von JSqueeze zu JSMin.
  • Schritt 2 behoben: Lassen Sie dieses Modul auf Bearbeitungsseiten deaktiviert, oder melden Sie den Konflikt an dessen Maintainer.
  • Schritt 3 behoben: Das JavaScript des Themes ist die Ursache. Laden Sie kein Bootstrap-3- oder -4-JavaScript mehr aus dem Theme und stellen Sie Sideload Bootstrap files auf Bootstrap 5.

Die Seite zeigt „The website encountered an unexpected error“

Das Log zeigt einen Stack-Trace durch DxprBuilderService, der eine Ansicht oder eine Block-Klasse eines anderen Moduls nennt.

Für die Redaktion listet der Builder jede Ansichtsanzeige und jedes Block-Plugin, sodass Sie sie auf Seiten legen können. Für jeden Besucher rendert er die Blöcke und Ansichten auf der Seite. Eine defekte Ansicht oder ein defekter Block, der in einem der beiden Schritte einen Fehler wirft, reißt die Seite mit.

  1. Öffnen Sie Reports > Recent log messages und finden Sie die Ansicht oder das Modul aus dem Trace.
  2. Reparieren oder löschen Sie diese Ansicht, oder deaktivieren Sie dieses Modul.
  3. Leeren Sie alle Caches.

Der Editor erscheint nie auf einem Inhaltstyp

  1. Gehen Sie zu Structure > Content types > (Typ) > Manage display.
  2. Stellen Sie das Format des Builder-Feldes auf DXPR Builder.
  3. Wiederholen Sie es für jeden View Mode, der das Feld rendert, nicht nur Default.

Hinweis: Der Editor braucht ein Feld mit einem Wert, um sich anzuhängen. Wenn Sie einen Node speichern, füllt DXPR Builder ein leeres Feld, das das DXPR Builder-Format in der Anzeige Default nutzt. Ein Node, der vor Ihrer Formatänderung gespeichert wurde, bleibt leer: Bearbeiten Sie ihn und speichern Sie ihn einmal.

Nur manche Personen sehen den Editor

Prüfen Sie dies für das Konto, das keinen Editor sieht:

  1. Unter People > Permissions (/admin/people/permissions) hat die Rolle Edit with DXPR Builder.
  2. Die Rolle darf diesen Inhalt auch bearbeiten, zum Beispiel Basic page: Edit any content. Der Editor lädt nur für Personen, die die Seite aktualisieren dürfen.
  3. Das Konto hat eine gültige E-Mail-Adresse. Die Lizenzierung braucht eine.
  4. Auf dem Bearbeitungsformular des Kontos ist Exclude from DXPR builder editing nicht angewählt.
  5. Unter DXPR Studio > DXPR Builder > User Profiles hat das Profil für diese Rolle Start editor when page loads angewählt. Wenn es aus ist, erscheinen die Steuerungen erst nach einem Klick auf das Augen-Icon der Containersteuerung.

Ein anderer Bearbeiter hat den Inhalt gesperrt

Eine Warnung meldet, dass der Inhalt von einem Teammitglied „gelockt“ ist, und der Container zeigt nur einen Button Locked. Dieser Bearbeiter hat in den Container geklickt und noch nicht gespeichert; die Sperre löst sich, wenn gespeichert wird. Bitten Sie um ein Speichern, oder klicken Sie auf Locked und bestätigen Sie die Übernahme. Wenn Sie beide weiter bearbeiten, gewinnt das letzte Speichern.

Die Lösung bestätigen

Laden Sie in einem privaten Fenster neu und zeigen Sie auf den Inhaltsbereich. Die Containerleiste zeigt View mode, More und Save, und die Konsole zeigt keine roten Fehler.

Wie geht es weiter?

Probleme nach dem Aktualisieren, wenn der Editor direkt nach einer Version kaputtging.