INTEREST JOURNAL DRUPAL & WEB

Drupalガイド:第11章 拡張とカスタマイズ

約5,100文字 読了目安:約11分

English ↗
この記事の目次

参照範囲:2026年11月4日に確認した公式公開HTMLの要約です。 ガイドの表紙 ↗ はDrupal 11を対象としていますが、公式プロジェクト ↗ は公開処理の不具合で変更がWeb版へ反映されていないと案内しています。収集済み資料との初回照合を全102項目で行い、36項目に43件の注釈を追加しました。照合範囲と章別状況 を確認できます。全手順の精査・実機での適用可否は未検証です。

この章で学ぶこと

追加機能を評価して導入し、開発環境で作った設定やコードを管理・反映する流れです。

公式の章目次 ↗

農産物市場サイトの共通シナリオを使った入門ガイドです。下の要約は概念・操作の目的と流れを整理しており、全画面・全コマンドを再現する手順書ではありません。

変更情報との照合状況

この章の11項目を収集済み資料と初回照合し、4件の注釈を選定しました。

移管先・Toolbar依存・設定インポート回帰・allowed_html差分。追加モジュール全件の安全性判定ではない。

注釈がない項目は、この資料範囲では個別の追記を選定していないという意味で、変更なし・安全・動作保証の判定ではありません。注釈の修正版番号は修正履歴を示し、現在の推奨更新先への固定指定ではありません。ベータ情報は本番導入の推奨ではありません。

注釈へ移動:

全章の照合範囲と状況

トピック別の詳細版

2026年11月6日、11トピックを日英で詳細化しました。公式に基づく説明と本サイトの補足を区別しています。詳細版の実機手順は未検証です。

項目 詳細ページ
11.1 モジュールを探して評価する
11.2 メンテナンスモードを有効・解除する
11.3 追加モジュールを取得してインストールする
11.4 テーマを探して評価する
11.5 追加テーマを導入して既定にする
11.6 独自モジュールやテーマのファイルを配置する
11.7 開発・検証・本番環境を分ける
11.8 開発用のサイトコピーを作る
11.9 開発したViewの設定を反映する
11.10 設定全体の差分を確認して同期する
11.11 コードと設定の履歴をGitで管理する

11.1. モジュールを探して評価

詳細版:説明・確認・更新注釈

用途、対応コア版、保守状況、セキュリティ対象、文書等を確認して候補を絞ります。検索結果にあることだけで選ばず、プロジェクトの状態を読む流れです。

公式原文:11.1. Finding Modules ↗

変更注釈:移管された機能の探し方

対象:11.4.0/安定版; 12.0.0-beta1/プレリリース

コア外へ移管されたモジュールも、用途・対応版・保守・セキュリティ対象を確認して選ぶ追加プロジェクトになります。必要な機能はメジャー更新前に移管先を確認します。Migrate Drupal/Migrate Drupal UIは12で削除されますが、同じように拡張版へ移管されたわけではなく、Migrate APIはコアに残ります。

根拠:Drupal 12.0.0-beta1 ↗

リリース週別記事:2026-09-28

確認:2026-11-04/公式資料との照合。Drupal実機テストは未実施。

先に読む:1.1. CMSとしてのDrupal · 1.2. 機能を担うモジュール

11.2. メンテナンスモード

詳細版:説明・確認・更新注釈

利用者へ保守中の案内を表示し、必要な権限を持つ担当者は作業を続ける仕組みです。有効化・解除と、通常利用者からの表示確認を扱います。

公式原文:11.2. Enabling and Disabling Maintenance Mode ↗

先に読む:13.3. セキュリティ更新と通常更新

11.3. 追加モジュールを導入

詳細版:説明・確認・更新注釈

Admin Toolbarを例に、Composerでコードを取得し、管理画面やDrushでインストールする流れです。必要な版と依存関係を確認してからDrupal側へ反映します。

公式原文:11.3. Downloading and Installing a Module from Drupal.org ↗

変更注釈:Admin ToolbarとToolbarを区別する

対象:Admin Toolbar/Drupal 12の互換性確認

原文のAdmin ToolbarはコアToolbarを拡張する追加モジュールです。Toolbarがコアから外れる12ベータでは、Admin Toolbar自身の対応版と依存するToolbarの提供元を併せて確認します。名称が似ていても同じモジュールではなく、ここでは12での動作確認済みとはしていません。

根拠:Admin Toolbar project ↗ · Drupal 12.0.0-beta1 ↗

リリース週別記事:2026-09-28

確認:2026-11-04/公式資料との照合。Drupal実機テストは未実施。

先に読む:1.2. 機能を担うモジュール · 11.1. モジュールを探して評価 · 3.3. 構築を助けるツール

11.4. テーマを探して評価

詳細版:説明・確認・更新注釈

Drupal.orgの検索条件やプロジェクト情報から、用途・対応版・保守・表示例・文書を確認します。見た目だけでなく運用できるかを判断する項目です。

公式原文:11.4. Finding Themes ↗

先に読む:1.1. CMSとしてのDrupal · 1.3. 見た目を担うテーマ

