「テンプレート階層」の版間の差分

2009年3月11日 (水) 20:41時点における版

はじめに

テンプレートは WordPress サイトを生成するために使われるファイルです。WordPress v1.5 で「テーマ」機能が導入されて以来、テンプレートはますます構造化しやすくなり、たくさんのカスタマイズを盛り込んだテーマを作成できるようになっています。サイト内の全ページを同じデザインにすることも、メインページ・カテゴリ・検索結果といった「ページの種類」毎に別のテンプレートを設けて、デザインや表示内容を変えることもできます。

テンプレート階層とは、WordPress サイトの各ページを表示する際に WordPress がチェックする、テンプレートファイル名の優先順序です。これを利用して、特に作り込みたいページ（種別）のみ専用のテンプレートファイルを設け、その他のページは共通のテンプレートで生成させる、といったことができます。

このページは、次の問いに答えを出そうとするものです。

○○（ページ）を表示するとき、どのテンプレートファイルが使われるのか？

テーマを作成するには、ブログの各ページを表示するために WordPress がテンプレートファイルを選び出す仕組みを適切に理解しておくことが不可欠です。既存の WordPress テーマをカスタマイズしたい場合も、編集すべきテンプレートファイルを判断するのに役立ちます。

次の図は、WordPress テンプレート階層に基づいてウェブページを生成する際に呼ばれるテンプレートファイルを図解したものです。訪問者がアクセスする各種ページのクエリ文字列と、それに対応する条件分岐タグ、そして、WordPress が探すテンプレートファイル名の順序を示しています。

• WordPress テンプレート階層構造図 （画像は英語版Codex にあります）
• フルサイズ画像（PNG形式）

訪問者が WordPress サイト上のページにアクセスしたとき、WordPress は次のように動きます。

1. URI に含まれるクエリ文字列とクエリタイプを照合し、要求されているページの種類（メインページ、カテゴリページなど）を判断。
2. 該当するページ種類のテンプレート階層に基づき、現在のテーマディレクトリ内からテンプレートファイルを探す。
3. 最初に見つかったテンプレートファイルを用いて、要求されたページを生成。

例えば、ブログが http://example.com/wp/ にあり、訪問者が http://example.com/wp/category/apple/ という「りんご」カテゴリのアーカイブページにアクセスしたとしましょう。WordPress は、現在のテーマディレクトリの中からりんごカテゴリに使えるテンプレートファイルを探します。

カテゴリページのテンプレート階層は次のとおりです。WordPress はこのリストの上から順に、ファイルがないかどうか探していき、最初に見つけたファイルを使います。

1. category-ID.php -- 特定のカテゴリ用テンプレート
2. category.php -- カテゴリの汎用テンプレート
3. archive.php -- 汎用アーカイブテンプレート（タグ・日別アーカイブなどと共用）
4. index.php

りんごカテゴリの ID が '4' であれば、最初に category-4.php というテンプレートファイルを探します。ディレクトリ内にそのファイル名が存在しなければ、次に category.php を探し、それもなければ archive.php を探します。それもなければ、あらゆるページに使える基本のテーマテンプレートファイル index.php を使います。

index.php はテーマに必須ですが、他のテンプレートファイルを設けるか否かは、テーマの作成者が選べます。WordPress は、一致する名前のテンプレートファイルを見つけられなければそれを飛ばし、次の候補のファイル名を探してくれます。例えば、他のページと様式を変えたいのがカテゴリID 4 だけなのであれば、テーマディレクトリ内に置くテンプレートファイルは category-4.php と index.php だけでいいのです。

WordPress がページの種類（クエリタイプ）に合うテンプレートファイルを特定する方法は一つではありません。条件分岐タグは表示しようとしているページの種類を判定できるので、その判定結果によってテンプレートファイルを切り替えたり、複数のページ種類で共通のテンプレートファイルを使い、その中の一部分だけをページ種類に応じて切り替える、といった細かい制御もできます。具体的な活用例として、デフォルトテーマの sidebar.php が参考になるでしょう。詳しくは条件分岐タグおよびテーマの作成 - クエリベースのテンプレートをご覧ください。

以下、表示するページの種類別に、WordPress に呼ばれるテンプレートファイルの順序を示します。各セクションの見出しが、冒頭の問い「○○（ページ）を表示するとき、どのテンプレートファイルが使われるのか？」の ○○ に当てはまります。

訪問者がサイトのメインページ（ホームページ）にアクセスした場合、WordPress はまず最初に、static front page/enかどうかを判断します。static front page が設定されている場合、固定ページのテンプレート階層に従ってテンプレートを読み込みます。static front page が設定されていなければ、次の順にテンプレートファイル名を探し、最初に見つかったテンプレートを使ってページを生成します。

1. home.php
2. index.php

1. single.php
2. index.php

1. ページ作成画面/enの「ページテンプレート」ドロップダウンメニューで選択したページテンプレートのファイル名
2. page.php
3. index.php

注： これは「WordPress ページ」についてであり、ブログの一般的な記事や webページのことではありません。

1. category-ID.php/en -- 例えばカテゴリID 6 用のテンプレートであれば category-6.php
2. category.php/en
3. archive.php
4. index.php

1. tag-タグスラッグ.php/en
2. tag.php/en
3. archive.php
4. index.php

注： WordPress 2.3 以上でのみ使えます。

1. author.php/en
2. archive.php
3. index.php

例えば月別アーカイブページなど

1. date.php
2. archive.php
3. index.php

1. search.php/en
2. index.php

1. 404.php
2. index.php

記事本文への画像添付/enで 'Linked to Page' を選んだ場合に、画像のリンク先として使われるページ

1. image.php, video.php, audio.php, application.php, その他 MIME type の最初の部分のファイル名
2. attachment.php
3. single.php
4. index.php

変更履歴

• （バージョン確認中） : 添付ファイルページに使われるテンプレートファイル名を追加。
• （バージョン確認中） : 添付ファイルページを追加。
• 2.3 : タグページを追加。

最新英語版： WordPress Codex » Template Hierarchy （最新版との差分）