模板文件

模板文件

模板 是一些 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.phpauthor.phpdate.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文件存在于当前主题中,该文件模板就将起作用。

上一页
下一页