11.5. 追加テーマを導入

詳細版:説明・確認・更新注釈

Composer等でファイルを用意し、テーマをインストールして設定する流れです。ダウンロード、インストール、実際に利用する設定を区別します。

公式原文:11.5. Downloading and Installing a Theme from Drupal.org ↗

先に読む:11.4. テーマを探して評価 · 3.3. 構築を助けるツール

11.6. 独自拡張のファイル配置

詳細版:説明・確認・更新注釈

Composerで取得できない独自モジュールやテーマ等を扱います。適切なディレクトリへ配置した後、Drupal側で利用できる状態にする操作が別途必要です。

公式原文:11.6. Manually Installing Module or Theme Files ↗

先に読む:1.2. 機能を担うモジュール · 11.1. モジュールを探して評価 · 1.3. 見た目を担うテーマ · 11.4. テーマを探して評価

11.7. 開発環境と本番環境

詳細版:説明・確認・更新注釈

本番を直接変更せず、開発・検証用の複製で作業を進める考え方です。規模に応じた環境の役割と、段階的に本番へ反映する流れを説明します。

公式原文:11.7. Concept: Development Sites ↗

11.8. 開発用コピーを作る

詳細版:説明・確認・更新注釈

DBと必要なファイルを使って本番の複製を用意する流れです。複製先の環境や設定を準備し、実データを扱うコピーであることを意識します。

公式原文:11.8. Making a Development Site ↗

先に読む:11.7. 開発環境と本番環境

11.9. 新機能の設定を反映

詳細版:説明・確認・更新注釈

開発側で作ったViewを設定として書き出し、本番側へ取り込む例です。画面を手作業で再現する代わりに設定を移す流れを学びます。

公式原文:11.9. Deploying New Site Features ↗

変更注釈:設定取り込み前にコア版を確認する

対象:11.3.6–11.3.7/修正版:11.3.8

この章の設定取り込みには、11.3.6/11.3.7のデータ消失につながる回帰不具合が関係します。修正版以降を使用し、該当版ですでに取り込んだ場合は通常の手順で再取り込みし、差分と関連データを確認します。11.10の設定全体の同期にも同じ注意が当てはまります。

根拠:Drupal 11.3.8 ↗

関連項目:11.10. 設定を同期する · 13.5. コアを更新する手順の概要

リリース週別記事:2026-04-20

確認:2026-11-04/公式資料との照合。Drupal実機テストは未実施。

先に読む:11.8. 開発用コピーを作る · 11.10. 設定を同期する · 11.7. 開発環境と本番環境

11.10. 設定を同期する

詳細版:説明・確認・更新注釈

設定全体を書き出して別環境へ取り込み、差分を確認して同期する考え方です。コンテンツの移行とは別の処理で、元になる環境と同期対象を明確にします。

公式原文:11.10. Synchronizing Configuration Versions ↗

変更注釈:allowed_htmlの並び替え差分

対象:11.5.0-beta1; 12.0.0-beta1/プレリリース

11.5ベータではFilter HTMLのallowed_htmlがアルファベット順で保存され、設定書き出しやGit差分に並び替えが現れます。順序だけの変更とタグ・属性の許可内容の変更を区別して確認します。差分を無条件に無視するという意味ではありません。

根拠:Sorted allowed_html configuration ↗ · Drupal 11.5.0-beta1 ↗

関連項目:6.16. 形式とツールバーを設定 · 11.11. Gitで変更履歴を管理

リリース週別記事:2026-10-12

確認:2026-11-04/公式資料との照合。Drupal実機テストは未実施。

先に読む:1.5. サイトのデータの種類 · 3.1. インストール前の準備 · 11.7. 開発環境と本番環境 · 11.8. 開発用コピーを作る

11.11. Gitで変更履歴を管理

詳細版:説明・確認・更新注釈

コードと書き出した設定の変更をGitへ記録する流れです。作業内容の差分・履歴を管理するもので、DB内のコンテンツ全体を自動保存する説明ではありません。

公式原文:11.11. Managing File and Configuration Revisions with Git ↗

先に読む:3.3. 構築を助けるツール · 3.4. ダウンロードと導入方式 · 11.7. 開発環境と本番環境

出典と帰属

原典はDrupal User Guide。原著の著作権は各貢献者にあり、著作権ページ ↗ は© 2015–2025と表記しています。本ページの要約本文は英語原文を短縮・翻訳・再構成したもので、公式版や公式の承認を示すものではありません。原文と同じCC BY-SA 2.0 で提供します。サイトのデザインや他の記事へこの表示を一括適用するものではありません。全体の帰属は公式A.1 ↗ を参照してください。

以下は各原文のAttributionsに記載された著者・団体・元資料へのリンクです。個別の執筆・編集・翻案の役割は各公式原文で確認できます。

各原文の更新表示は2025年4月14日、今回の参照日は2026年11月4日です。原文・帰属・更新表示を照合資料として保存しています。

Drupal Guide · 項目索引 · 用語集の参照索引

Drupal Guide ↗