Faire tourner l’éditeur depuis un build local.

Apprendre DXPR BuilderGérer le siteAux couleurs de votre marque

Par défaut, les navigateurs des contributeurs chargent l’éditeur DXPR Builder depuis le CDN DXPR, et vous n’avez rien à régler. Cette page s’adresse aux développeurs qui construisent l’éditeur depuis la source, pour le déboguer ou tester un changement. À la fin, l’éditeur tourne depuis des fichiers du dossier du module, minifiés ou lisibles. Pour garder le CDN derrière un pare-feu, voir plutôt Pare-feu et résidence des données.

Avant de commencer

  • Il faut une extraction git de DXPR Builder avec ses paquets Node installés. Les versions de drupal.org ne contiennent aucun build local.
  • Il faut la permission Administer DXPR Builder configuration.

Configuration

  1. Dans le dossier du module, exécutez npx grunt build. Il écrit l’éditeur dans dxpr_builder/, minifié et non minifié.
  2. Accédez à DXPR Studio > DXPR Builder > General Settings (/admin/dxpr_studio/dxpr_builder/settings).
  3. Déployez Editor Assets. La section n’apparaît que quand un build local existe.
  4. Sous Asset source, choisissez Local (minified) ou Local (unminified).
  5. Cliquez sur Save settings.

Ce que vous voyez

Rechargez une page dans le builder. Le navigateur charge désormais les scripts de l’éditeur depuis le dossier dxpr_builder/ du module sur votre propre site, sans le paramètre jwt des requêtes CDN. Local (unminified) charge les fichiers .js lisibles et Local (minified) les fichiers .min.js plus petits.

Paramètres

Option Ce qui se charge Usage
Cloud (default) L’éditeur depuis cdn2.dxpr.com, avec cdn.dxpr.com en repli. Votre clé de produit accompagne chaque requête. tout site installé depuis une version
Local (minified) dxpr_builder/*.min.js depuis le dossier du module tester un build comme la production l’exécute
Local (unminified) dxpr_builder/*.js depuis le dossier du module débogage

Un build local gagne toujours sur Cloud. Avec Cloud choisi, le site charge les fichiers non minifiés, ou les minifiés quand seuls ceux-ci existent. DXPR publie des fichiers cloud pour les versions uniquement, donc une extraction de développement ne pourrait pas les utiliser de toute façon.

Si vous ne voyez pas le build local

  • Il n’y a pas de section Editor Assets. Le dossier dxpr_builder/ du module ne contient aucun build. Exécutez npx grunt build dans une extraction git, puis rechargez la page des réglages.
  • Une seule option Local est proposée. Seuls les fichiers minifiés ou seuls les non minifiés existent. Exécutez le npx grunt build complet, qui écrit les deux.
  • Cloud est choisi, mais les fichiers locaux se chargent quand même. C’est voulu tant qu’un build existe. Retirez dxpr_builder.js et dxpr_builder.min.js de dxpr_builder/ et videz les caches sous /admin/config/development/performance.
  • L’éditeur n’apparaît pas et les requêtes vers cdn2.dxpr.com échouent. Un pare-feu ou une politique de sécurité du contenu bloque le CDN. Autorisez les deux hôtes CDN ; voir Pare-feu et résidence des données.

Et ensuite ?