ローカルビルドでエディターを実行する.
デフォルトでは、編集者のブラウザーはDXPR CDNからDXPR Builderエディターを読み込むため、設定は不要です。このページは、デバッグや変更のテストのためにソースからエディターをビルドする開発者向けです。最終的に、エディターはモジュールフォルダー内のファイルから実行されます(圧縮版または可読版)。ファイアウォール内でのCDN利用については、代わりにファイアウォールとデータレジデンシーをご覧ください。
始める前に
- DXPR Builderのgitチェックアウト(Nodeパッケージのインストール済み)が必要です。drupal.orgからのリリースにはローカルビルドが含まれていません。
- 必要な権限はAdminister DXPR Builder configurationです。
セットアップ
- モジュールフォルダーで
npx grunt buildを実行します。エディターがdxpr_builder/に書き込まれます(圧縮版と非圧縮版)。 - 開くのはDXPR Studio > DXPR Builder > General Settings (
/admin/dxpr_studio/dxpr_builder/settings)です。 - 展開するのはEditor Assetsです。このセクションはローカルビルドが存在する場合にのみ表示されます。
- 選択肢はAsset source配下にあり、Local (minified)またはLocal (unminified)を選びます。
- 最後にSave settingsをクリックします。
表示内容
ビルダーでページを再読み込みします。ブラウザーは自サイトのモジュールのdxpr_builder/フォルダーからエディタースクリプトを読み込むようになり、CDNリクエストに付くjwtパラメーターは付きません。Local (unminified)は可読版の.jsファイルを、Local (minified)はサイズの小さい.min.jsファイルを読み込みます。
設定
| オプション | 読み込まれるもの | 用途 |
|---|---|---|
| Cloud(デフォルト) | エディターの取得元はcdn2.dxpr.comで、フォールバックはcdn.dxpr.comです。プロダクトキーは各リクエストに付与されます。 |
リリース版からインストールしたすべてのサイト |
| Local (minified) | dxpr_builder/*.min.js(モジュールフォルダー) |
本番環境と同様の条件でのビルドのテスト |
| Local (unminified) | dxpr_builder/*.js(モジュールフォルダー) |
デバッグ |
ローカルビルドは常にCloudより優先されます。Cloudを選択している場合、サイトは非圧縮ファイルを読み込みます(圧縮版しかない場合は圧縮版)。DXPRはリリース版向けにのみクラウドファイルを公開しているため、開発用チェックアウトではいずれにせよ利用できません。
ローカルビルドが表示されない場合
- Editor Assetsセクションがありません。モジュールの
dxpr_builder/フォルダーにビルドがありません。gitチェックアウトでnpx grunt buildを実行し、設定ページを再読み込みします。 - Localオプションが1つしか表示されません。圧縮版または非圧縮版のファイルしか存在しません。完全な
npx grunt buildを実行すると、両方が書き込まれます。 - Cloudを選択しているのにローカルファイルが読み込まれる。ビルドが存在する間は仕様です。
dxpr_builder.jsとdxpr_builder.min.jsをdxpr_builder/から削除し、/admin/config/development/performanceでキャッシュをクリアします。 - エディターが表示されず、
cdn2.dxpr.comへのリクエストが失敗する。ファイアウォールまたはコンテンツセキュリティポリシーがCDNをブロックしています。両方のCDNホストを許可します。詳しくはファイアウォールとデータレジデンシーをご覧ください。
次のステップ
- パフォーマンス:各ソースが読み込む内容と、その背後にある設定キー。
- エディターが表示されない:エディターが起動しないその他の原因。