模板文件
WordPress主题由模板文件组成。它们是一些PHP文件,包含HTML、模板标签和PHP代码。
构建主题时,将使用模板文件来影响网站不同部分的布局和设计。例如,您将使用header.php
模板创建页眉,或使用comments.php
模板引入评论。
当有人访问您网站上的页面时,WordPress会根据请求来加载模板。模板文件显示的内容类型由模板文件关联的文章类型确定。模板层次描述了WordPress 将根据请求的类型加载哪个模板文件,以及模板是否存在于主题中。 然后,服务器解析模板中的PHP,并将HTML返回给访问者。
最关键的模板文件是index.php
,如果在模板层次结构中找不到更具体的模板,那么所有请求最终都会被发送到这个模板上 。尽管主题仅需要一个 index.php
模板,但通常主题包含许多模板,以便在不同的上下文中环境中显示不同的内容 。
模板片段
模板片段是用来包含在其他模版中的一种模板。模板片段可以嵌入多个模板中,从而简化主题创建。常见的模板部分包括:
header.php
用于生成网站的页眉footer.php
用于生成页脚sidebar.php
用于生成侧边栏
尽管以上模板文件仅适用于页面的一部分,但是您可以创建任意数量的模板片段,并将其包括在其他模板文件中。
以下是WordPress可以识别的一些主题模板和文件列表。
- index.php:主模板文件,所有主题都需要这个文件。
- style.css:主样式文件,包含主题的信息,所有主题都需要这个文件。
- rtl.css:从右向左阅读的样式文件,如果站点语言是从右向左阅读的,主题会自动包含此文件。
- comments.php:主题评论模板文件。
- front-page.php:首页模板文件,无论阅读设置中的首页设置为什么总是,优先选择此文件模板作为首页模板文件。
- home.php:如果阅读设置中设置为静态页面,选择此文件作为首页模板文件。
- header.php:网站页头模板文件,通常包含您网站的文档类型、元信息、样式表、脚本链接以及其他数据。
- singular.php:单页面模板,未找到 single.php 或 page.php 时,使用此文件作为这些文章类型的单页面模板文件。
- single.php:「文章」的详情页模板文件。
- single-{post-type}.php:「post-type」文章类型的详情页模板文件。
- archive-{post-type}.php:「post-type」文章类型的存档页模板文件。
- page.php:「页面」文章类型的详情页模板文件。
- page-{slug}.php:别名为「slug」的页面详情页模板文件。
- category.php:分类目录存档模板文件。
- tag.php:标签存档模板文件。
- taxonomy.php:自定义分类法存档模板文件。
- author.php:作者存档页模板文件。
- date.php:日期存档页模板文件。
- archive.php:默认存档页默模板文件。
- search.php:搜索结果页模板文件。
- attachment.php:单个附件页面模板文件。
- image.php:图像页面模板文件。
- 404.php:页面找不到时,显示的 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(); ?>