编辑“WordPress:Template Hierarchy”

<div style="border: 1px solid #036; background:#eee; text-align:center; margin:5px; padding:10px">'''注意:'''  本文关于一个高级话题。参见[[WordPress:Stepping Into Templates|走进模板]]作为接触WordPress模板的介绍.</div>

== 介绍 ==

WordPress模板结合在一起，就象一个难题的各个部分一样，生成了你的WordPress站点上的网页。一些模板(例如页眉和页脚模板文件)可以用在所有的网页上，而另外一些只能在特殊情况下使用。
=== 本文是关于什么的 ===
本文致力于寻找下面问题的答案：
<blockquote>
''当WordPress显示特定的页面类型时，会使用哪种模板文件呢？''
</blockquote>
=== 本文适用对象 ===
由于WordPress v1.5 中对[[WordPress:Using Themes|主题]]的介绍，[[WordPress:Templates|模板]]已经越来越可以自由配置使用了。为了[[WordPress:Theme_Development|开发]] WP主题，要正确的理解WordPress选择模板文件在blog上显示多种页面的方式。如果你想要自定义一个已存在的WordPress主题，本文将帮助你确定哪个模板文件需要编辑。

{| cellspacing="3"
|- valign="top"
|class="MainPageKnowledgeBaseBox" style="border: 1px solid #ffc9c9; padding: 1em; color: #000000; background-color: #fff3f3"|
=== 条件式标签和模板层次 ===

WordPress提供了很多方法来配合模板查询类型。WordPress主题开发人员还使用:Theme_Development#Query-based_Templates|条件式标签]]来控制生成一个特定的页面时使用哪个模板。一些WordPress主题可能不能贯彻所有这里说到的模板文件。一些主题使用条件式标签来载入其他的模板文件。参见[[WordPress:Theme Development#Query-based Templates|主题开发]]和[[WordPress:Conditional Tags|条件式标签]]
|}

== 模板文件层次 ==


=== 概述 ===

