home.phpを「ホーム画面に使用するファイル」と認識していると痛い目を見る

Web制作者初心者がWordPressでよく陥ってしまうミスに、「このページで表示したいファイルがうまく反映されない」という問題があります。

例えば、home.phpを「ホーム画面に使用するファイル」と認識していると痛い目を見る日がきます。

（かつての僕がそうでした。）

厳密に間違っているわけではないけど、その認識でいたら混乱する日が来るよね、という感じです。

home.phpに関しては名前が紛らわしいとは思うんですが、そんなこと言っていてもしょうがないので

今回の記事で、home.phpは「どのような状況だと、どのように使用されるのか」ということを認識してほしいと思います。

ということで、WordPress初心者を脱出したいと思ったら

ぜひ最後まで記事を読んでいってくださいね！

テンプレート階層を把握しよう

WordPressは、テンプレート階層という概念があり、ファイルの中で優先度が決まっています。

下はWordPress.orgの公式サイトに掲載されている画像ですが、左にあるファイルの方が優先度が高く、右にある方が優先度が低いです。

引用：https://ja.wordpress.org/team/handbook/theme-development/basics/template-hierarchy/

このテンプレート階層を正しく把握していないと、頭がこんがらがって何をやっているかわからなくなることがあります（特にオリジナルテーマ制作、開発の勉強をしている時）。

なので、この画像は公式ページからダウンロードしても良いので、保存や印刷をして

いつでも見れる状態にしておくことをお勧めします。

なお、index.phpとstyle.cssがないとテーマが作れないので

この2つのファイルは絶対に必要です。

そういう意味でも、index.phpは1番右の位置に来ています。

home.phpの位置付け

それでは、home.phpの位置付けについて解説していきますが

さっきのテンプレート階層画像の左端の、下から3番目と4番目に着目してください。

下から3番目には「Blog Posts Index page」とあります。

一方、4番目には「Site Front Page」とありますね。

home.phpは投稿一覧ページも出せる

まず「Blog Posts Index page」についてですが、これは投稿ページのことだと思ってください。

ただし、1つの投稿（各々の投稿）ではなく、投稿ページが集まった「投稿一覧ページ」です。

「Blog Posts Index page」を右にずっと辿っていくと、home.phpに辿り着くのがわかると思います。

よって、投稿一覧ページはhome.phpで表示ができます。

ちなみに、僕も最初まんまと陥ってしまいましたが

「（個別の）投稿ページはsingle.phpだから、投稿一覧ページもsingle.phpだろう」

という認識でいると、うまく反映されなくて意味がわからなくなってきます。

投稿一覧ページはhome.phpで表示ができる

設定>表示設定で「最新の投稿」を設定している場合は、トップページも出せる

次に、「Site Front Page」についてですが、すぐ右にfront-page.phpがあります。

このファイルは、サイトのトップページを表示するのによく使われるファイルですね。このファイルがあれば、このファイルの内容をトップページとして表示します。

その右に「Page Shown On Front」と「Posts Shown On Front」とあります。

先に、「Posts Shown On Front」から見ていきますが、これは「最新の投稿」という意味です。

管理画面から、設定>表示設定をいじったことがある人だったら、見たことがある表記だと思います。

この「Posts Shown On Front」をずっと右に辿っていっても、home.phpに辿り着きます。

つまり、設定>表示設定にてトップページに「最新の投稿」を設定している場合は、home.phpファイルに記述されている中身がトップページとして表示されます。

一方、「Page Shown On Front」は、固定ページのことで、ホーム画面と投稿画面を好きな固定ページに切り替えられる設定です。

こちらを辿っていくと、page-$slug.phpやpage-$id.php、page.phpに行き着きます。

home.phpは出てきません。

page.phpは通常トップページにはなり得ませんから、設定>表示設定にてトップページに「固定ページ」を設定している場合は、front-page.phpファイルに記述されている中身がトップページとして表示されます。

WordPressオリジナルテーマ開発には「Show Current Template」を利用することがおすすめ！

現在、なんのファイルが表示されているのかを把握している方が、修正がしやすいですよね。

そんなときに便利なのが、「Show Current Template」のプラグインです。

使い方は簡単で、インストールして有効化するだけで、サイトの上のバーに現在いるページに利用されているファイル名が表示されます。

ぜひテーマ開発に役立ててください！

最後に

というわけで、今回は

home.phpを「ホーム画面に使用するファイル」と認識していると痛い目を見る、ということで

テンプレート階層を正しく理解することの重要さについて解説しました。

このブログでは、今回のようにコーディングやWordPressなどに役立つ情報を発信しているので

次回の記事もぜひみてみてください！