- 赤色のリンクは、まだ日本語Codexに存在しないページ・画像です。英語版と併せてご覧ください。(詳細)
テンプレート階層
このページ「テンプレート階層」は 情報が古くなっている可能性があります。最新版(英語)も合わせてご覧ください。最新に更新してくださる協力者を求めています。
目次
はじめに
WordPress テンプレートはパズルのピースのように組み合わせられ、サイト上で Web ページを表示します。一部のテンプレート(例: ヘッダー・フッターテンプレート)はすべての Web ページ内で使用される一方、他のテンプレートはある条件の下でのみ使用されます。
このドキュメンテーションの目的
このドキュメンテーションは、次の質問に答えてくれるでしょう。
ある種類のページを表示するとき、どのテンプレートファイルが使われるのか?
このドキュメンテーションの使い方
WordPress v1.5 で「テーマ」機能が導入されて以来、テンプレートはますまカスタマイズしやすくなりました。WordPress テーマを作成するには、WordPress がブログ上の各種ページを表示するためにどのようにテンプレートファイルを選択するのかを正しく理解する必要があります。すでにあるテーマをカスタマイズしたい場合にもどのテンプレートファイルを編集すればいいのかを知る手がかりになるでしょう。
条件分岐タグを使う WordPress では、テンプレートとクエリの種類を一致させるための方法が複数用意されています。WordPress テーマ制作者は条件分岐タグを使って、あるページを生成するにはどのテンプレートが使われるのかをコントロールすることができます。ここで紹介するすべてのテンプレートファイルを使っていないテーマもありますし、条件分岐タグを使って他のテンプレートファイルを読み込ませているテーマもあります。詳しくは条件分岐タグおよびテーマの作成ページの「クエリベースのテンプレート」セクションをご覧ください。 |
概観図
次の図は、WordPress テンプレート階層に基づいてウェブページを生成する際に呼ばれるテンプレートファイルを図解したものです。訪問者がアクセスする各種ページのクエリ文字列と、それに対応する条件分岐タグ、そして、WordPress が探すテンプレートファイル名の順序を示しています。
- WordPress テンプレート階層構造図 (画像は英語版Codex にあります)
- フルサイズ画像(PNG形式)
仕組み
訪問者が WordPress サイト上のページにアクセスしたとき、WordPress は次のように動きます。
- URI に含まれるクエリ文字列とクエリタイプを照合し、要求されているページの種類(メインページ、カテゴリページなど)を判断。
- 該当するページ種類のテンプレート階層に基づき、現在のテーマディレクトリ内からテンプレートファイルを探す。
- 最初に見つかったテンプレートファイルを用いて、要求されたページを生成。
例えば、ブログが http://example.com/wp/
にあり、訪問者が http://example.com/wp/category/apple/
という「りんご」カテゴリのアーカイブページにアクセスしたとしましょう。WordPress は、現在のテーマディレクトリの中からりんごカテゴリに使えるテンプレートファイルを探します。
カテゴリページのテンプレート階層は次のとおりです。WordPress はこのリストの上から順に、ファイルがないかどうか探していき、最初に見つけたファイルを使います。
- category-slug.php -- 特定のカテゴリ用テンプレート
- category-ID.php -- 特定のカテゴリ用テンプレート
- category.php -- カテゴリの汎用テンプレート
- archive.php -- 汎用アーカイブテンプレート(タグ・日別アーカイブなどと共用)
- index.php
りんごカテゴリのスラッグが 'apple'
だった場合、WordPress はまず category-apple.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 はまず最初に、静的フロントページかどうかを判断します。静的フロントページが設定されている場合、固定ページのテンプレート階層に従ってテンプレートを読み込みます。設定されていなければ、次の順にテンプレートファイル名を探し、最初に見つかったテンプレートを使ってページを生成します。
- home.php
- index.php
単体記事ページ
- single.php
- index.php
固定ページ
- ページ作成画面の「ページテンプレート」ドロップダウンメニューで選択したファイル名
- page-slug.php - 例えば固定ページのスラッグが "about" の場合は page-about.php
- page-ID.php - 例えば固定ページの ID が6の場合は page-6.php
- page.php
- index.php
注: これは「固定ページ」を指し、ブログの一般的な記事や Web ページのことではありません。また、page-slug.php および page-id.php はバージョン2.9以降でのみ使えます。
カテゴリページ
- category-slug.php - 例えばカテゴリーのスラッグが "news" の場合は category-news.php
- category-ID.php - 例えばカテゴリID 6 用のテンプレートであれば
category-6.php
- category.php
- archive.php
- index.php
注: category-slug.php はバージョン2.9以降でのみ使えます。
タグページ
- tag-slug.php
- tag-ID.php
- tag.php
- archive.php
- index.php
注: タグテンプレートはWordPress 2.3 以上でのみ使えます。また、tag-ID.php はバージョン2.9以降でのみ使えます。
著者テンプレート
- author.php
- archive.php
- index.php
日付別ページ
例えば月別アーカイブページなど
- date.php
- archive.php
- index.php
検索結果ページ
- search.php
- index.php
404 (Not Found) ページ
- 404.php
- index.php
添付ファイルページ
記事本文への画像添付/enで 'Linked to Page' を選んだ場合に、画像のリンク先として使われるページ
- MIME_TYPE.php - image.php, video.php, audio.php, application.php, その他 MIME type の最初の部分のファイル名
- attachment.php
- single.php
- index.php
変更履歴
- 2.9 : page-slug.php、page-id.php、category-slug.php、tag-id.php を追加。
- (バージョン確認中) : 添付ファイルページに使われるテンプレートファイル名を追加。
- (バージョン確認中) : 添付ファイルページを追加。
- 2.3 : タグページを追加。