WordPressでテンプレートを作成して固定ページに適用する

テンプレート階層

WordPressではテンプレート階層というものがあり、ページを読み込む際、どのファイルを優先的に読み込むかが決められています。固定ページでは以下の優先度でファイルが読み込まれます。

1. カスタムテンプレートファイル(任意の名前)
2. page-{slug}.php
3. page-{id}.php
4. page.php
5. singular.php
6. index.php

page.phpは優先度が低めになっています。上の階層でテンプレートファイルを設定しておけばそちらを読み込むように設定できることがわかります。
それぞれの設定方法について、詳しく解説していきます。

カスタムテンプレートファイルを使用してテンプレートを読み込む

プログラムの先頭に「Template Name」を設定することで、ファイル名関係なくテンプレートとして設定できるようになります。今回は名前を「固定ページのテンプレート」にして設定していきます。

上記のようにファイルに「Template Name」を設定すると、以下のように管理画面の投稿の属性に固定ページの属性にテンプレートという項目が追加されます。

先ほど設定した「固定ページのテンプレート」が選択できるようになっています。これを選択すれば適用されます。

「Template Name」を設定しておけば、どの固定ページからも読み込むことができます。
一つのテンプレートを複数の固定ページに使い回すことができるために非常に便利です。

page-***.phpを利用

***にはページのスラッグやページのIDを入れることができます。
該当するスラッグやページIDのページには、自動的にこのテンプレートが適用されて表示されます。

こちらはファイル名でテンプレートであることを示しているため、「Template Name」の設定は必要ありません。

page.phpを利用

既存テーマを使用する場合、大抵デフォルトで入っています。

WordPressを導入してから特にいじっていない場合、こちらのファイルが固定ページのテンプレートとして使用されているでしょう。

直接編集することも可能ですが、個別のテンプレートを使用しない全ての固定ページに影響が出ることに注意してください。

singular.phpを利用

こちらはWordPress4.3から新たに追加されたファイルです。
page.phpがない場合に読み込まれます。

このファイルは投稿ページ用テンプレートとして使用されているsingle.phpファイルが存在しない場合に読み込まれるファイルでもあります。

つまり、投稿ページと固定ページのテンプレートを同じにしたい場合、わざわざ二つテンプレートファイルを作らなくてもsingular.phpを１つ作ればどちらからも読み込まれるようになるということです。
投稿ページと固定ページで同じデザインにしたい場合はぜひ使用してみてください。

まとめ

当記事では固定ページにテンプレートを適用する方法を説明しました。

テンプレートをうまく使い分けることで、ページごとに最適な構成を実現できます。

また、既存の投稿ページでも固定ページでもない、新しいカスタム投稿タイプを作りたい、という場合は、以下の記事を参考にしてみてください。

WordPressのカスタム投稿について