タグ: AI, AI活用術, AI相談, archive.php, category.php, front-page.php, get_template_part, index.php, page.php, PHP, single.php, tag.php, WordPress, カスタマイズ, カスタム投稿タイプ, コーディング, テンプレート, テーマ, プロンプト, 初心者向け
- このトピックには0件の返信、1人の参加者があり、最後に
プロンプトエンジニアにより9時間、 26分前に更新されました。
-
投稿者投稿
-
5月 27, 2026 6:36 pm #1861
プロンプトエンジニアモデレーター使える場面、状況の想定
WordPressサイトのデザインを変更したり、新しい機能を追加したりするときに、プラグインを使わず、テンプレートファイルを直接編集するカスタマイズに挑戦しています。
前回と前々回のステップでは、基本的なファイル構成について学びました。
今回はさらに一歩進めて、WordPressテーマの各テンプレートファイルが、「どのような優先順位で、どのページに適用されるのか」という「テンプレート階層」の仕組みについて、AIを使って分かりやすく整理してみましょう。
実際にどのファイルを編集すればいいのかが分かれば、初心者でも実践的なカスタマイズが可能になります。
解決プロンプト(質問)
# 目的
WordPressテーマの「テンプレート階層」の仕組みを正しく理解したいです。# 質問
WordPressテーマの「テンプレート階層」について、初心者に分かるように全体像を解説してください。
個別のファイルの詳細ではなく、重要なポイントだけを整理して簡潔に教えてください。
表示されるページによって「どのページで、どのファイルが、どのような優先順位で選ばれるのか」という全体ルールの仕組みを、分かりやすくまとめてください。
実際のカスタマイズで、利用シーンが多い順番に並べて、箇条書きで出力してください。AIの回答例
WordPressテーマの「テンプレート階層」とは?
WordPressは、表示しようとしているページの種類を判断し、
「このページなら、このテンプレートファイルを使おう」
というルールで、自動的にテンプレートファイルを選びます。
この「どのファイルを優先して使うか」の仕組みが
テンプレート階層(Template Hierarchy)です。
まず理解すべき全体ルール
WordPressは基本的に、
より具体的なファイル → 汎用ファイル
の順で探します。
つまり、
専用ファイルがあればそれを使う ↓ なければ共通ファイルを使う ↓ 最後は index.phpという流れです。
最重要:最後は必ず index.php
テーマ内には最低でも:
index.php style.cssが必要です。
特に:
index.phpは「最終フォールバック」です。
他のテンプレートが無ければ、
最終的に必ず index.php が使われます。
実務でよく使う順に整理
以下が、実際のテーマカスタマイズで利用頻度が高い順です。
① 固定ページ(会社概要・お問い合わせなど)
表示対象:
- 固定ページ
優先順位:
page-{slug}.php page-{id}.php page.php index.php例:
page-contact.phpがあれば、
「contact」ページ専用デザインになります。最も実務で多いパターンです。
② 投稿ページ(ブログ記事)
表示対象:
- 個別投稿
優先順位:
single-{post-type}.php single.php index.php通常ブログなら:
single.phpがよく使われます。
カスタム投稿なら:
single-news.phpのようになります。
③ 一覧ページ(ブログ一覧など)
表示対象:
- 投稿一覧
- アーカイブ
優先順位:
home.php archive.php index.phpよくある用途:
- ブログ一覧
- お知らせ一覧
④ カテゴリー一覧
表示対象:
- カテゴリー別一覧
優先順位:
category-{slug}.php category-{id}.php category.php archive.php index.php例:
category-news.phpで「お知らせカテゴリだけ別デザイン」が可能。
⑤ タグ一覧
表示対象:
- タグページ
優先順位:
tag-{slug}.php tag-{id}.php tag.php archive.php index.phpカテゴリーとほぼ同じ考え方です。
⑥ カスタム投稿タイプ
表示対象:
- お知らせ
- 実績
- 商品
- など
個別ページ:
single-news.php一覧ページ:
archive-news.phpWordPress案件では非常によく使います。
⑦ トップページ
少し特殊です。
優先順位:
front-page.php home.php index.php重要ポイント:
-
front-page.php
→ サイトの最初のページ専用 -
home.php
→ 投稿一覧用
この違いは初心者が混乱しやすいです。
⑧ 検索結果ページ
表示対象:
- 検索結果
優先順位:
search.php index.php
⑨ 404ページ
表示対象:
- ページが存在しない時
優先順位:
404.php index.php
よくある誤解
「全部作る必要」はない
必要なものだけ作ればOKです。
例えば:
page.php single.php archive.phpだけでも、かなり運用できます。
テンプレート階層の本質
WordPressは、
「より具体的なファイルを優先する」
というルールだけ覚えれば、かなり理解できます。
イメージ:
専用ページ ↓ ページ種類 ↓ 共通 ↓ index.php
初心者向けの覚え方(超重要)
まずはこの5つだけ覚えると実務で困りにくいです。
front-page.php → トップ page.php → 固定ページ single.php → 記事ページ archive.php → 一覧ページ index.php → 最終共通ここから必要に応じて:
page-contact.php single-news.php archive-news.phpのように「専用化」していくのが基本です。
最後に:実務での考え方
実際の制作では、
- まず共通テンプレートを作る
- 特別なページだけ専用テンプレート化する
という流れが一般的です。
つまり:
最初から全部分けないのが重要です。
ポイント解説
AIの解説でも分かる通り、WordPressのテンプレート階層は「より具体的なファイルが最優先され、なければ共通ファイル(index.php)に向かっていく」というシンプルなルールで動いています。慣れれば、自分でルールを応用してファイルを拡張したり、対象ファイルを特定することも決して難しくないと思います。
もし、自分が使っているテーマの中にたくさんのファイルがあって、どれが優先されるか見極められない場合は、テーマフォルダ内のファイル名の一覧を丸ごとコピーして、そのままAIに貼り付けてみてください。
続きのプロンプトで「このファイル一覧の中で、〇〇ページを表示するときに最も優先順位が高いファイルはどれですか?」と質問すれば、AIがテンプレート階層のルールに基づいて、実際に適用されているファイルを高確率で特定してくれるはずです。注意点
テンプレート階層のルール通りに正しいファイル(例:single.php)を開いて、中身を確認しても、自分が編集したい場所(記事本文やタイトルなど)のそれらしい記述がどこにも見当たらない場合があります。
それは、WordPressテーマでは、見た目上は1つのページでも、実際にはファイルの内部がさらに細かく分割され、別のパーツファイルを読み込んでいるケースがあるためです。「ファイルを特定したけれど、編集箇所が見つからない」というときは、プログラムコードの中に以下のような「外部ファイルを読み込む記述」がないか探してみてください。
get_template_part()(※最もよく使われるパーツ読み込み関数)include/require/require_once(PHPの標準的な読み込み)load_template()/locate_template()
これらが見つかれば、それが「実際に編集すべき本当の別ファイル」を特定する重要なヒントになります。
-
投稿者投稿
- このトピックに返信するにはログインが必要です。