模板文件
模板文件
模板 是一些 PHP 文件,他可以输出 HTML 代码呈献给浏览器,决定着主题的外观.下面让我们来看一下主题的模板.
WordPress 允许为你的网站定义不同的模板.他虽然不是必需的,但是这些不同的模板为你的网站添上一笔. 模板是根据Template Hierarchy的,由一个具体的主题决定.
作为一个主题开发者,你可以自由决定如何定制你的模板.比如说,极端情况下, 你甚至可以仅仅使用一个文件index.php
作为模板文件,所有 页面都会使用这个模板.更多的情况是,使用不同的模板文件产生不同的结果,以达到最大定制.
模板文件列表
这里是被 WordPress 确认的主题文件列表.当然,你的主题可以包含任何样式表,图像或者文件.记住下面列出的文件对 WordPress 有特殊的意义.
-
style.css
: 主样式表,这个文件 必须 位于你的主题里面,而且必须在头部注释处写清楚你的主题的信息. -
rtl.css
: rtl 样式表。如果网站的阅读方向是自右向左的,他会自动被包含进来。你可以使用 the RTLer 插件来生成这个文件. -
index.php
: 主模板.如果你的主题使用自己的模板,index.php
是必须要有的. -
comments.php
: 评论模板. -
front-page.php
: 首页模板,仅用于开启 静态首页 时。 -
home.php
: 主页模板,默认的首页。如果你开启了 静态首页 这是展现最新的文章的模板页面。 -
single.php
: 单独页面模板。显示单独的一篇文章时被调用。对于这个以及其他的请求模板,如果模板不存在会使用index.php
。 -
single-{post-type}.php
: 自定义单独页面模板。例如,single-books.php
展示自定义文章类型为books
的文章. 如果文章类型未被设置则使用index.php
。 -
page.php
: 页面模板. 独立页面调用。 -
category.php
: 分类模板。分类页面调用。 -
tag.php
: 标签模板。标签页面调用。 -
taxonomy.php
: 术语模板。请求自定义分类法的术语时使用。 -
author.php
: 作者模板。作者页面调用。 -
date.php
: 日期/时间模板,按时间查询时使用的模板。 -
archive.php
: 存档模板。查询分类,作者或日期时使用的模板。需要注意的是,该模板将会分别被category.php
,author.php
,date.php
所覆盖(如果存在的话)。 -
search.php
: 搜索结果模板,显示搜索结果时使用的模板。 -
attachment.php
: 附件模板,查看单个附件时使用的模板。 -
image.php
: 图片附件模板。当在 wordpress 中查看单个图片时将调用此模板,如果不存在此模板,则调用 attachment.php 模板。 -
404.php
: 404 错误页面 模板。当 WordPress 无法查找到匹配查询的日志或页面时,使用 404.php 文件。
按照Template Hierarchy,这些文件在 WordPress 中有特殊的意义,即当对应的 条件标签 返回 true 的时候,他们将在这种情况下代替index.php
,例如,如果当前显示的是单一的一篇博文,那么is_single()
这个函数将返回’true’,并且如果有一个single.php
文件存在于当前主题中,该文件模板就将起作用。