ページ内には広告が含まれます広告ポリシー
WordPressテーマ内にあるテンプレートファイルの役割を初心者向けに紹介します。single.php、page.php、archive.phpなどが使われるページや、テンプレート階層、ブロックテーマとの違いもまとめています。
WordPressのテンプレートファイルとは
WordPressのテンプレートファイルは、投稿ページや固定ページなどを、それぞれのページをどのような形で表示するかを決める設計図です。
記事タイトル、本文、アイキャッチ画像、サイドバーなどの情報を、ページのどこへ並べるかは、主にこのテンプレートファイルが担当しています。
テーマがサイト全体のデザインや表示方法をまとめたパッケージなら、テンプレートは、その中に用意されたページごとの表示用ファイルに当たります。
クラシックテーマでは主にPHPファイル、ブロックテーマでは主にHTMLファイルが使われます。
ページに合ったテンプレートが自動で選ばれる
WordPressでは、閲覧者が開いたページの種類に合わせて、使用するテンプレートが自動で選ばれます。
たとえば、投稿を開いたときは投稿用、固定ページを開いたときは固定ページ用のテンプレートを使って画面が作られます。
| 表示するページ | クラシックテーマ | ブロックテーマ |
|---|---|---|
| サイトのトップページ | front-page.php | front-page.html |
| 投稿一覧 | home.php | home.html |
| 投稿ページ | single.php | single.html |
| 固定ページ | page.php | page.html |
| カテゴリーやタグなどの一覧 | archive.php | archive.html |
| 検索結果 | search.php | search.html |
| ページが見つからない場合 | 404.php | 404.html |
| 共通の基本テンプレート | index.php | index.html |
すべてのテーマに、表内の全てのテンプレートを用意する必要はありません。必要なファイルがない場合は、より広い範囲で使えるテンプレートが代わりに使われます。
テンプレート階層とは
WordPressが、ページに合うテンプレートを順番に探す仕組みを「テンプレート階層」と呼びます。
たとえばカテゴリーページでは、カテゴリー専用のテンプレートを探し、見つからなければ一覧ページ共通のarchive.php、それもなければ基本となるindex.phpを使います。
この仕組みにより、サイト全体で共通の形を使いながら、投稿(記事ページ)など、特定のページだけ別のデザインにすることもできます。
一般的なHTMLサイトとの違い
一般的なHTMLサイトでは、ページごとにHTMLファイルを作り、その中へタイトル、本文、ヘッダーなどを書いてページを表示します。
WordPressでは、記事のタイトルや本文などの内容と、画面の並びを決めるテンプレートが分かれています。投稿を追加すると、その内容が投稿用のテンプレートへ自動で当てはめられます。
| 操作 | 一般的なHTMLサイト | WordPress |
|---|---|---|
| 新しい記事を追加する | 新しいHTMLファイルを作る | 管理画面から本文を入力する |
| 記事ページのデザインを変える | 対象となるHTMLファイルを修正する | 投稿用テンプレートを修正する |
| カテゴリー別の一覧を作る | 一覧ページへ記事を追加する | 記事のカテゴリーをもとに自動で表示する |
WordPressでは、記事を追加するたびにページ全体のHTMLを書く必要がなく、同じ種類のページを同じデザインで増やせるところが便利です。
投稿ページの並びを変えたい場合も、個別の記事ではなくsingle.phpを変更すると、同じテンプレートを使っている投稿へまとめて反映できます。
HTMLサイトでも共通ファイルや制作ツールを使って管理できますが、WordPressには投稿の管理、一覧ページの生成、テンプレートの選択などの仕組みが最初から用意されています。
テンプレートファイルがある場所
クラシックテーマのテンプレートファイルは、主に使用中のテーマフォルダ内に保存されています。
WordPressを設置しているサーバーでは、通常、次の場所から確認できます。
/wp-content/themes/使用中のテーマ名/
この中にsingle.php、page.php、archive.phpなどのファイルが並んでいます。
ブロックテーマでは、テーマ内のtemplatesフォルダに、single.htmlやpage.htmlなどが保存されています。
テンプレートとテンプレートパーツの違い
テンプレートがページ全体の構成を担当するのに対し、テンプレートパーツは、複数のページで繰り返し使う一部分を担当します。
| 種類 | 担当する範囲 | 主な例 |
|---|---|---|
| テンプレート | ページ全体の構成 | single.php、page.php、archive.php |
| テンプレートパーツ | 複数ページで使う一部分 | ヘッダー、フッター、サイドバー |
たとえば投稿用のsingle.phpから、ヘッダー、サイドバー、フッターのパーツを読み込み、1つの記事ページを作る形です。
テンプレートを確認・編集する方法
テンプレートの確認方法は、使用しているテーマがクラシックテーマか、ブロックテーマかによって異なります。
ブロックテーマの場合
WordPress管理画面の「外観」から「エディター」を開き、「テンプレート」を選びます。
投稿、固定ページ、アーカイブなどのテンプレートを選ぶと、ブロックエディターと同じように、画面を見ながら構成を編集できます。
クラシックテーマの場合
クラシックテーマでは、テーマフォルダ内にあるPHPファイルを確認します。自分で作成したテーマであれば、VS Codeなどのコードエディターから編集できます。
配布されているテーマのファイルを直接編集すると、テーマのアップデート時に変更が消えることがあります。編集する場合は、子テーマへ対象ファイルをコピーして変更する方法がおすすめです。
テンプレートを変更すると同じ種類のページへ反映される
テンプレートを変更すると、そのテンプレートを使用している複数のページへまとめて反映されます。
たとえばsingle.phpへサイドバーを追加すると、基本的には同じテンプレートを使っている投稿ページにもサイドバーが表示されます。
1つの記事だけを変更する操作とは異なるため、編集後はトップページだけでなく、投稿、固定ページ、カテゴリー一覧など、対象となるページを実際に開いて確認します。
まとめ
WordPressのテンプレートファイルは、投稿ページ、固定ページ、一覧ページなどの表示方法を決めるテーマ内のファイルです。
WordPressはページの種類に合ったテンプレートを自動で探し、専用ファイルがなければ、より共通的なテンプレートを使ってページを表示します。
ブロックテーマでは管理画面のサイトエディター、クラシックテーマではテーマフォルダ内のPHPファイルから確認できます。テンプレートを編集すると複数のページへ反映されるため、変更後は同じ種類のページをまとめて確認するのがおすすめです。





