WordPressのファイル読み込み順序の完全ガイド

WordPressのファイル読み込み順序の完全ガイド

WordPressのテーマ開発では、各ページリクエストに対してどのテンプレートファイルが読み込まれるかを理解することが重要です。この記事では、WordPressのファイル読み込み順序(テンプレート階層)について詳しく説明します。このガイドを参考にして、WordPressテーマ開発の理解を深めてください。

テンプレート階層の基本

WordPressは、ページリクエストの種類に応じて特定のテンプレートファイルを使用します。以下に、主なテンプレート階層と読み込み順序を示します。

フロントページの表示

フロントページが固定ページの場合

  1. front-page.php
  2. home.php
  3. page.php
  4. index.php

フロントページが最新の投稿の場合

  1. front-page.php
  2. home.php
  3. index.php

ホーム(ブログ投稿ページ)

  1. home.php
  2. index.php

シングル投稿ページ(単一投稿)

  1. single-{post_type}-{slug}.php
  2. single-{post_type}.php
  3. single.php
  4. singular.php
  5. index.php

固定ページ

  1. custom-template.php (ページ属性で設定されているカスタムテンプレート)
  2. page-{slug}.php
  3. page-{ID}.php
  4. page.php
  5. singular.php
  6. index.php

カテゴリアーカイブ

  1. category-{slug}.php
  2. category-{ID}.php
  3. category.php
  4. archive.php
  5. index.php

タグアーカイブ

  1. tag-{slug}.php
  2. tag-{ID}.php
  3. tag.php
  4. archive.php
  5. index.php

カスタム分類アーカイブ

  1. taxonomy-{taxonomy}-{term}.php
  2. taxonomy-{taxonomy}.php
  3. taxonomy.php
  4. archive.php
  5. index.php

カスタム投稿タイプアーカイブ

  1. archive-{post_type}.php
  2. archive.php
  3. index.php

作成者アーカイブ

  1. author-{nicename}.php
  2. author-{ID}.php
  3. author.php
  4. archive.php
  5. index.php

日付アーカイブ

  1. date.php
  2. archive.php
  3. index.php

検索結果ページ

  1. search.php
  2. index.php

404エラーページ

  1. 404.php
  2. index.php

添付ファイルページ

  1. attachment-{mime_type}.php
  2. attachment.php
  3. single-attachment.php
  4. single.php
  5. singular.php
  6. index.php

テンプレート階層の補足

  • front-page.php: フロントページに使用されるテンプレートファイルです。Settings > Reading でフロントページの表示設定に依存します。
  • home.php: ブログ投稿のメインページに使用されるテンプレートファイルです。Settings > Reading で投稿ページの設定に依存します。
  • single.php: 単一の投稿ページに使用されるテンプレートファイルです。
  • page.php: 固定ページに使用されるテンプレートファイルです。
  • archive.php: アーカイブページに使用されるテンプレートファイルです。カテゴリー、タグ、作成者、カスタム投稿タイプアーカイブなどに使用されます。
  • search.php: 検索結果ページに使用されるテンプレートファイルです。
  • 404.php: 404エラーページに使用されるテンプレートファイルです。

まとめ

WordPressのファイル読み込み順序(テンプレート階層)について理解することは、テーマ開発において非常に重要です。各ページリクエストに対して適切なテンプレートファイルを使用することで、サイトの表示をカスタマイズできます。このガイドを参考にして、WordPressのテンプレート階層を活用し、自分のサイトに最適なテーマを作成してください。

この記事を書いた人

connecti

CONNECTIは人と人を繋ぐ架け橋になるという思いで創業しました。

制作のご相談等は下記よりお願いいたします。

お手数ではございますが、下記リンクよりお問い合わせください。

お問い合わせフォームはこちら

関連記事