Draai de editor vanuit een lokale build.

DXPR Builder lerenDe site beherenJe huisstijl toepassen

Standaard laden de browsers van redacteurs de DXPR Builder-editor vanaf het DXPR CDN en hoef je niets in te stellen. Deze pagina is voor ontwikkelaars die de editor vanuit de broncode bouwen, om die te debuggen of om een wijziging te testen. Aan het eind draait de editor vanuit bestanden in de moduleremap, geminified of leesbaar. Om het CDN achter een firewall te houden, zie Firewall en dataresidentie in plaats daarvan.

Voordat je begint

  • Je hebt een git-checkout van DXPR Builder nodig met de bijbehorende Node-pakketten geïnstalleerd. Releases van drupal.org bevatten geen lokale build.
  • Je hebt de rechten Administer DXPR Builder configuration nodig.

Instellen

  1. Draai in de moduleremap npx grunt build. Het schrijft de editor naar dxpr_builder/, geminified en unminified.
  2. Ga naar DXPR Studio > DXPR Builder > General Settings (/admin/dxpr_studio/dxpr_builder/settings).
  3. Vouw Editor Assets uit. De sectie verschijnt alleen wanneer er een lokale build bestaat.
  4. Kies onder Asset source Local (minified) of Local (unminified).
  5. Klik op Save settings.

Wat je ziet

Herlaad een pagina in de builder. De browser laadt de editorscripts nu vanuit de map dxpr_builder/ van de module op je eigen site, zonder de jwt-parameter die CDN-verzoeken meedragen. Local (unminified) laadt de leesbare .js-bestanden en Local (minified) de kleinere .min.js-bestanden.

Instellingen

Optie Wat wordt geladen Gebruik het voor
Cloud (standaard) De editor van cdn2.dxpr.com, met cdn.dxpr.com als fallback. Je productsleutel gaat met elk verzoek mee. elke site die vanuit een release is geïnstalleerd
Local (minified) dxpr_builder/*.min.js uit de moduleremap een build testen zoals productie die draait
Local (unminified) dxpr_builder/*.js uit de moduleremap debuggen

Een lokale build wint het altijd van Cloud. Met Cloud geselecteerd laadt de site de unminified bestanden, of de geminifiede wanneer alleen die bestaan. DXPR publiceert cloudbestanden alleen voor releases, dus een development-checkout zou ze toch niet kunnen gebruiken.

Als je de lokale build niet ziet

  • Er is geen sectie Editor Assets. De map dxpr_builder/ van de module bevat geen build. Draai npx grunt build in een git-checkout en herlaad daarna de instellingenpagina.
  • Er wordt maar één lokale optie aangeboden. Alleen de geminifiede of alleen de unminified bestanden bestaan. Draai de volledige npx grunt build, die beide schrijft.
  • Cloud is geselecteerd, maar lokale bestanden laden toch. Dat is zo ontworpen zolang er een build bestaat. Verwijder dxpr_builder.js en dxpr_builder.min.js uit dxpr_builder/ en wis de caches via /admin/config/development/performance.
  • De editor verschijnt niet en verzoeken aan cdn2.dxpr.com mislukken. Een firewall of een content security policy blokkeert het CDN. Sta beide CDN-hosts toe; zie Firewall en dataresidentie.

Wat nu?