FAQ.

DXPR Builderを学ぶリファレンスヘルプ

既存のコンテンツタイプにDXPR Builderを追加するには

コンテンツタイプがすでに持つ長いテキストフィールド（例：Body）を使います。ない場合は新たに追加します。次にそのフィールドのFormatを、Manage displayでDXPR Builderにします。サブモジュールは不要です。描画はコアのDXPR Builderモジュールが行います。手順はコンテンツタイプでのDXPR Builder利用をご覧ください。

コンテンツエリアにカーソルを合わせても編集コントロールが出ないのはなぜですか

順に確認します。

  1. 編集フォームではなく保存ページにいます。DXPR Builderはページ自体で動作します。
  2. ロールにEdit with DXPR Builder権限があり（/admin/people/permissions）、そのコンテンツを編集できます。
  3. アカウントに有効なメールアドレスがあります。メールアドレスのないアカウントではビルダーが読み込まれません。
  4. 無料ティアでは編集できるアカウントは1つのみです。複数の編集者には有料サブスクリプションが必要です。
  5. ユーザープロファイルでStart editor when page loadsがオフなら、先にビルダーツールバーの目アイコンをクリックします。

プロダクトキーは何を管理しますか

プロダクトキーはサイトをDXPRアカウントに結び付け、ライセンス数（編集できるユーザー数）とコンテンツアイテム上限を決めます。/admin/dxpr_studio/dxpr_builder/settingsで入力します。キーはdxpr.com/getting-startedで取得します。

プロダクトキーを安全に保存するには

Keyモジュールを使います。/admin/config/system/keysでFileまたはEnvironmentプロバイダーのキーを作成します。次にDXPR Builder設定のLicenseセクションでStorage methodにKey moduleを選び、そのキーを選びます。Configurationプロバイダーのキーは設定エクスポートに含まれます。

DXPR Builderはオープンソースですか

Drupalモジュールは、drupal.orgの全コードと同様にGPLライセンスです。編集中のみエディターのスクリプトがDXPR CDNから読み込まれます。ページは標準のBootstrap 5のHTMLとして自分のデータベースに保存され、訪問者はDXPRサーバーから何も読み込みません。

サブスクリプションを解約したらどうなりますか

サイトは動作し続け、訪問者には公開ページがすべて見えます。無料ティアはエディター1人とコンテンツアイテム100件です。上限超えのページは公開されたままですが、ビジュアルエディターは読み込まれなくなります。ライセンス概要をご覧ください。

DXPR BuilderにBootstrapは必須ですか

DXPR BuilderはBootstrap 5のHTMLを生成します。テーマがすでにBootstrap 5を読み込む場合は、Sideload Bootstrap filesをNone (theme provides Bootstrap)にします（/admin/dxpr_studio/dxpr_builder/settings）。読み込まない場合はBootstrap 5を選びます。DXPR Builderが代わりに読み込みます。

利用できるAI機能は何ですか

3つのAI機能があります（各々個別にオン・オフできます）。

  1. Text editing assistant：インラインCKEditorツールバーのAIライティングツール
  2. Page creation assistant：テキスト説明からフルページレイアウトを生成します
  3. Image generation：テキストプロンプトから画像を作成します

3つすべてにAIモジュールとDXPR AI Providerが必要です。AI機能ガイドをご覧ください。

AIを設定するには

  1. インストール対象はdrupal/aiとdrupal/ai_provider_dxpr
  2. 両モジュールの有効化にはdrush en ai ai_provider_dxpr
  3. プロバイダーの設定場所は/admin/config/ai/providers/dxpr
  4. 機能の切り替え場所は/admin/dxpr_studio/dxpr_builder/ai_settings

AIクレジットの仕組みは

すべてのAI操作（テキスト編集、ページ作成、画像生成）は、DXPRサブスクリプションのクレジットを消費します。残高は/admin/dxpr_studio/dxpr_builder/ai_settingsで確認し、追加購入はdxpr.com/user/me/subscription/creditsで行います。

DXPR Builder AIは既存コンテンツで動作しますか

動作します。Edit with AIは以前作ったページのエレメントに使えます。ビルダーはプレーンなBootstrap 5のHTMLを編集可能なエレメントに変えます。ページの作り直しは不要です。

