Codepia

WordPressのテンプレートファイルとは?ページごとに表示が変わる仕組み

ページ内には広告が含まれます広告ポリシー

WordPressテーマ内にあるテンプレートファイルの役割を初心者向けに紹介します。single.php、page.php、archive.phpなどが使われるページや、テンプレート階層、ブロックテーマとの違いもまとめています。

WordPressのテンプレートファイルとは

WordPressのテンプレートファイルは、投稿ページや固定ページなどを、それぞれのページをどのような形で表示するかを決める設計図です。

記事タイトル、本文、アイキャッチ画像、サイドバーなどの情報を、ページのどこへ並べるかは、主にこのテンプレートファイルが担当しています。

WordPressテーマ内のテンプレートがページの表示を作る関係

テーマがサイト全体のデザインや表示方法をまとめたパッケージなら、テンプレートは、その中に用意されたページごとの表示用ファイルに当たります。

クラシックテーマでは主にPHPファイル、ブロックテーマでは主にHTMLファイルが使われます。

ページに合ったテンプレートが自動で選ばれる

WordPressでは、閲覧者が開いたページの種類に合わせて、使用するテンプレートが自動で選ばれます

投稿や固定ページなどに対応するWordPressのテンプレートファイル

たとえば、投稿を開いたときは投稿用、固定ページを開いたときは固定ページ用のテンプレートを使って画面が作られます。

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を使います。

専用テンプレートからindex.phpまで順番に探すWordPressのテンプレート階層

この仕組みにより、サイト全体で共通の形を使いながら、投稿(記事ページ)など、特定のページだけ別のデザインにすることもできます。

一般的なHTMLサイトとの違い

一般的なHTMLサイトでは、ページごとにHTMLファイルを作り、その中へタイトル、本文、ヘッダーなどを書いてページを表示します。

WordPressでは、記事のタイトルや本文などの内容と、画面の並びを決めるテンプレートが分かれています。投稿を追加すると、その内容が投稿用のテンプレートへ自動で当てはめられます。

操作 一般的なHTMLサイト WordPress
新しい記事を追加する 新しいHTMLファイルを作る 管理画面から本文を入力する
記事ページのデザインを変える 対象となるHTMLファイルを修正する 投稿用テンプレートを修正する
カテゴリー別の一覧を作る 一覧ページへ記事を追加する 記事のカテゴリーをもとに自動で表示する

WordPressでは、記事を追加するたびにページ全体のHTMLを書く必要がなく、同じ種類のページを同じデザインで増やせるところが便利です。

投稿ページの並びを変えたい場合も、個別の記事ではなくsingle.phpを変更すると、同じテンプレートを使っている投稿へまとめて反映できます。

HTMLサイトでも共通ファイルや制作ツールを使って管理できますが、WordPressには投稿の管理、一覧ページの生成、テンプレートの選択などの仕組みが最初から用意されています。

テンプレートファイルがある場所

クラシックテーマのテンプレートファイルは、主に使用中のテーマフォルダ内に保存されています。

WordPressを設置しているサーバーでは、通常、次の場所から確認できます。

/wp-content/themes/使用中のテーマ名/

この中にsingle.phppage.phparchive.phpなどのファイルが並んでいます。

ブロックテーマでは、テーマ内のtemplatesフォルダに、single.htmlpage.htmlなどが保存されています。

テンプレートとテンプレートパーツの違い

テンプレートがページ全体の構成を担当するのに対し、テンプレートパーツは、複数のページで繰り返し使う一部分を担当します。

種類 担当する範囲 主な例
テンプレート ページ全体の構成 single.php、page.php、archive.php
テンプレートパーツ 複数ページで使う一部分 ヘッダー、フッター、サイドバー

たとえば投稿用のsingle.phpから、ヘッダー、サイドバー、フッターのパーツを読み込み、1つの記事ページを作る形です。

テンプレートを確認・編集する方法

テンプレートの確認方法は、使用しているテーマがクラシックテーマか、ブロックテーマかによって異なります。

ブロックテーマの場合

WordPress管理画面の「外観」から「エディター」を開き、「テンプレート」を選びます。

WordPressのサイトエディターでテンプレート一覧を開く画面
テンプレート編集画面

投稿、固定ページ、アーカイブなどのテンプレートを選ぶと、ブロックエディターと同じように、画面を見ながら構成を編集できます。

クラシックテーマの場合

クラシックテーマでは、テーマフォルダ内にあるPHPファイルを確認します。自分で作成したテーマであれば、VS Codeなどのコードエディターから編集できます。

配布されているテーマのファイルを直接編集すると、テーマのアップデート時に変更が消えることがあります。編集する場合は、子テーマへ対象ファイルをコピーして変更する方法がおすすめです。

テンプレートを変更すると同じ種類のページへ反映される

テンプレートを変更すると、そのテンプレートを使用している複数のページへまとめて反映されます。

たとえばsingle.phpへサイドバーを追加すると、基本的には同じテンプレートを使っている投稿ページにもサイドバーが表示されます。

1つの記事だけを変更する操作とは異なるため、編集後はトップページだけでなく、投稿、固定ページ、カテゴリー一覧など、対象となるページを実際に開いて確認します。

まとめ

WordPressのテンプレートファイルは、投稿ページ、固定ページ、一覧ページなどの表示方法を決めるテーマ内のファイルです。

WordPressのテンプレートファイルが選ばれる仕組み

WordPressはページの種類に合ったテンプレートを自動で探し、専用ファイルがなければ、より共通的なテンプレートを使ってページを表示します。

ブロックテーマでは管理画面のサイトエディター、クラシックテーマではテーマフォルダ内のPHPファイルから確認できます。テンプレートを編集すると複数のページへ反映されるため、変更後は同じ種類のページをまとめて確認するのがおすすめです。

トップへ戻る