【WordPress】テンプレートの階層・優先順位について解説

シュウ

今回は【WordPress】テンプレートの階層・優先順位について解説!!
の解説になります！

こんな方に読んでほしい

WordPressを学び始めた方へ
WordPressのテンプレートの階層・優先順位について解説していきます。
今回はWordPressの「テンプレート」について解説しております。

[記事の内容]

WordPressの階層・優先順位について

前回は、オリジナルテーマを作成し、「index.php」をサイト上にアップすることができました。
最初に主なWordPressのテンプレートを確認しましょう。

●index.php: テーマの必須ファイルになります。

●front-page.php: サイトのトップページファイルになります。

●sidebar.php: サイドバーファイルになります。

●single.php: 投稿記事詳細ファイルになります。

●page.php: 固定ページ用のテンプレートファイルになります。

●category.php: カテゴリーテンプレートファイルになります。

●archive.php: 日付別アーカイブファイルになります。

●tag.php: タグファイルになります。

●author.php: 作成者別ファイルになります。

●date.php: 日付ごとのアーカイブファイルになります。

●search.php: 検索用ファイルになります。

●404.php: エラーファイルになります。

上記のように、Webサイトはページごとにデザインが変わってきます。
たとえば、記事一覧ページは「page.php」の固定ページ、記事詳細ページは「single.php」の投稿記事詳細ファイルを使います。
このようにテンプレートファイルを使い分けて表示させることになります。

テンプレートの階層とは

WordPressには、テンプレートの階層・優先順位があります。
WordPressは、アクセスされたページによって優先順位が高いテンプレートファイルが表示します。

たとえばトップページにアクセスした場合、テーマフォルダに「front-page.php」と「index.php」のファイルが存在します。
その場合は、「front-page.php」の方が優先順位が高いため、優先して表示します。

上記のように、テンプレートを表示するルールを「テンプレートの階層」と言います。

ポイント！
テンプレート階層で、最も優先順位が低いファイルが「index.php」ファイルになります。
たとえば、全てのページが同じデザインであれば、「index.php」　ファイルが1つあれば問題ありません。
エラーファイル「404.php」がない場合にも、最も優先順位が低い「index.php」が表示します。
つまり、テーマには、「index.php」が最低限必要になってきます。

トップページのテンプレートの階層

上記で解説したように、トップページのテンプレートの階層が一番高いファイルは「front-page.php」になります。

1:優先順位高い	front-page.php
2	固定ページに登録してる場合 WordPress管理画面にて、設定 > 表示設定 > 「フロントページの表示」に設定されている場合
3	home.php
4:優先順位低い	index.php

固定ページのテンプレートの階層

固定ページは、「会社概要」、「お問い合わせ」など、1ページで完結する時によく使われます。

1:優先順位高い	page-{slug}.php 例：お問い合わせの場合：「page-contact.php」になります。
2	page-{ID}.php 固定ページの登録した場合のIDになります。例：「post.php?post=〇〇&action=edit」〇〇の数字　「page-〇〇.php」を入力します。
3	page.php
4:優先順位低い	index.php

投稿ページ(記事詳細)の階層

投稿ページでは、通常の「投稿」タイプで記事を書いた際には、「single.php」ファイルを使います。
ただし、カスタム投稿タイプで記事を書いた際には、「post-type」を使います。

1:優先順位高い	single-{post-type}.php 「post-type」には、カスタム投稿名を入力します。例：ブログの場合：「single-blog.php」になります。
2	single.php 通常の「投稿」タイプで記事を書いた場合
3	singular.php
4:優先順位低い	index.php

カテゴリー別記事一覧ページのテンプレートの階層

すべてのカテゴリーを１つのデザインで統一する場合は、「category.php」ファイルのみで
問題はありません。
カテゴリー毎にデザインを変更する場合は、カテゴリーのスラッグやidで振り分けが必要になります。

1:優先順位高い	category-{slug}.php 例：カテゴリーのスラッグ名が「news」の場合：「category-news.php」になります。
2	category-{ID}.php 例：カテゴリーのidが「10」の場合：「category-10.php」になります。
3	category.php
4	archive.php
5:優先順位低い	index.php

タグページのテンプレートの階層

上記で解説した、「カテゴリー」のテンプレートの階層と似ています。
すべてのタグページを１つのデザインで統一する場合は、「tag.php」ファイルのみで
問題はありません。
タグ毎にデザインを変更する場合は、タグのスラッグやidで振り分けが必要になります。

1:優先順位高い	tag-{slug}.php 例：タグのスラッグ名が「news」の場合：「tag-news.php」になります。
2	tag-{ID}.php 例：タグのidが「10」の場合：「tag-10.php」になります。
3	tag.php
4	archive.php
5:優先順位低い	index.php