WordPress使用[[WordPress:Glossary#Query_string|字符串查询]] &mdash;站点上每个连接包含的信息&mdash;来决定使用哪个模板或者模板组合来显示页面。

首先，WordPress把每个字符串查询与类型查询匹配&mdash; i.e.决定哪种类型的页面(搜索页面,分类页面,主页等等.)是所需要的。

然后选定模板&mdash;生成网页页面内容&mdash; 据在某个WordPress主题中哪些模板可用，按照WordPress模板层次的建议排序。

WordPress在现用的主题目录中通过特定的名字寻找模板文件，使用下边列在合适的查询结果中的''第一匹配''的模板文件。

除了基本的<tt style="font-weight:bold; color:#036"><nowiki>index.php</nowiki></tt>模板文件以外，主题开发人员可以选择是否使用某个特定的模板文件。如果WordPress不能使用匹配名字找到相应的模板，它会跳到这个层次中的下一个文件名。如果WordPress不能找到所有的匹配模板文件，<tt style="font-weight:bold; color:#036">index.php</tt>(主题主页模板文件)将被使用。

=== 示例 ===

如果你的blog在<tt style="font-weight:bold; color:#036"><nowiki>http://domain.com/wp/</nowiki></tt>，并且访问者点击了一个分类页面连接如<tt style="font-weight:bold; color:#036; font-size: 0.8em"><nowiki>http://domain.com/wp/category/your-cat/</nowiki></tt>，WordPress会在现有的主题目录中寻找匹配的分类ID。如果这个分类ID是4，WordPress会去寻找一个名字为<tt style="font-weight:bold; color:#036"><nowiki>category-4.php</nowiki></tt>的模板文件。如果没有找到，WordPress就会去寻找普通分类模板文件，<tt style="font-weight:bold; color:#036"><nowiki>category.php</nowiki></tt>。如果这个文件也不存在，WordPress就会寻找普通文档模板，<tt style="font-weight:bold; color:#036"><nowiki>archive.php</nowiki></tt>。如果还是没有找到，WordPress就会返回到主页模板文件，<tt style="font-weight:bold; color:#036"><nowiki>index.php</nowiki></tt>.


如果访问者到了你位于<tt style="font-weight:bold; color:#036"><nowiki>http://domain.com/wp/</nowiki></tt>的主页，WordPress就会寻找一个叫做<tt style="font-weight:bold; color:#036">home.php</tt>的模板文件，并且使用它生成请求的页面。如果没有找到<tt style="font-weight:bold; color:#036">home.php</tt>，WordPress就会在主题目录中寻找一个叫做<tt style="font-weight:bold; color:#036">index.php</tt>的文件，使用这个模板来生成页面。

=== 视觉总览 ===

以下代码显示出哪个模板文件被用来生成一个基于WordPress模板层次的WordPress页面了。它还描述了[[WordPress:Glossary#Query_string|字符串查询]]和相应的[[WordPress:Conditional Tags|条件式标签]]的关系

[[WordPress:Image:templatehierarchyexample.png|| WordPress模板层次结构图例]]

<!-- Codex image page: http://codex.wordpress.org/Image:wp_Template_Hierarchy.png -->
<small>[http://codex.wordpress.org/images/1/1d/wp_Template_Hierarchy.png Full-Size Image (png)]</small>

<small>[http://www.scoutpress.de/download/wp_Template_Hierarchy.zargo Download ArgoUML-0.22-File (zargo)] (external link)</small>

=== 模板层次详解 ===

以下部分描述了在模板文件中WordPress调用的每个查询类型的顺序。



=== 主页 ===

:#home.php
:#index.php

=== 单个文章页面 ===

:#single.php
:#index.php

=== WordPress 页面 ===

:#编辑[[WordPress:Pages|页面]]的时候，从"页面模板"下拉菜单中选择模板.
:#[[WordPress:Pages|page.php]]
:#index.php

<div style="border: 1px solid #ffc9c9; padding: 1em; color: #000000; background-color: #fff3f3">'''注意:''' 这里指的是''WordPress 页面'', 不是blog中的一般文章或者网页。参见 [[WordPress:Pages|WordPress 页面]].
</div>
=== 分类页面 ===

:#分类模板有一个匹配ID. 如果分类的ID是<tt style="font-weight:bold; color:#036">6</tt>, WordPress 就会寻找[[WordPress:Category Templates|category-6.php]]
:#[[WordPress:Category Templates|category.php]]
:#[[WordPress:Creating_an_Archive_Index|archive.php]]
:#index.php

<div style="border: 1px solid #ffc9c9; padding: 1em; color: #000000; background-color: #fff3f3">'''Note:''' See [[WordPress:Category Templates]] for details.</div>

=== 标签页面 ===

:#标签模板有一个匹配插槽.如果标签插槽是<tt style="font-weight:bold; color:#036">sometag</tt>, WordPress就会搜索 [[WordPress:Tag Templates|tag-sometag.php]]
:#[[WordPress:Tag Templates|tag.php]]
:#[[WordPress:Creating_an_Archive_Index|archive.php]]
:#index.php

<div style="border: 1px solid #ffc9c9; padding: 1em; color: #000000; background-color: #fff3f3">'''Note:''' See [[WordPress:Tag Templates]] for details.</div>

=== 作者页面 ===

:#[[WordPress:Author Templates|author.php]]
:#[[WordPress:Creating_an_Archive_Index|archive.php]]
:#index.php

<div style="border: 1px solid #ffc9c9; padding: 1em; color: #000000; background-color: #fff3f3">'''注意:'''[[WordPress:Author Templates|作者模板]] 可以用来显示有关作者的信息.</div>

=== 日期页面 ===

举个例子，一个按月的文档页面。

:#date.php
:#[[WordPress:Creating_an_Archive_Index|archive.php]]
:#index.php

=== 搜索结果页面 ===

:#[[WordPress:Creating_a_Search_Page|search.php]]
:#index.php

=== 404 (找不到) 页面 ===

:#[[WordPress:Creating_an_Error_404_Page|404.php]]
:#index.php

<div style="border: 1px solid #ffc9c9; padding: 1em; color: #000000; background-color: #fff3f3">'''注意:''' 参见[[WordPress:Creating an Error 404 Page|建立一个错误404页面]]以获得更多有关404页面的信息。</div>

=== 附件页面 ===

:#attachment.php
:#index.php

<div style="border: 1px solid #ffc9c9; padding: 1em; color: #000000; background-color: #fff3f3">'''注意:''' 参见[[WordPress:Using Image and File Attachments#Inserting_Files|图片附件]]获得更多有关此模板的信息.</div>

== 参见 ==

以下连接与文章话题直接相关.

[[WordPress:Theme Development|主题开发]] | [[WordPress:The Loop|循环]] | [[WordPress:Conditional Tags|条件式标签]] | [[WordPress:Template Tags|模板标签]] | [[WordPress:Using Permalinks|使用Permalinks]]