• 赤色のリンクは、まだ日本語Codexに存在しないページ・画像です。英語版と併せてご覧ください。(詳細

このWikiはいつでも誰でも編集できます

「トーク:テンプレート階層」の版間の差分

提供: WordPress Codex 日本語版
移動先: 案内検索
(新しいページ: '== 英語版と変えている部分について == * 一通り和訳したものの、意図が不明瞭な部分や過剰装飾に思える箇所がある。[http://codex.wo...')
 
(一通り和訳)
2行目: 2行目:
  
 
* 一通り和訳したものの、意図が不明瞭な部分や過剰装飾に思える箇所がある。[http://codex.wordpress.org/index.php?title=Template_Hierarchy&diff=39486&oldid=36619 2007年4月15日の編集]で大きく変化している。
 
* 一通り和訳したものの、意図が不明瞭な部分や過剰装飾に思える箇所がある。[http://codex.wordpress.org/index.php?title=Template_Hierarchy&diff=39486&oldid=36619 2007年4月15日の編集]で大きく変化している。
 +
** 最新版と以前の版を一通り和訳してみる。
 
* [[:en:Creating an Archive Index]] は <code>archive'''s'''.php</code>(デフォルトテーマの「ページテンプレート」)についてのページなので、<code>archive.php</code> に付いているリンクを外す。本家版ではリンクの付け外しが繰り返されているので、ノートで話し合いたいが、英語で提案できない。。orz
 
* [[:en:Creating an Archive Index]] は <code>archive'''s'''.php</code>(デフォルトテーマの「ページテンプレート」)についてのページなので、<code>archive.php</code> に付いているリンクを外す。本家版ではリンクの付け外しが繰り返されているので、ノートで話し合いたいが、英語で提案できない。。orz
 
* 例示の domain.com は実在するので example.com に訂正(下表でも)。
 
* 例示の domain.com は実在するので example.com に訂正(下表でも)。
14行目: 15行目:
 
== Introduction ==  
 
== Introduction ==  
  
WordPress Templates fit together like the pieces of a puzzle to generate the web pages on your WordPress site. Some templates (the header and footer template files for example) are used on all the web pages, while others are used only under specific conditions.
+
WordPress テンプレートは、WordPress サイトのウェブページを生成するために、パズルのピースのように組み合わさります。一部のテンプレート(例えばヘッダやフッタのテンプレートファイル)が全てのウェブページで用いられる一方、特定の条件下でのみ使われるテンプレートファイルもあります。
  
 
=== What this article is about ===
 
=== What this article is about ===
  
This article seeks to answer the following question:
+
このページは、次の問いに答えようとするものです。
  
 
<blockquote>
 
<blockquote>
''Which template file(s) will WordPress use when it displays a certain type of page?''
+
''ある種類のページを表示するとき、WordPress はどのテンプレートファイルを使う?''
 
</blockquote>
 
</blockquote>
  
 
=== Who might find this useful ===
 
=== Who might find this useful ===
  
Since the introduction of [[Using Themes|Themes]] in WordPress v1.5, [[Templates]] have become more and more configurable. In order to [[Theme_Development|develop]] WP themes, a proper understanding of the way WordPress selects template files to display the various pages on your blog is essential. If you seek to customize an existing WordPress theme, this article aims to help you decide which template file needs editing.
+
WordPress v1.5 における [[:ja:Using Themes|「テーマ」]]の導入以来、[[テンプレート]]はますます構造化?設定?しやすくなっています。[[テーマの作成|WordPress テーマを作成]]するには、ブログの各ページを表示するために WordPress がテンプレートファイルを選び出す仕組みを適切に理解しておくことが不可欠です。既存の WordPress テーマをカスタマイズしようとしているなら、編集すべきテンプレートファイルを判断するのに役立ちます。
  
 
{| cellspacing="3"
 
{| cellspacing="3"
32行目: 33行目:
 
|class="MainPageKnowledgeBaseBox" style="border: 1px solid #ffc9c9; padding: 1em; color: #000000; background-color: #fff3f3"|
 
|class="MainPageKnowledgeBaseBox" style="border: 1px solid #ffc9c9; padding: 1em; color: #000000; background-color: #fff3f3"|
 
=== Conditional Tags and the Template Hierarchy ===
 
=== Conditional Tags and the Template Hierarchy ===
 +
(以前の版では "Note the parallels between the Template Hierarchy and the Conditional Tags." の一言だったので、それを膨らませたのかもしれない。)
  
WordPress provides more than one way to match templates to query types. WordPress Theme developers can also use [[Theme_Development#Query-based_Templates|Conditional Tags]] to control which templates will be used to generate a certain page. Some WordPress Themes may not implement all of the template files described here. Some Themes use conditional tags to load other template files. See the [[Theme Development#Query-based Templates|Theme Development]] and [[Conditional Tags]] pages for more.
+
WordPress がテンプレートと表示を要求されたページ種類(クエリタイプ)とを照合する方法/クエリタイプに合うテンプレートを特定する方法は一つではありません。WordPress テーマの開発者は、あるページの生成に使われるテンプレートを制御するために、[[テーマの作成#Query-based_Templates|条件タグ]]を使うこともできます。以下に説明する全テンプレートファイルを実装してない WordPress テーマがあるかもしれません。他のテンプレートファイルをロードするために条件タグを使うテーマもあります。詳しくは[[テーマの作成#Query-based Templates|テーマの作成]]および[[:ja:Conditional Tags|条件タグ]]のページをご覧ください。
 
|}
 
|}
  
40行目: 42行目:
 
=== The General Idea ===
 
=== The General Idea ===
  
WordPress uses the [[Glossary#Query_string|Query String]] &mdash; information contained within each link on your web site &mdash; to decide which template or set of templates will be used to display the page.
+
WordPress は、ページの表示に使うテンプレート(またはその一組)決めるために、[[用語集#Query_string|Query String]] &mdash; ウェブサイト上の各リンクに含まれる情報 &mdash; を使います。
  
First, WordPress matches every Query String to query types &mdash; i.e. it decides what type of page (a search page, a category page, the home page etc.) is being requested.
+
最初に、WordPress は各 Query String とクエリタイプを照合します。&mdash; すなわち、要求されているページの種類(検索結果ページ、カテゴリページ、ホームページなど)を判断します。
  
Templates are then chosen &mdash; and web page content is generated &mdash; in the order suggested by the WordPress Template hierarchy, depending upon what templates are available in a particular WordPress Theme.
+
テンプレートはそのときに、その WordPress テーマの中に存在するテンプレートファイルに応じて、WordPress テンプレート階層によって示される順に選ばれます。 &mdash; そして、ウェブページのコンテンツが生成されます。 &mdash;  
  
WordPress looks for template files with specific names in the current Theme's directory and uses the ''first matching'' template file listed under the appropriate query section below.
+
WordPress は、現在のテーマディレクトリ内に特定の名前のテンプレートファイルがないか探し、下記の該当するクエリセクションに載っているテンプレートファイルから''最初に一致''したものを使います。
  
With the exception of the basic <tt style="font-weight:bold; color:#036"><nowiki>index.php</nowiki></tt> template file, Theme developers can choose whether they want to implement a particular template file or not. If WordPress cannot find a template file with a matching name, it skips down to the next file name in the hierarchy. If WordPress cannot find any matching template file, <tt style="font-weight:bold; color:#036">index.php</tt> (the Theme's home page template file) will be used. 
+
基本の index.php テンプレートファイルを除き、テーマの作成者は、あるテンプレートファイルを実装するか否かを選べます。WordPress が一致する名前のテンプレートファイルを見つけられなければそれを飛ばし、階層の次のファイル名に降ります。WordPress が一致するどのテンプレートファイルも見つけられなければ、index.php(テーマのホームページテンプレートファイル)が使われます。
  
 
=== Examples ===
 
=== Examples ===
  
If your blog is at <tt style="font-weight:bold; color:#036"><nowiki>http://example.com/wp/</nowiki></tt> and a visitor clicks on a link to a category page like
+
ブログが <nowiki>http://example.com/wp/</nowiki> にあり、訪問者が <nowiki>http://example.com/wp/category/your-cat/</nowiki> のようなカテゴリページへのリンクをクリックすると、WordPress は、現在のテーマディレクトリの中から、カテゴリの ID に該当するテンプレートファイルを探します。カテゴリID が 4 であれば、category-4.php というテンプレートファイルを探します。それがなければ、次に、カテゴリの汎用テンプレートファイル category.php を探します。そのファイルも存在しなければ、汎用のアーカイブテンプレート archive.php を探します。それもなければ、最後の手段としてメインのテーマテンプレートファイル index.php に頼ります。
<tt style="font-weight:bold; color:#036; font-size: 0.8em"><nowiki>http://example.com/wp/category/your-cat/</nowiki></tt>, WordPress looks for a template file in the current Theme's directory that matches the category's ID. If the category's ID is 4, WordPress looks for a template file named <tt style="font-weight:bold; color:#036"><nowiki>category-4.php</nowiki></tt>. If it is missing, WordPress next looks for a generic category template file, <tt style="font-weight:bold; color:#036"><nowiki>category.php</nowiki></tt>. If this file does not exist either, WordPress looks for a generic archive template, <tt style="font-weight:bold; color:#036"><nowiki>archive.php</nowiki></tt>. If it is missing as well, WordPress falls back on the main Theme template file, <tt style="font-weight:bold; color:#036"><nowiki>index.php</nowiki></tt>.
+
  
If a visitor goes to your home page at <tt style="font-weight:bold; color:#036"><nowiki>http://example.com/wp/</nowiki></tt>, WordPress looks for a template file called <tt style="font-weight:bold; color:#036">home.php</tt> and uses it to generate the requested page. If <tt style="font-weight:bold; color:#036">home.php</tt> is missing, WordPress looks for a file called <tt style="font-weight:bold; color:#036">index.php</tt> in the active theme's directory, and uses that template to generate the page.
+
訪問者が <nowiki>http://example.com/wp/</nowiki> にあるホームページに来ると、WordPress は home.php というテンプレートファイルを探し、要求されたページを生成するのに使います。home.php がなければ、アクティブなテーマのディレクトリ内の index.php というファイルを探し、このテンプレートをページの生成に使います。
  
 
=== Visual Overview ===
 
=== Visual Overview ===
62行目: 63行目:
 
=== The Template Hierarchy In Detail ===
 
=== The Template Hierarchy In Detail ===
  
The following sections describe the order in which template files are being called by WordPress for each query type.
+
以下の節では、クエリタイプ毎に、WordPress に呼ばれるテンプレートファイルの順序を示します。
  
 
|style="vertical-align:top" |
 
|style="vertical-align:top" |
 
<!-- 4月15日編集前 -->
 
<!-- 4月15日編集前 -->
 
== Introduction ==  
 
== Introduction ==  
Templates are what WordPress uses to format your WordPress site. Since the introduction of [[Using Themes|Themes]] in WordPress v1.5, [[Templates]] have become more and more configurable. You can [[Theme_Development|develop new themes]] with a great amount of customization. If template files are new to you, see [[Stepping Into Templates]]. In order to develop or customize themes, a proper understanding of the way WordPress selects template files for displaying the various pages on your blog is essential.
+
テンプレートは、WordPress サイトの書式(体裁・構成・形式?)を整えるために用いるものです。WordPress v1.5 で [[:ja:Using Themes|「テーマ」]]が導入されて以来、[[テンプレート]]はますます構成しやすくなっています。たくさんのカスタマイズを盛り込んだ[[テーマの作成|新しいテーマを作成]]できます。まだテンプレートファイルについて知らなければ、[[テンプレート入門]]をお読みください。テーマを作成・カスタマイズするためには、ブログの各ページを表示するために WordPress がテンプレートファイルを選び出す仕組みを適切に理解しておくことが不可欠です。
  
This document attempts to answer the following question.
+
このページは、次の問いに答えを出そうとするものです。
 
<blockquote>
 
<blockquote>
''What template file will WordPress use when the _______________ (page) is displayed?''
+
''○○(ページ)を表示するとき、WordPress はどのテンプレートファイルを使う?''
 
</blockquote>
 
</blockquote>
  
78行目: 79行目:
  
 
==The Template Selection Hierarchy==
 
==The Template Selection Hierarchy==
In the sections that follow, the section heading fills in the blank in the question above.  '''WordPress looks in the current theme's directory and uses the ''first'' template file it finds from the list under the appropriate section below'''.  Note the parallels between the Template Hierarchy and the [[Conditional Tags]].
+
以下のセクションでは、それぞれの見出しが上の問いの ○○ に当てはまります。WordPress は現在のテーマディレクトリ内を見て、下記の該当セクションのリストから最初に見つかったテンプレートファイルを使います。テンプレート階層と[[:ja:Conditional Tags|条件タグ]]の類似点に注意。
  
For example, if your blog is at <tt><nowiki>http://example.com/wordpress/</nowiki></tt> and a visitor loads the page <tt><nowiki>http://example.com/wordpress/</nowiki></tt>, WordPress looks for a template file called <tt>home.php</tt> and uses it to generate the requested page. If <tt>home.php</tt> is missing, WordPress looks for a file called <tt>index.php</tt> in the active theme's directory, and uses that template to generate the page. 
+
例えば、ブログが <code><nowiki>http://example.com/wordpress/</nowiki></code> にあって、訪問者が <code><nowiki>http://example.com/wordpress/</nowiki></code> のページを表示しようすると、WordPress は <code>home.php</code> というテンプレートファイルを探し、要求されたページの生成に使います。<code>home.php</code> がないときは、現在のテーマディレクトリから <code>index.php</code> というファイルを探し、このテンプレートをページの生成に使います。
 
|-
 
|-
 
| (以下、階層リスト)
 
| (以下、階層リスト)
 
| (以下、階層リスト)
 
| (以下、階層リスト)
 
|}
 
|}

2008年3月9日 (日) 17:56時点における版

英語版と変えている部分について

  • 一通り和訳したものの、意図が不明瞭な部分や過剰装飾に思える箇所がある。2007年4月15日の編集で大きく変化している。
    • 最新版と以前の版を一通り和訳してみる。
  • en:Creating an Archive Indexarchives.php(デフォルトテーマの「ページテンプレート」)についてのページなので、archive.php に付いているリンクを外す。本家版ではリンクの付け外しが繰り返されているので、ノートで話し合いたいが、英語で提案できない。。orz
  • 例示の domain.com は実在するので example.com に訂正(下表でも)。


最新版 4月編集前

Introduction

WordPress テンプレートは、WordPress サイトのウェブページを生成するために、パズルのピースのように組み合わさります。一部のテンプレート(例えばヘッダやフッタのテンプレートファイル)が全てのウェブページで用いられる一方、特定の条件下でのみ使われるテンプレートファイルもあります。

What this article is about

このページは、次の問いに答えようとするものです。

ある種類のページを表示するとき、WordPress はどのテンプレートファイルを使う?

Who might find this useful

WordPress v1.5 における 「テーマ」の導入以来、テンプレートはますます構造化?設定?しやすくなっています。WordPress テーマを作成するには、ブログの各ページを表示するために WordPress がテンプレートファイルを選び出す仕組みを適切に理解しておくことが不可欠です。既存の WordPress テーマをカスタマイズしようとしているなら、編集すべきテンプレートファイルを判断するのに役立ちます。

Conditional Tags and the Template Hierarchy

(以前の版では "Note the parallels between the Template Hierarchy and the Conditional Tags." の一言だったので、それを膨らませたのかもしれない。)

WordPress がテンプレートと表示を要求されたページ種類(クエリタイプ)とを照合する方法/クエリタイプに合うテンプレートを特定する方法は一つではありません。WordPress テーマの開発者は、あるページの生成に使われるテンプレートを制御するために、条件タグを使うこともできます。以下に説明する全テンプレートファイルを実装してない WordPress テーマがあるかもしれません。他のテンプレートファイルをロードするために条件タグを使うテーマもあります。詳しくはテーマの作成および条件タグのページをご覧ください。

The Template File Hierarchy

The General Idea

WordPress は、ページの表示に使うテンプレート(またはその一組)決めるために、Query String — ウェブサイト上の各リンクに含まれる情報 — を使います。

最初に、WordPress は各 Query String とクエリタイプを照合します。— すなわち、要求されているページの種類(検索結果ページ、カテゴリページ、ホームページなど)を判断します。

テンプレートはそのときに、その WordPress テーマの中に存在するテンプレートファイルに応じて、WordPress テンプレート階層によって示される順に選ばれます。 — そして、ウェブページのコンテンツが生成されます。 —

WordPress は、現在のテーマディレクトリ内に特定の名前のテンプレートファイルがないか探し、下記の該当するクエリセクションに載っているテンプレートファイルから最初に一致したものを使います。

基本の index.php テンプレートファイルを除き、テーマの作成者は、あるテンプレートファイルを実装するか否かを選べます。WordPress が一致する名前のテンプレートファイルを見つけられなければそれを飛ばし、階層の次のファイル名に降ります。WordPress が一致するどのテンプレートファイルも見つけられなければ、index.php(テーマのホームページテンプレートファイル)が使われます。

Examples

ブログが http://example.com/wp/ にあり、訪問者が http://example.com/wp/category/your-cat/ のようなカテゴリページへのリンクをクリックすると、WordPress は、現在のテーマディレクトリの中から、カテゴリの ID に該当するテンプレートファイルを探します。カテゴリID が 4 であれば、category-4.php というテンプレートファイルを探します。それがなければ、次に、カテゴリの汎用テンプレートファイル category.php を探します。そのファイルも存在しなければ、汎用のアーカイブテンプレート archive.php を探します。それもなければ、最後の手段としてメインのテーマテンプレートファイル index.php に頼ります。

訪問者が http://example.com/wp/ にあるホームページに来ると、WordPress は home.php というテンプレートファイルを探し、要求されたページを生成するのに使います。home.php がなければ、アクティブなテーマのディレクトリ内の index.php というファイルを探し、このテンプレートをページの生成に使います。

Visual Overview

(省略)

The Template Hierarchy In Detail

以下の節では、クエリタイプ毎に、WordPress に呼ばれるテンプレートファイルの順序を示します。

Introduction

テンプレートは、WordPress サイトの書式(体裁・構成・形式?)を整えるために用いるものです。WordPress v1.5 で 「テーマ」が導入されて以来、テンプレートはますます構成しやすくなっています。たくさんのカスタマイズを盛り込んだ新しいテーマを作成できます。まだテンプレートファイルについて知らなければ、テンプレート入門をお読みください。テーマを作成・カスタマイズするためには、ブログの各ページを表示するために WordPress がテンプレートファイルを選び出す仕組みを適切に理解しておくことが不可欠です。

このページは、次の問いに答えを出そうとするものです。

○○(ページ)を表示するとき、WordPress はどのテンプレートファイルを使う?

Visual Overview

(省略)

The Template Selection Hierarchy

以下のセクションでは、それぞれの見出しが上の問いの ○○ に当てはまります。WordPress は現在のテーマディレクトリ内を見て、下記の該当セクションのリストから最初に見つかったテンプレートファイルを使います。テンプレート階層と条件タグの類似点に注意。

例えば、ブログが http://example.com/wordpress/ にあって、訪問者が http://example.com/wordpress/ のページを表示しようすると、WordPress は home.php というテンプレートファイルを探し、要求されたページの生成に使います。home.php がないときは、現在のテーマディレクトリから index.php というファイルを探し、このテンプレートをページの生成に使います。

(以下、階層リスト) (以下、階層リスト)