Editor aus lokalem Build ausführen.

DXPR Builder lernenWebsite verwaltenMarke umsetzen

Standardmäßig laden die Browser der Redaktion den DXPR-Builder-Editor vom DXPR-CDN, und Sie müssen nichts einstellen. Diese Seite richtet sich an Entwicklung, die den Editor aus dem Quellcode baut, um ihn zu debuggen oder eine Änderung zu testen. Am Ende läuft der Editor aus Dateien im Modulordner, minifiziert oder lesbar. Um das CDN hinter einer Firewall zu halten, siehe stattdessen Firewall und Datenresidenz.

Bevor Sie beginnen

  • Sie brauchen einen Git-Checkout von DXPR Builder mit installierten Node-Paketen. Releases von drupal.org enthalten keinen lokalen Build.
  • Sie brauchen die Berechtigung Administer DXPR Builder configuration.

Einrichtung

  1. Führen Sie im Modulordner npx grunt build aus. Es schreibt den Editor nach dxpr_builder/, minifiziert und unminifiziert.
  2. Gehen Sie zu DXPR Studio > DXPR Builder > General Settings (/admin/dxpr_studio/dxpr_builder/settings).
  3. Klappen Sie Editor Assets auf. Der Abschnitt erscheint nur, wenn ein lokaler Build existiert.
  4. Wählen Sie unter Asset source die Option Local (minified) oder Local (unminified).
  5. Klicken Sie auf Save settings.

Was Sie sehen

Laden Sie eine Seite im Builder neu. Der Browser lädt nun die Editor-Skripte aus dem dxpr_builder/-Ordner des Moduls auf Ihrer eigenen Website, ohne den jwt-Parameter, den CDN-Anfragen tragen. Local (unminified) lädt die lesbaren .js-Dateien und Local (minified) die kleineren .min.js-Dateien.

Settings

Option Was lädt Wofür nutzen
Cloud (Standard) Der Editor von cdn2.dxpr.com, mit cdn.dxpr.com als Fallback. Ihr Produktschlüssel geht mit jeder Anfrage mit. Jede aus einem Release installierte Website
Local (minified) dxpr_builder/*.min.js aus dem Modulordner Einen Build testen, wie die Produktion ihn ausführt
Local (unminified) dxpr_builder/*.js aus dem Modulordner Debuggen

Ein lokaler Build gewinnt immer gegen Cloud. Mit gewähltem Cloud lädt die Website die unminifizierten Dateien, oder die minifizierten, wenn nur diese existieren. DXPR veröffentlicht Cloud-Dateien nur für Releases, daher könnte ein Entwicklungs-Checkout sie ohnehin nicht nutzen.

Wenn Sie den lokalen Build nicht sehen

  • Es gibt keinen Abschnitt Editor Assets. Der dxpr_builder/-Ordner des Moduls enthält keinen Build. Führen Sie npx grunt build in einem Git-Checkout aus, dann laden Sie die Einstellungsseite neu.
  • Nur eine lokale Option wird angeboten. Nur die minifizierten oder nur die unminifizierten Dateien existieren. Führen Sie das volle npx grunt build aus, das beide schreibt.
  • Cloud ist gewählt, aber lokale Dateien laden trotzdem. Das ist Absicht, solange ein Build existiert. Entfernen Sie dxpr_builder.js und dxpr_builder.min.js aus dxpr_builder/ und leeren Sie Caches unter /admin/config/development/performance.
  • Der Editor erscheint nicht und Anfragen an cdn2.dxpr.com scheitern. Eine Firewall oder Content-Security-Policy blockiert das CDN. Geben Sie beide CDN-Hosts frei; siehe Firewall und Datenresidenz.

Wie geht es weiter?