模板文件

模板术语

在使用WordPress主题时，术语“模板”以不同的方式使用：

• 模板文件存在于主题中，并表示您的网站的显示方式。
• 页面模板是那些仅适用于页面以改变其外观和感觉的页面模板。页面模板可以应用于单个页面，页面部分或一组页面。
• 模板标签是内置的WordPress函数，您可以在模板文件中使用它来检索和显示数据（如 the_title() 和 the_content() ）。
• 模板层次结构是WordPress用来决定使用哪个主题模板文件的逻辑，具体取决于请求的内容。

模板文件

WordPress主题由模板文件组成。这些PHP文件包含HTML，模板标签和PHP代码的混合。

当您构建主题时，您将使用模板文件来影响网站不同部分的布局和设计。例如，您可以使用 header.php 模板创建页眉，或使用 comments.php 模板来包含评论。

当某人访问您网站上的某个页面时，WordPress将根据请求加载一个模板。模板文件显示的内容类型由与模板文件关联的文章类型决定。模板层次结构根据请求的类型以及模板是否存在于主题中告诉WordPress将加载哪个模板文件。然后服务器解析模板中的PHP并将HTML返回给访问者。

最重要的模板文件是 index.php，如果在模板层次结构中找不到更具体的模板，则所有的页面都将调用该模板。虽然主题只需要一个index.php模板，但主题通常包含大量模板以显示不同的内容类型和上下文。

局部模板

局部模板是作为另一个模板（如网站页眉）包含的一部分模板。局部模板可以嵌入到多个模板中，简化主题创建。常见的模板部分包括：

• header.php用于生成页眉
• footer.php用于生成页脚
• sidebar.php生成边栏

尽管上述模板文件在WordPress中是特殊情况，并且仅适用于页面的一部分，但您可以创建任意数量的模板部分并将其包含在其他模板文件中。

常见的WordPress模板文件

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

index.php

主要的模板文件。它在所有主题中都是必需的。

style.css

主样式表。它在所有主题中都是必需的，并且包含主题的信息页眉。

rtl.css

如果网站语言的文本方向是从右到左，则会自动包含从右到左的样式表。

comments.php

评论模板。

front-page.php

如果该模板存在，则无论 管理 > 设置 > 阅读 中的设置如何，始终将首页模板用作网站首页。

home.php

该模板是默认的首页模板。如果您没有将WordPress设置为使用静态首页，则此模板用于显示最新文章。

header.php

页眉模板文件通常包含您网站的文档类型，元信息，样式表和脚本的链接以及其他数据。

singular.php

单数模板用于未找到 single.php 的时候，或未找到 page.php 时用于页面。如果没有找到 singular.php，则使用 index.php。

single.php

单个文章模板，用于访问者请求单个文章时使用。

single-{post-type}.php

访问者从自定义文章类型请求单个帖子时使用的单帖子模板。例如，single-book.php 将用于显示自定义文章类型为 book 的单个帖子。如果自定义文章类型的特定查询模板不存在，则使用 index.php。

archive-{post-type}.php

访问者查询自定义文章类型归档时使用存档文章类型模板。例如，archive-books.php 将用于显示来自自定义文章类型为 book 的文章的归档。如果 archive-{post-type}.php 不存在，则使用 archive.php 模板文件。

page.php

访问者查询单个页面时使用页面模板，页面是内置模板。

page-{slug}.php

当访问者查询使用特定slug的页面时使用的模板，例如使用“about”slug（page-about.php）。

category.php

访问者按分类目录查询文章时使用的类别模板。

tag.php

当访问者通过标签查询文章时使用标签模板。

taxonomy.php

当访问者查询自定义分类法时，使用分类法模板。

author.php

只要访问者加载作者页面，就会使用作者页面模板。

date.php

日期/时间模板用于按日期或时间查询文章。例如，用这些slug生成的页面：

• 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 中，您可以在最终生成的页面中包含其他文件：

• 要包含页眉，请使用 get_header()
• 要包含边栏，请使用 get_sidebar()
• 要包含页脚，请使用 get_footer()
• 要包含搜索表单，请使用 get_search_form()
• 要包含自定义主题文件，请使用 get_template_part()

这里是一个WordPress模板标签的例子，在您的页面中包含特定的模板：

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

结语

以上内容来自翻译Wordpress官方文档，希望对大家有帮助，也多多支持一下阿Q的项目开发的QQWorld主题制造。