WordPress.org (日本語)
また、テンプレートファイルがモジュール化されており、再利用可能なファイルを生成するために使用されるwebページをごWordPressサイトです。 一部のテンプレートファイルなどのヘッダ、フッターテンプレート)で使用されるすべてのサイトのページを使用しており、特定条.
この記事では、WordPressが個々のページで使用するテンプレートファイルを決定する方法について説明します。 既存のWordPressテーマをカスタマイズする場合は、編集する必要があるテンプレートファイルを決定するのに役立ちます。,
テンプレートファイル階層#テンプレートファイル階層
Overview#Overview
WordPressは、ページを表示するために使用するテンプレートまたはテンプレートのセット クエリ文字列は、webサイトの各部分へのリンクに含まれる情報です。 これは、最初の疑問符の後に来て、アンパサンドで区切られたパラメータの数を含むことができます。,
簡単に言えば、WordPressは、一致するテンプレートファイルが見つかるまで、テンプレート階層を下に検索します。 使用するテンプレートファイルを決定するには、WordPress:
- すべてのクエリ文字列をクエリタイプに一致させて、要求されているページ(検索ページ、カテゴリページなど)を決定します。
- テンプレート階層によって決定された順序でテンプレートを選択します。
- 現在のテーマのディレクトリ内の特定の名前を持つテンプレートファイルを検索し、階層によって指定された最初の一致するテンプレートファイルを使用します。,
基本的なindex.php
テンプレートファイルを除いて、特定のテンプレートファイルを実装するかどうかを選択できます。
WordPressが一致する名前のテンプレートファイルを見つけることができない場合、階層内の次のファイルにスキップします。 WordPressが一致するテンプレートファイルを見つけることができない場合は、テーマのindex.php
ファイルが使用されます。,
Top
Examples#Examples
あなたのブログがにあり、訪問者が
のようなカテゴリページへのリンクをクリックすると、WordPressはカテゴリのIDと一致する現在のテーマのディレクトリ内のテンプレートファイルを探して正しいページを生成します。 より具体的には、WordPressは次の手順に従います。
- カテゴリのスラッグに一致する現在のテーマのディレクトリ内のテンプレートファイルを探します。 カテゴリスラッグが”unicorns”の場合、WordPressは
category-unicorns.php
という名前のテンプレートファイルを探します。, -
category-unicorns.php
がなく、カテゴリのIDが4の場合、WordPressはcategory-4.php
という名前のテンプレートファイルを探します。 -
category-4.php
がない場合、WordPressは一般的なカテゴリテンプレートファイルcategory.php
を探します。 -
category.php
が存在しない場合、WordPressは一般的なアーカイブテンプレートarchive.php
を探します。 -
archive.php
も欠落している場合、WordPressはメインテーマテンプレートファイルindex.php
にフォールバックします。,
Top
Visual Overview#Visual Overview
次の図は、WordPressテンプレート階層に基づいてWordPressページを生成するために呼び出されるテンプレートファイルを示しています。
Top
テンプレート階層の詳細#テンプレート階層の詳細
テンプレート階層は図として理解しやすいですが、以下のセクションでは、WordPressによって多くのクエリタイプに対してテンプレートファイルが呼び出される順序について説明します。
Top
ホームページ表示#ホームページ表示
デフォルトでは、WordPressはサイトのホームページを最新のブログ投稿を表示するように設定します。 このページはblog posts indexと呼ばれます。 また、ブログ記事を別の静的ページに表示するように設定することもできます。, テンプレートファイルhome.php
は、フロントページとして使用されているか、別の静的ページで使用されているかにかかわらず、ブログ投稿インデック home.php
が存在しない場合、WordPressはindex.php
を使用します。
home.php
index.php
注:front-page.php
が存在する場合、home.php
テンプレートをオーバーライドします。,
Top
Front Page display#Front Page display
front-page.php
テンプレートファイルは、フロントページにブログ記事インデックス(上記)または静的ページが表示されるかどうか、サイトのフロントページをレンダリングするために使用されます。 フロントページテンプレートは、ブログ記事インデックス(home.php
)テンプレートよりも優先されます。 front-page.php
ファイルが存在しない場合、WordPressはhome.php
またはpage.php
ファイルを設定→読み取りの設定に応じて使用します。, これらのファイルがどちらも存在しない場合は、index.php
ファイルが使用されます。
-
front-page.php
-設定→読み取りのフロントページ表示セクションで設定されている”あなたの最新の投稿”または”静的ページ”の両方に使用されます。 -
home.php
–WordPressがfront-page.php
を見つけることができず、”最新の投稿”がフロントページの表示セクションに設定されている場合、home.php
を探します。 また、WordPressがあることからこのファイルの場合、ページ設定のフロントページに示します。, page.php
-
index.php
–フロントページの表示セクションで”最新の投稿”が設定されているが、home.php
が存在しないか、フロントページが設定されているがpage.php
ご覧のとおり、WordPressが取るパスには多くのルールがあります。 上記のチャートを使用することは、WordPressが何を表示するかを判断する最良の方法です。,
Top
プライバシーポリシーページ表示#プライバシーポリシーページ表示
privacy-policy.php
テンプレートファイルは、サイトのプライバシーポリシーページをレンダリ プライバシーポリシーページテンプレートは、静的ページ(page.php
)テンプレートよりも優先されます。 privacy-policy.php
ファイルが存在しない場合、WordPressはpage.php
またはsingular.php
利用可能なテンプレートに応じてファイルを使用します。 これらのファイルがどちらも存在しない場合は、index.php
ファイルが使用されます。,
-
privacy-policy.php
–設定→プライバシーのプライバシーポリシーページの変更セクションで設定されたプライバシーポリシーページに使用されます。 -
custom template file
–ページに割り当てられたページテンプレート。get_page_templates()
を参照してください。 -
page-{slug}.php
–ページスラッグがprivacy
の場合、WordPressはpage-privacy.php
を使用するように見えます。 -
page-{id}.php
を使用するように見えます。, page.php
singular.php
index.php
Top
シングルポスト#シングルポスト
シングルポストテンプレートファイルは、単一のポストをレンダリングするために使用されます。 WordPressは次のパスを使用します。
Top
Single Page#Single Page
静的ページをレンダリングするために使用されるテンプレートファイル(page
post-type)。,es,page
WordPressにとって特別なパスであり、次のパスを使用します。
Top
Category#Category
カテゴリアーカイブインデックスページのレンダリングはWordPressで次のパスを使用します。
Top
Tag#Tag
タグアーカイブインデックスページを表示するには、WordPressは次のパスを使用します。
Top
カスタム分類法#カスタム分類法
カスタム分類法は、わずかに異なるテンプレートファイルパスを使用します。
top
カスタム投稿タイプ#カスタム投稿タイプ
カスタム投稿タイプは、適切なアーカイブインデックスページをレンダリングするために次のパスを使用します。,
-
archive-{post_type}.php
–投稿タイプがproduct
の場合、WordPressはarchive-product.php
を探します。 archive.php
index.php
(単一のポストタイプテンプレートをレンダリングするには、上記の単一のポスト表示のセクションを参照してください。,s”は同じパターンとしてのその他のテンプレート種類:
search.php
index.php
トップ
404(Not Found)#404(Not Found)
また、404テンプレートファイルと呼ばれるこの順:
404.php
index.php
トップ
添#添付の場合
をレンダリング取付ページ(attachment
後タイプ)用のパス:
トップ
埋め込む#埋め込む
組み込みテンプレートファイルを描画するために使用されるポストにおいて導入されています。, 4.5以降、WordPressは次のパスを使用します。
-
embed-{post-type}-{post_format}.php
–まず、WordPressは特定の投稿のテンプレートを探します。 たとえば、投稿タイプがpost
で、オーディオフォーマットがある場合、WordPressはembed-post-audio.php
を探します。 -
embed-{post-type}.php
–投稿タイプがproduct
の場合、WordPressはembed-product.php
を探します。 -
embed.php
-WordPressは埋め込みにフォールバックします.php
。, - 最後に、WordPressは最終的に独自の
wp-includes/theme-compat/embed.php
テンプレートにフォールバックします。
Top
非ASCII文字の処理#非ASCII文字の処理
WordPress4.7以降、非ASCII文字を名前に含むテンプレート名の動的部分は、実際には非エンコード形式とエンコード形式の両方をこの順序でサポートしています。 どちらを使用するかを選択できます。,
こんにちは、6
:
page-hello-world-😀.php
page-hello-world-%f0%9f%98%80.php
page-6.php
page.php
singular.php
投稿スラッグ、用語名、および作成者のnicenamesにも同じ動作が適用されます。
Top
Filter Hierarchy#Filter Hierarchy
WordPressテンプレートシステムでは、階層をフィルタリングできます。, これは、階層の特定のポイントで物事を挿入したり変更したりできることを意味します。 フィルター(get_query_template()
関数にあります)は、次のフィルター名を使用します。"{$type}_template"
ここで、$type
はテンプレートタイプです。,category_template
tag_template
author_template
date_template
archive_template
index_template
Top
Example #Example
For example, let’s take the default author hierarchy:
author-{nicename}.php
author-{id}.php
author.php
To add author-{role}.php
before author.php
, we can manipulate the actual hierarchy using the ‘author_template’ template type., これにより、usernameがeditorの役割を持つ/author/usernameに対する要求がauthor-editorを使用して表示されます。現在のテーマディレクトリにphpが存在する場合。