どのPHPファイルを作ればいいか分かる！WordPressの表示ページ順位に関わるテンプレート階層とテンプレートファイルについて解説

2022年8月30日2022年10月10日

今回は初学者の方を混乱させるテンプレート階層と使用するPHPファイルについて解説していきます。

テンプレート階層、テンプレートファイルとは

WordPressはどのPHPファイルを使用するかで表示するファイルが変わります。

例えば、トップページを表示させるためには

の3つのどれかを使用すると表示させることができますが、
このファイルを2つ以上生成している場合は、「front-page.php > home.php > index.php」の順番で表示させる優先度が決まっています。

つまり、

「front-page.php」がなければ「home.php」を表示し、「home.php」がなければ「index.php」を表示する

といった感じですね！

それで、各PHPファイルのことを『テンプレートファイル』といいます。

ちなみにこの優先度は下の図を見ると判断することができます。

多分これを初めて見る方は「なんか複雑で難しそう。。」と感じたかもしれませんので、ページの役割ごとで使用するテンプレートファイルをまとめました。

トップページを表示させるテンプレートファイルです。

このページに投稿のループやページネーションを書いて、一覧ページを作成します。

優先度	ファイル名	備考
1	home.php	基本的にはこのファイルを使用することが多い。
2	index.php

カスタム投稿の投稿一覧を表示させるページです。

優先度	ファイル名	備考
1	archive-（post_type）.php	「post_type」にはカスタム投稿のスラッグを指定する。
2	archive.php
3	index.php

個別の投稿ページを表示させるファイルです。

優先度	ファイル名	備考
1	single-（post_type）.php	カスタム投稿に使用するファイルで「post_type」には、カスタム投稿のスラッグを指定する。
2	single.php	主に通常の個別投稿ページに使用することが多い。
3	singular.php	基本的に個別投稿ページに使用することは少ない。
4	index.php

お問い合わせページや会社概要ページなどに使われるテンプレートファイルですね。

優先度	ファイル名	備考
1	（カスタムテンプレート名）.php	カスタムテンプレートファイルと言われるもの。管理画面でどのテンプレートを使うか選択する。
2	page-（slug）.php	パーマリンクに「works」と設定したら、page-works.phpとなる。
3	page-（ID）.php	管理画面でページのIDを調べて、ファイルの命名を行う。
4	page.php	管理画面のテキストエディタで記述した内容を反映するときに使う。
5	singular.php
6	index.php

任意のカテゴリー別で投稿一覧を表示させるページです。

優先度	ファイル名	備考
1	category-（slug）.php	「slug」は各カテゴリーに指定したスラッグになる。
2	category-（ID）.php	管理画面でカテゴリーのIDを調べて、ファイルの命名を行う。
3	category.php	どのカテゴリーでもページのデザインが同じ場合は、こちらを使う。
4	archive.php
5	index.php

任意のタクソノミー別で投稿一覧を表示させるページです。

優先度	ファイル名	備考
1	taxonomy-（taxonomy）-（term）.php	カスタムタクソノミーが「fruit」、タームが「apple」なら、 taxonomy-fruit-apple.phpとなる。
2	taxonomy-（taxonomy）.php	基本的にはこのファイルを使用することが多い。カスタムタクソノミーが「fruit」なら、 taxonomy-fruit.phpとなる。
3	taxonomy.php	このファイルを使用することは少ない。
4	archive.php
5	index.php

任意のタグ別で投稿一覧を表示させるページです。

優先度	ファイル名	備考
1	tag-（slug）.php	「slug」は各タグに指定したスラッグになる。
2	tag-（ID）.php	管理画面でタグのIDを調べて、ファイルの命名を行う。
3	tag.php	タグを指定しなくてもタグ一覧ページを表示させることができます。
4	archive.php
5	index.php

WordPressでは、任意で指定した作成者が投稿したページを一覧として表示することができます。
そのテンプレートファイルになります。

ただ、使用する機会は他のテンプレートに比べて少ないです。

優先度	ファイル名	備考
1	author-（nicename）.php	（nicename）は管理画面で設定したユーザー名を指定します。
2	author-（ID）.php	管理画面でユーザーのIDを調べて、ファイルの命名を行う。
3	author.php	ユーザーを指定しなくてもユーザー一覧ページを表示させることができます。
4	archive.php
5	index.php