--- url: 'https://dxpr.com/ja/hc/documentation/learn-dxpr-builder/getting-started/installation' title: 'DrupalサイトへのDXPR Builderのインストール | DXPR' author: name: Jurriaan url: 'https://dxpr.com/users/jurriaan' date: '2026-10-24T14:18:17+00:00' updated: '2026-10-24T17:19:22+00:00' copyright: 'Copyright DXPR. All rights reserved.' type: article summary: |- 運用中のDrupalサイトにDXPR Builderをインストールし、プロダクトキーを追加して1つのコンテンツタイプをビルダーに切り替えます。終わる頃にはビルダー表示の保存ページができ、最初のエレメントの準備が整います。新規サイトの立ち上げには、代わりにDXPR CMSのインストールでビルダー、テーマ、コンテンツタイプをまとめて設定します。 手順の動画は既存コンテンツタイプへのインストールにあり、このページ末尾のチェックの手順2から8を説明します。 tags: - 'Install and update' image: 'https://dxpr.com/themes/custom/dxpr_com/images/dxpr-share-card.jpg' published: true og: site_name: DXPR updated_time: '2026-10-24T17:19:22+0000' 'image:alt': 'DXPR, powered by Drupal: AI-powered Drupal for marketers.' schema: '@context': 'https://schema.org' '@graph': - mainEntity: { } - '@type': TechArticle headline: 'DrupalサイトへのDXPR Builderのインストール' description: |- 運用中のDrupalサイトにDXPR Builderをインストールし、プロダクトキーを追加して1つのコンテンツタイプをビルダーに切り替えます。終わる頃にはビルダー表示の保存ページができ、最初のエレメントの準備が整います。新規サイトの立ち上げには、代わりにDXPR CMSのインストールでビルダー、テーマ、コンテンツタイプをまとめて設定します。 手順の動画は既存コンテンツタイプへのインストールにあり、このページ末尾のチェックの手順2から8を説明します。 image: '@type': ImageObject url: 'https://dxpr.com/themes/custom/dxpr_com/images/dxpr-share-card.jpg' width: '1200' height: '630' datePublished: '2026-10-24T14:18:17+0000' dateModified: '2026-10-24T17:19:22+0000' author: '@type': Organization '@id': 'https://dxpr.com/#organization' name: DXPR url: 'https://dxpr.com/' logo: '@type': ImageObject url: 'https://dxpr.com/themes/custom/dxpr_com/dxpr-logo-dark.svg' width: '1348' height: '501' publisher: '@type': Organization '@id': 'https://dxpr.com/#organization' name: DXPR url: 'https://dxpr.com/' logo: '@type': ImageObject url: 'https://dxpr.com/themes/custom/dxpr_com/dxpr-logo-dark.svg' width: '1348' height: '501' mainEntityOfPage: 'https://dxpr.com/ja/hc/documentation/learn-dxpr-builder/getting-started/installation' articleSection: インストールと更新 - '@type': WebPage '@id': 'https://dxpr.com/ja/hc/documentation/learn-dxpr-builder/getting-started/installation' description: |- 運用中のDrupalサイトにDXPR Builderをインストールし、プロダクトキーを追加して1つのコンテンツタイプをビルダーに切り替えます。終わる頃にはビルダー表示の保存ページができ、最初のエレメントの準備が整います。新規サイトの立ち上げには、代わりにDXPR CMSのインストールでビルダー、テーマ、コンテンツタイプをまとめて設定します。 手順の動画は既存コンテンツタイプへのインストールにあり、このページ末尾のチェックの手順2から8を説明します。 breadcrumb: '@type': BreadcrumbList itemListElement: - '@type': ListItem position: 1 name: ホーム item: 'https://dxpr.com/ja' publisher: '@type': Organization '@id': 'https://dxpr.com/#organization' name: DXPR inLanguage: ja --- [ヘルプセンター](/ja/node/75)/[ドキュメント](/ja/hc/documentation) /[DXPR Builderを学ぶ](/ja/hc/documentation/learn-dxpr-builder) /[ここから始める](/ja/hc/documentation/learn-dxpr-builder/start-here) /[インストールと更新](/ja/hc/documentation/learn-dxpr-builder/start-here/install) # DrupalサイトへのDXPR Builderのインストール. DXPR Builderを学ぶここから始めるインストールと更新 ## このガイドの内容 関連ガイド - [最初のページを作る](/ja/hc/documentation/learn-dxpr-builder/getting-started/first-page) - [コンテンツタイプでのDXPR Builder利用](/ja/hc/documentation/learn-dxpr-builder/getting-started/installing-on-existing-content-types) - [DXPR Builderの更新](/ja/hc/documentation/learn-dxpr-builder/getting-started/updating) 運用中のDrupalサイトにDXPR Builderをインストールし、プロダクトキーを追加して1つのコンテンツタイプをビルダーに切り替えます。終わる頃にはビルダー表示の保存ページができ、最初のエレメントの準備が整います。新規サイトの立ち上げには、代わりに[DXPR CMSのインストール](/ja/hc/documentation/learn-dxpr-builder/getting-started/installing-dxpr-cms)でビルダー、テーマ、コンテンツタイプをまとめて設定します。 手順の動画は[既存コンテンツタイプへのインストール](/ja/hc/documentation/learn-dxpr-builder/getting-started/installing-on-existing-content-types)にあり、このページ末尾のチェックの手順2から8を説明します。 ## 始める前に - Drupal 11を含むDrupal 10.2以降、PHP 8.1以降。その他は[動作要件](/ja/hc/documentation/learn-dxpr-builder/getting-started/requirements)をご覧ください。 - プロジェクトにComposerとDrush。 - プロダクトキー。DXPR Builderの動作に必要です。[dxpr.com/getting-started](/getting-started)で確認します。 ## モジュールのインストール 1. DXPR Builder 3.xをComposerでダウンロードします。バージョン3はベータリリースのため、ベータを許可します。 ```bash composer require 'drupal/dxpr_builder:^3.0@beta' ``` 通常の`composer require drupal/dxpr_builder`では、代わりに安定版の2.x系列がインストールされます。 2. モジュールを有効化します。 ```bash drush en dxpr_builder ``` DrushはKeyモジュールとDXPR Builderに必要なコアモジュール（Field、Field UI、Views、Image、Block）も有効化します。 ## プロダクトキーの追加 1. 開くのは**DXPR Studio** > **DXPR Builder** > **General Settings**（`/admin/dxpr_studio/dxpr_builder/settings`）です。 2. 場所は**License**セクションで、**Storage method**を選びます。 3. 対象は**Configuration storage**で、キーを**Product key**に貼り付けます。**Key module**では**Key**で自分のキーを選びます。 4. クリックするのは**Save settings**です。 **Configuration storage**ではキーがサイト設定に保存されるため、設定エクスポートに含まれます。**Key module**では、先に`/admin/config/system/keys`で作成したキーから読みます。そのキーに**File**または**Environment**プロバイダーを付ければ、エクスポートからも外れます。 ## サブモジュールの追加（任意） DXPR Builderには3つのサブモジュールが付属します。`drush en`と名前で有効化します。 | サブモジュール | 追加内容 | 必要なモジュール | |---|---|---| | `dxpr_builder_page` | ビルダー設定済みの**Drag and drop Page**コンテンツタイプ | 使うのはモジュール[Field Group](https://www.drupal.org/project/field_group)です | | `dxpr_builder_block` | ブロック領域向けビルダーコンテンツの**Drag and Drop Block**ブロックタイプ | 先に有効化したコアの**Block Content**モジュール | | `dxpr_builder_media` | Entity Browserベースの旧メディアブラウザー。**Extend**ページでは非表示 | Entity BrowserとInline Entity Form | ほとんどのサイトにメディアサブモジュールは不要です。インストール時にコアの**Media Library**が有効なら、ビルダーはそれを使います。それ以外は後から設定ページの**Media** > **Browser type**で選びます。詳細は[サブモジュールアーキテクチャ](/ja/hc/documentation/learn-dxpr-builder/development/submodules)をご覧ください。 ## AI機能の有効化（任意） AIページ作成、AIテキスト、AI画像は[AI](https://www.drupal.org/project/ai)モジュールと[DXPR AI Provider](https://www.drupal.org/project/ai_provider_dxpr)経由で動作します。 1. 両モジュールをダウンロードします。 ```bash composer require drupal/ai drupal/ai_provider_dxpr ``` 2. 有効化します。 ```bash drush en ai ai_provider_dxpr ``` 3. 開くのは`/admin/config/ai/providers/dxpr`で、**DXPR API Key**でプロダクトキーを持つキーを選んで保存します。 4. 開くのは`/admin/dxpr_studio/dxpr_builder/ai_settings`です。**AI Features**では初期値で3つのボックスすべてにチェックが付いています。不要な機能のチェックを外します。 各設定の説明は[AI機能ガイド](/hc/documentation/learn-dxpr-builder/ai)をご覧ください。 ## インストールの確認 ビルダーは、テキストフィールドが**DXPR Builder**フォーマッターを使うコンテンツに表示されます。以下の手順では**Body**フィールドを持つコンテンツタイプに設定します。**Drag and drop Page**タイプは`dxpr_builder_page`由来で設定済みのため、手順2から5は飛ばせます。 1. 開くのは**DXPR Studio** > **DXPR Builder** > **General Settings**で、**License**セクションでプロダクトキーを確認します。 2. 開くのは**Structure** > **Content types**です。**Body**フィールドを持つコンテンツタイプ横のメニューを開き、**Manage display**をクリックします。 3. 表示モードの一覧が開いたら、**Default**の**Manage**をクリックします。 4. Bodyの**Format**を**DXPR Builder**に変えます。 5. クリックするのは**Save**です。 6. そのタイプのコンテンツを作成し、**Title**を入力します。 7. クリックするのは**Save**です。 8. コンテンツエリアにカーソルを合わせます。DXPR Builderツールバーが表示されます。 ## 表示内容 保存したページには、本文テキストの代わりに空のビルダーが表示されます。AIプロンプト（AI設定まではグレーアウト）、**Choose a template**、**Add Elements**があります。**Add Elements**をクリックすると、**Layout**タブと**Content**タブを持つエレメントピッカーが開きます。DXPR Builderは動作しています。 ## ビルダーが表示されない場合 - **ページに本文テキストは出るがビルダーがない。** フィールドが他のフォーマッターのままです。**Structure** > **Content types** > **Manage display**で**Default**表示モードの**Format**を**DXPR Builder**にします。 - **編集フォームがプレーンテキスト領域になっている。** DXPR Builderは編集フォームではなく保存ページ上で動作します。コンテンツを保存してページを開きます。 - **ビルダーが管理者にしか表示されない。** 他のロールに**Edit with DXPR Builder**権限がありません。**People** > **Permissions**（`/admin/people/permissions`）で付与します。 - **2人目の編集者に「Only one account can use DXPR Builder on the DXPR Free tier」と出る。** 無料ティアはエディター1人です。有料サブスクリプションのプロダクトキーを**License**に入力します。 - **「Your product key is not valid」エラーが出る。** DXPR CDNがキーを拒否しました。**License**に`/admin/dxpr_studio/dxpr_builder/settings`で完全なキーを貼り付け直します。 - **「DXPR Builder cloud assets could not be loaded」エラーが出る。** ブラウザーが`cdn2.dxpr.com`や`cdn.dxpr.com`に届いていません。[ファイアウォールとデータレジデンシー](/ja/hc/documentation/learn-dxpr-builder/getting-started/behind-a-firewall)の説明どおり両ホストを許可します。 - **AIプロンプトに「AI features require the AI module」と出る。** AIモジュールが未設定です。[AI機能の有効化](#turn-on-ai-features-optional)の手順を使うか、**AI Features**で`/admin/dxpr_studio/dxpr_builder/ai_settings`の機能のチェックを外します。 - **Save settingsで「Invalid product key」と出る。** 貼り付けたテキストがキー全体でないか、DXPR Builder 1.x用のキーです。現在のキーを半角スペースや改行なしでコピーし直します。 [エディターが表示されない場合](/ja/hc/documentation/learn-dxpr-builder/troubleshooting/editor-not-loading)では他の原因も説明します。 ## 次のステップ - [最初のページ](/ja/hc/documentation/learn-dxpr-builder/getting-started/first-page)：セクション、ロー、エレメントでページを作ります。 - [既存コンテンツタイプへのインストール](/ja/hc/documentation/learn-dxpr-builder/getting-started/installing-on-existing-content-types)：他のコンテンツタイプを切り替えるか、ビルダーフィールドを追加します。 - [DXPR Builderの更新](/ja/hc/documentation/learn-dxpr-builder/getting-started/updating)：モジュールを最新に保ち、更新のたびに`drush updatedb`を実行します。 - [バリエーションのテスト](/hc/documentation/learn-dxpr-builder/integrations/ab-testing-overview)：[強化学習](https://www.drupal.org/project/rl)モジュールでのA/Bテストを確認できます。