WordPress:Template Hierarchy

注意: 本文关于一个高级话题。参见走进模板作为接触WordPress模板的介绍.

介绍

WordPress模板结合在一起，就象一个难题的各个部分一样，生成了你的WordPress站点上的网页。一些模板(例如页眉和页脚模板文件)可以用在所有的网页上，而另外一些只能在特殊情况下使用。

本文是关于什么的

本文致力于寻找下面问题的答案：

当WordPress显示特定的页面类型时，会使用哪种模板文件呢？

本文适用对象

由于WordPress v1.5 中对主题的介绍，模板已经越来越可以自由配置使用了。为了开发 WP主题，要正确的理解WordPress选择模板文件在blog上显示多种页面的方式。如果你想要自定义一个已存在的WordPress主题，本文将帮助你确定哪个模板文件需要编辑。

条件式标签和模板层次

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

模板文件层次

概述

WordPress使用字符串查询 —站点上每个连接包含的信息—来决定使用哪个模板或者模板组合来显示页面。

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

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

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

除了基本的index.php模板文件以外，主题开发人员可以选择是否使用某个特定的模板文件。如果WordPress不能使用匹配名字找到相应的模板，它会跳到这个层次中的下一个文件名。如果WordPress不能找到所有的匹配模板文件，index.php(主题主页模板文件)将被使用。

示例

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

如果访问者到了你位于http://domain.com/wp/的主页，WordPress就会寻找一个叫做home.php的模板文件，并且使用它生成请求的页面。如果没有找到home.php，WordPress就会在主题目录中寻找一个叫做index.php的文件，使用这个模板来生成页面。

视觉总览

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

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

Full-Size Image (png)

Download ArgoUML-0.22-File (zargo) (external link)

模板层次详解

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

主页

:#home.php
:#index.php

单个文章页面

:#single.php
:#index.php

WordPress 页面

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

注意: 这里指的是WordPress 页面, 不是blog中的一般文章或者网页。参见 WordPress 页面.

分类页面

:#分类模板有一个匹配ID. 如果分类的ID是6, WordPress 就会寻找category-6.php
:#category.php
:#archive.php
:#index.php

Note: See WordPress:Category Templates for details.

标签页面

:#标签模板有一个匹配插槽.如果标签插槽是sometag, WordPress就会搜索 tag-sometag.php
:#tag.php
:#archive.php
:#index.php

Note: See WordPress:Tag Templates for details.

作者页面

:#author.php
:#archive.php
:#index.php

注意:作者模板可以用来显示有关作者的信息.

日期页面

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

:#date.php
:#archive.php
:#index.php

搜索结果页面

:#search.php
:#index.php

404 (找不到) 页面

:#404.php
:#index.php

注意: 参见建立一个错误404页面以获得更多有关404页面的信息。

附件页面

:#attachment.php
:#index.php

注意: 参见图片附件获得更多有关此模板的信息.

参见

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

主题开发 | 循环 | 条件式标签 | 模板标签 | 使用Permalinks