INTEREST JOURNAL DRUPAL & WEB

Drupalガイド詳細:8.2 カスタムブロックを作成する

約1,900文字 読了目安:約4分

English ↗
この記事の目次

詳細版:公式User Guide 8.2を翻訳・再構成した非公式の解説です。原文の更新表示は2025年4月14日、今回の参照日は2026年11月6日です。Drupal実機での手順検証は未実施です。

公式原文 ↗ · 前へ: 8.1 ブロックの仕組み · 第8章の入口 · 次へ: 8.3 ブロックをリージョンへ配置する

このページの目的

農産物市場の開催時間と場所を知らせるブロックを作ります。ここで保存するのはブロックの中身で、サイトのサイドバーへ配置する操作は8.3 で行います。

始める前の準備

8.1 ブロックの仕組み と公式2.1 リージョン ↗ を先に確認します。

本サイトの準備メモ:検証用サイトで、コンテンツブロックを作成できる担当者用アカウントを使います。管理用の説明と、訪問者へ伝える本文を分けて用意します。以下の日時・場所は公式の架空の市場サイトの例で、実在のイベント情報ではありません。

公式例に沿った操作

  1. 管理メニューの Content → Blocks を開きます。公式のパスは/admin/content/blockです。
  2. Add content blockを選びます。
  3. 下表のように説明と本文を入力します。画面の日本語表記は翻訳・管理テーマによって異なるため、英語の項目名も手掛かりにしてください。
  4. Saveを押し、保存された旨のメッセージを確認します。
項目 意味 公式の例を日本語で整理
Block description 管理者がブロックを識別するための名前 開催時間と場所のブロック(Hours and location block)
Body 実際に表示する本文 開催:4〜9月の日曜日、午前9時〜午後2時。場所:架空のAnytown中心部、1stとUnionの交差点にあるTrust Bank駐車場

Block descriptionは、配置時に表示するTitleとは別の項目です。 配置先と表示タイトルは8.3で設定します。

内容を修正する

公式は、Content → Blocks(/admin/content/block)で保存したブロックを探し、Editから内容を修正する手順も案内しています。開催時間などを変更したら保存します。サイドバーへ出すにはブロックの配置 を続けます。

保存後の確認例

以下は本サイトの確認例です。

  • ブロック一覧に、入力した管理用の説明が表示されているか。
  • 編集画面を開き直し、時間・場所などの本文が保存されているか。
  • 別のブロックを誤って編集していないか。
  • 配置後には、通常ユーザーや匿名ユーザーでも意図した本文が見えるか。

本文に改行や装飾を使う場合は、選択したテキスト形式と入力結果を確認します。HTMLを許可するためだけに、不要に広い編集権限を付けないようにします。

つまずいた場合

以下は本サイトの補足です。保存できたのに画面に出ない場合は、まず8.3の配置手順 を終えているかを確認します。作成や編集の項目がない場合は、導入モジュールと担当者の権限を確認します。「未公開ブロックを閲覧する権限」を付ければ作成・編集・配置もできる、とは判断しません。

更新注釈:未公開ブロックの閲覧権限

Drupal 11.4.0のリリースノート ↗ には、view unpublished block contentという権限の追加が記載されています。未公開ブロックを閲覧する編集者について、広い管理権限を与えずに必要な閲覧を許可できるかを検討する材料になります。

これは閲覧に関する権限で、作成・編集・配置や一般公開まで一括で許可する説明ではありません。実際の利用者のロールと公開状態を確認してください。第7章の権限詳細 も参照できます。

章の既存注釈 · 関連するリリース週

出典・帰属・変更内容

原典はDrupal User Guide 8.2 ↗ です。原文のAttributionsに記載された貢献者・元資料:Jacob Redding ↗ · Boris Doesborg ↗ · Managing blocks ↗ · Drupal Community Documentation ↗ 。各人の執筆・編集・翻案の役割は公式原文、全体の帰属は公式A.1 ↗ を参照してください。

原著の著作権は各貢献者にあり、公式著作権ページ ↗ は© 2015–2025と表記しています。変更点は、日本語への翻訳、説明・手順の再構成、独自の準備・確認・見直し例、原文の表記や更新情報への補足です。公式の画面画像・動画は転載していません。本文は原典と同じCC BY-SA 2.0 で提供します。公式版や公式の承認を示すものではなく、サイトデザインや無関係の記事へ適用する表示ではありません。

前へ: 8.1 ブロックの仕組み · 第8章の入口 · 次へ: 8.3 ブロックをリージョンへ配置する

第7章の詳細一覧 · 第9章 · ガイド全体 · 公式情報を検索

この章の目次へ ↗