Press "Enter" to skip to content

模版文件

模版文件运用于整个WordPress主题,我们首先来了解一下术语。

模板术语

当WordPress主题工作时,术语“template”正在以不同的方式被使用:

  • 模版文件存在与主题中,表示为你的网站是如何显示的。
  • 页面模版仅用于页面,以改变它们的外观。页面模版可以用于单个的页面,一个页面章节或者一类页面。
  • 模版标签是WordPress函数内置的,你可以在模版文件中用它来检索和显示数据(比如the_title()和the_content())。
  • 模版层级是WordPress用来决定使用哪个主题模版的逻辑,它取决于所请求的内容。

模版文件

WordPress主题由模版文件组成,模版文件是包含了混合Html、模版标签和PHP代码的PHP文件。

在构建主题时,你将会使用模版文件来影响网站不同部分的布局和设计。举例来说,你可以使用header.php模版来创建header,或使用comments.php模版来包含评论。

当有人访问你网站的页面时,WordPress会基于请求加载模版。模版文件显示的内容类型将根据模版文件关联的文章类型来决定。模板层级描述了WordPress会根据请求优先加载哪个模版,不论该模版文件是否存在于主题中。然后,服务器将解析模版中的PHP代码,并将HTML返回给访问者。

最关键的模版文件是index.php,如果在模版层级中无法找到一个具体的模版,那么作为万能模版的它将会被调用。尽管主题只需要一个index.php模版,但是通常主题都会包含大量的模版以显示不同的内容。

模版部分

模版部分是一个模版的一部分,它常作为另一个模版的一部分被包含,比如网站头部(header)。模版部分可以嵌入多个模版中,从而简化主题创建。常见的模版部分包括:

  • header.php用于生成网站头部
  • footer.php用于创建网站底部
  • sidebar.php用于生成侧边栏

尽管以上模版在WordPress中是特例,并且仅适用于页面的一部分,但是你还可以创建任意数量的模版文件,将他们包含在其他模版文件中。

常见的WordPress模板文件

以下是WordPress公认的一些基本主题模板和文件的列表。

index.php

主模版文件,在所有主题中都是必需的。

style.css

主样式文件,在所有主题中都是必需的,并且需要包含主题的信息头。

rtl.css

如果网站的语言文字方向是从右到左,那么从右到左(right-to-left)样式文件将会自动被包含。

comments.php

评论模版

front-page.php

首页(front page)模版如果存在,通常被用作网站首页 ,而不管在管理->设置->阅读中是什么设置 。

home.php

主页模版默认为网站首页。如果你没有设置WordPress使用一个静态首页(front page),则此模版用于显示最新文章。

header.php

头部模版文件通常包含网站的文档类型,meta信息,样式和脚本链接和其他数据。

singular.php

当single.php未找到时,单个模版(singular )用于文章显示;当page.php文件未找到时,它将用于页面显示。如果单个模版文件未找到,那么index.php将会被使用。

single.php

当访客请求单篇文章时,将使用单篇文章模板。

single-{post-type}.php

当访客试图访问自定义文章类型的单篇文章时,此单篇文章模版将会被使用。举个例子来说,single-book.php将会用来显示文章类型为book的单篇文章。如果当前自定义文章类型的指定查询模版不存在,则会使用index.php。

archive-{post-type}.php

当访客请求一个自定义文章类型归档(archive)时,将使用归档文章类型模版。比如,archive-books.php将会用来显示名为books的自定义文章类型的文章归档。当前不存在archive-{post-type}.php文件时,archive.php模版文件将会被使用。

page.php

当访问者请求单个页面时,将使用页面模板 (内置模板) 。

page-{slug}.php

访问者请求特定页面(例如访问别名为“about”的页面(page-about.php))时,将使用此页面块模板。

category.php

当访客按分类请求文章时,将使用分类模板。

tag.php

当访客按标签请求文章时,将使用标签模板。

taxonomy.php

当访客请求自定义分类中的分类时,将使用taxonomy分类模板。

author.php

每当访客访问作者页面时,都会使用作者页面模板。

date.php

当以日期或时间请求文章时,日期/时间模版将会被使用。例如,通过如下别名创建页面:

http://example.com/blog/2014/

http://example.com/blog/2014/05/

http://example.com/blog/2014/05/26/

archive.php

当访客按分类、作者或者日期请求文章时,归档模版文件将会使用。注意:如果存在具体的模版,像category.php、author.php以及date.php,此模版将会被覆盖。

search.php

搜索结果模版将会在访客搜索结果时使用。

attachment.php

查看单个附件比如图片、pdf或者其他媒体文件时,附件模版将会启用。

image.php

图像附件模版是一个attachment.php的特定版本,它会被用在查看单个图片附件时。如果不存在,那么WordPress将会使用attachment.php代替。

404.php

当WordPress无法找到符合访问者要求的文章、页面或其他内容时,将使用404模板。

使用模版文件

在WordPress模板中,你可以使用模板标签动态显示信息,包含其他模板文件,甚至是自定义网站。

例如,在index.php中你可以在最终生成的页面中包含其他文件:

这是一个WordPress模板标签示例,可将特定模板包含到您的页面中:

<?php get_sidebar(); ?>
<?php get_template_part( 'featured-content' ); ?>
<?php get_footer(); ?>

你可以在“模板标签”页面中,找到更多相关信息。

参照链接主题文件和目录章节获取更多关于链接组件模版的信息。

Comments are closed, but trackbacks and pingbacks are open.