エディターが表示されない.
ページを開いてもコンテンツにポイントして何も起きない、コントロールは出るが 設定ダイアログが開かない場合です。下の原因を順にたどります。最初の4つでほぼ 解決します。
ノード編集フォームにいる
エディターは編集フォームではなくページ上で動きます。ノードを保存して
ページを開き、コンテンツエリアにポイントします。リビジョンページ
(/node/12/revisions/34/viewなど) でもエディターはオフのままです。
ページにプロダクトキー・ライセンスのメッセージが出る
次のメッセージが出ている間、エディターはオフのままです。
- "DXPR Builder needs a product key to work". プロダクトキーが未設定です。
DXPR Studio > DXPR Builder > General
Settings (
/admin/dxpr_studio/dxpr_builder/settings) の Licenseセクションに入力します。 - "Oops, the no-code editor is not loading here". メッセージが原因を 名指します。ユーザーライセンス不足、プランのコンテンツアイテム上限、有効メール アドレスなしアカウントのいずれかです。ライセンスとプロダクトキーの エラーに従います。
- "Access to DXPR Builder is blocked because of a payment or licensing problem". DXPRがサイトドメインを遮断しました。メッセージ内リンクから DXPRに連絡します。
コンソールにcdn2.dxpr.comの401・403エラーが出る
設定Asset sourceがCloudの場合、エディタースクリプトは
URL内プロダクトキー付きでcdn2.dxpr.comから読み込みます。401・403はCDNが
キーを却下した意味です。General SettingsのLicenseセクションを
確認し、ライセンスとプロダクトキーの
エラーに従います。代わりにタイムアウトする場合はファイアウォールがCDNを遮断して
います。ファイアウォール内での
DXPR Builder利用をご覧ください。
更新後にエディターが止まった
- 実行するのは
drush updb -yです (または/update.phpを開きます)。 - 実行するのは
drush crです。 - ビルダーページを1つ開いて保存し直します。
ログがモジュールフォルダー内のファイル欠落を報告する場合、サーバーのコードが 不完全です。コードを入れ直します。
- 削除するのは
modules/contrib/dxpr_builderフォルダーです。 - 実行するのは
composer require drupal/dxpr_builderです。 - 実行するのは
drush crです。
重要: リセットのためにモジュールをアンインストールしないでください。 アンインストールは保存済みテンプレート、プロファイル、設定を削除します。
コントロールは出るが設定ダイアログが開かない
コンソールにbootstrap is not definedかgetOrCreateInstance関連エラーが
出ます。エディターのダイアログはBootstrap 5のJavaScriptで動きます。ページにないか、
テーマが代わりにBootstrap 3・4を読み込んでいます。
- 開くのはGeneral Settingsで、Bootstrapセクションを開きます。
- テーマがBootstrap 5を読み込まない場合、Sideload Bootstrap filesをBootstrap 5にしてSave settingsをクリックします。
- テーマがBootstrap 3・4のJavaScriptを読み込む場合、その読み込みを止めるか Bootstrap 5テーマに替えます。
コンソールに他スクリプトのJavaScriptエラーが出る
ページ上の別スクリプトがエディターを壊しています。サポートチケットの犯人は Cookie同意バナー、タグマネージャー、MailChimp埋め込み、New Relicブラウザー エージェントでした。テーマも原因になります。Webpackバンドルや独自Bootstrap 3・4 JavaScript経由、JavaScript圧縮も同様です。
- 開くのはConfiguration > Development > Performanceで、 JavaScript集約をオフにします。再読み込みします。
- 同意・分析・監視モジュールを1つずつ無効にします。都度再読み込みします。
- 1度のテスト用にOliveroなどコアテーマに替えます。
結果の読み方は次の通りです。
- 手順1で直る場合: 原因は圧縮です。Sortableなどエディター補助ライブラリーは
ページ残部と一緒に集約されるため、集約オンの
Sortable is not definedはここを 指します。Advanced CSS/JS Aggregationでは圧縮をJSqueezeからJSMinに替えます。 - 手順2で直る場合: そのモジュールを編集ページでは無効のままにするか、 管理者に競合を報告します。
- 手順3で直る場合: 原因はテーマのJavaScriptです。テーマからのBootstrap 3・4 JavaScript読み込みを止め、Sideload Bootstrap filesをBootstrap 5に します。
ページに「予期せぬエラー」が出る
ログにDxprBuilderService経由のスタックトレースがあり、他モジュールのビューや
ブロッククラスを名指します。
編集者向けにビルダーは全ビューディスプレイとブロックプラグインを挙げてページ追加 できるようにし、訪問者向けにページ配置のブロックとビューを描画します。どちらかの 手順でエラーを投げる壊れたビュー・ブロックが1つあるとページが落ちます。
- 開くのはReports > Recent log messagesで、トレース内名指しのビューや モジュールを探します。
- そのビューを修正・削除するか、そのモジュールを無効にします。
- 全キャッシュをクリアします。
1つのコンテンツタイプにエディターが出ない
- 開くのはStructure > Content types > (タイプ) > Manage displayを開きます。
- ビルダーフィールドの形式をDXPR Builderにします。
- 繰り返すのはフィールドを描画する全ビューモードで、Defaultだけではありません。
注記: エディターは結び付く値あるフィールドが必要です。ノード保存時、 DXPR BuilderはDefault表示でDXPR Builder形式を使う空フィールドに 値を入れます。形式変更前に保存したノードは空のままです。編集して1度保存します。
一部のユーザーにだけエディターが見える
エディターが見えないアカウントで次を確認します。
- 対象はPeople > Permissions (
/admin/people/permissions) で ロールがEdit with DXPR Builderを持ちます。 - ロールはそのコンテンツも編集できます (例: Basic page: Edit any content)。エディターはページ更新できるユーザーにだけ読み込みます。
- アカウントが有効メールアドレスを持ちます。ライセンスに必要です。
- ユーザー編集フォームでExclude from DXPR builder editingにチェックが ありません。
- 対象はDXPR Studio > DXPR Builder > User Profilesで そのロールのプロファイルがStart editor when page loadsにチェックします。 オフの場合、コントロールはコンテナーコントロールの目アイコンのクリック後にだけ 現れます。
他の編集者がコンテンツをロックした
「The content ... is locked by」という警告が同僚名付きで出て、コンテナーには Lockedボタンだけ出ます。その編集者がコンテナーに入ってまだ保存して いません。保存でロックは外れます。保存を頼むか、Lockedをクリックして確認し 引き継ぎます。両方が編集し続けると、最後の保存が勝ちます。
修正の確認
プライベートウィンドウで再読み込みし、コンテンツエリアにポイントします。 コンテナーバーにView mode、More、Saveが出て、 コンソールに赤エラーがありません。
次はこちら
更新後の問題は、エディターがリリース直後に壊れた場合です。