AI生成の変更を元に戻せますか

戻せます。AI変更は他の編集と同様に取り消し履歴の手順です。変更の取り消しとやり直しをご覧ください。各保存では、リビジョンを保持するコンテンツタイプにDrupalリビジョンも作成されます。Diffモジュールでリビジョン間の差分がわかります。

AI機能をオフにできますか

できます。/admin/dxpr_studio/dxpr_builder/ai_settingsのAI FeaturesにあるEnable text editing assistant、Enable page creation assistant、Enable image generationのチェックを外します。AIモジュールなしでは、ビルダーにAI機能はまったく表示されません。他はすべて従来どおり動作します。

ページテンプレートとユーザーテンプレートの違いは何ですか

Page templatesは管理者が/admin/dxpr_studio/dxpr_builder/page_templateで管理するフルページレイアウトです。編集者は空ページのChoose a templateで選びます。

User templatesは編集者がエディター内から保存する使い回しセクションです。プライベート（作成者のみ表示）とグローバル（全ユーザーに表示）があり、エレメントピッカーのSaved templatesタブに表示されます。グローバルテンプレートは/admin/dxpr_studio/dxpr_builder/user_templatesで管理します。

詳しくはテンプレートガイドをご覧ください。

ユーザープロファイルの仕組みは

ユーザープロファイルでは、各ロールが見るエレメント、ブロック、ビュー、テンプレート、アイコンセット、テキストエディターボタンを管理します。/admin/dxpr_studio/dxpr_builder/profileでプロファイルを作成し、ロールに割り当てて利用可能な機能を設定します。ユーザーが複数プロファイルに当てはまる場合は、重みが最小のものが優先されます。ユーザープロファイルガイドをご覧ください。

新しく作成したブロック・ビュー・テンプレートがエレメントピッカーに出ないのはなぜですか

ユーザープロファイルには、許可するブロック、ビュー、ページテンプレート、グローバルユーザーテンプレートの一覧があります。Check/Uncheck all Blocksのような一覧の全選択ボックスにチェックがあると、新規項目は自動で表示されます。チェックがないと新規項目は非表示のままです。/admin/dxpr_studio/dxpr_builder/profileでプロファイルを編集し、該当セクションでチェックします。

DXPR BuilderをDrupalのLayout Builderと併用できますか

できます。DXPR Builderは個々のフィールド（通常はBodyフィールド）で動作し、DrupalのLayout Builderではありません。目的が異なります。Layout Builderはページ全体のレイアウト（リージョンとブロック）を管理し、DXPR Builderはフィールド内のリッチなコンテンツ編集を提供します。同じサイト、同じページでも併用できます。DXPR CMSはビルダーフィールドをLayout Builderレイアウト内に配置しています。

全幅セクションを作るには

  1. 追加するのはSectionエレメントで、Layoutタブからです
  2. セクションのMoreを開き、選ぶのはSettings
  3. オンにするのはFull widthで、Generalパネルで設定します。クリックするのはSave
  4. セクション内にRowを追加し、ロー内にコンテンツを追加します

Full widthではローがセクションの端から端まで広がります。セクション自体がウィンドウ端まで届くのは、フィールドまわりのテーマリージョンも全幅の場合のみです。全幅レイアウトをご覧ください。

利用できるアイコンセットは何ですか

DXPR Builderには14のアイコンセットが付属します。Bootstrap Icons、ET Line Icons、Font Awesome（v4 compat、Brands、Regular、Solid）、Glyphicon Halflings、Pixeden Line Iconsです。他にPhosphor Iconsの6種（Regular、Bold、Duotone、Fill、Light、Thin）があります。ユーザープロファイル別の利用可否は/admin/dxpr_studio/dxpr_builder/profileで管理します。

DXPR Builderを更新するには

composer update drupal/dxpr_builder --with-dependencies
drush updatedb
drush cr

更新後は必ずdrush updatedbを実行します。DXPR Builderには版間で設定を移行するデータベース更新フックが含まれます。DXPR Builderの更新でバックアップとロールバックを説明します。

次のステップ

DXPR Builderの入門で引き続きDXPR Builderを探索します。