我们在开发WordPress主题的时候,肯定需要遵循主题开发的规则,尤其是页面名称的定义。有很多时候我们需要自定义分类、页面等,则也需要了解实际的规范。在这里,我们将WordPress主题开发的时候需要定义的页面名称一一整理,有助于开发主题的时候使用。
以下是WordPress主题中常用的几个页面名称及其说明:
1. 首页(Home)
- 文件名:
home.php
或index.php
- 说明: 首页是网站的入口页面,通常展示最新的文章、精选内容或特定的首页布局。WordPress会优先查找
home.php
文件来显示首页,如果没有找到,则使用index.php
。
2. 单篇文章页面(Single Post)
- 文件名:
single.php
- 说明: 用于显示单篇博客文章的内容。如果你的主题支持自定义文章类型,还可以有对应的
single-{post_type}.php
文件,例如single-product.php
用于显示产品类型的单篇文章。
3. 文章归档页面(Archive)
- 文件名:
archive.php
- 说明: 用于显示分类、标签、作者、日期等归档内容的页面。根据不同的归档类型,WordPress会加载相应的模板文件,如
category.php
、tag.php
、author.php
等。
4. 分类归档页面(Category Archive)
- 文件名:
category.php
- 说明: 专门用于显示某个分类下的文章列表。你可以为特定分类创建
category-{slug}.php
或category-{ID}.php
来定制该分类的显示方式。
5. 标签归档页面(Tag Archive)
- 文件名:
tag.php
- 说明: 用于显示某个标签下的文章列表。类似于分类归档页面,你可以为特定标签创建
tag-{slug}.php
或tag-{ID}.php
进行定制。
6. 作者归档页面(Author Archive)
- 文件名:
author.php
- 说明: 显示某个作者发布的所有文章。可以创建
author-{nicename}.php
、author-{ID}.php
等文件来定制特定作者的显示方式。
7. 日期归档页面(Date Archive)
- 文件名:
date.php
- 说明: 用于显示特定日期发布的文章,如年、月、日归档。
8. 搜索结果页面(Search Results)
- 文件名:
search.php
- 说明: 显示用户搜索关键词后的结果页面。你可以自定义搜索结果的展示方式。
9. 404 页面(Page Not Found)
- 文件名:
404.php
- 说明: 当用户访问不存在的页面时显示的错误页面。设计一个友好的404页面可以提升用户体验。
10. 页面模板(Page Templates)
除了上述动态页面,WordPress主题还可以包含多个静态页面模板,用于不同的页面布局和设计。常用的静态页面模板包括:
- 默认页面模板
- 文件名:
page.php
- 说明: 默认的静态页面显示模板。
- 文件名:
- 首页模板(Front Page)
- 文件名:
front-page.php
- 说明: 当设置“您的最新文章”或“静态首页”为首页时使用的模板。优先级高于
home.php
。
- 文件名:
- 自定义页面模板
- 文件名示例:
template-full-width.php
,template-sidebar-left.php
- 说明: 通过创建自定义页面模板,可以为特定页面设计独特的布局,如全宽页面、左侧边栏页面等。自定义模板需要在文件顶部添加模板名称注释,例如:
- 文件名示例:
/* Template Name: 全宽页面 */
11. 附件页面(Attachment Page)
- 文件名:
attachment.php
- 说明: 用于显示单个附件(如图片、视频、文档等)的页面。可以进一步定制特定类型的附件显示,例如
image.php
用于图片附件。
12. 403 页面(Forbidden)
- 文件名:
403.php
- 说明: 当用户没有权限访问某个页面时显示的页面。设计友好的403页面可以提升用户体验。
13. 重定向页面(Redirection)
- 文件名: 通常通过插件或主题功能实现,无需特定模板文件。
- 说明: 用于将用户重定向到其他页面,常见于维护模式或临时跳转。
14. 自定义文章类型归档页面
- 文件名:
archive-{post_type}.php
- 说明: 用于显示自定义文章类型的归档页面。例如,如果你的自定义文章类型是
portfolio
,则可以使用archive-portfolio.php
来定制其归档页面的显示方式。
15. 自定义分类法页面
- 文件名示例:
taxonomy-{taxonomy}-{term}.php
,taxonomy-{taxonomy}.php
- 说明: 用于显示自定义分类法的归档页面。例如,如果你有一个自定义分类法
genre
和一个分类项action
,则可以使用taxonomy-genre-action.php
来定制该分类项的显示方式。
常见文件加载顺序
WordPress根据模板层次结构来决定使用哪个模板文件显示特定页面。以下是常见的模板加载顺序(从高到低优先级):
- 自定义模板页面:
page-{slug}.php
,page-{ID}.php
- 特定页面模板: 如
front-page.php
(静态首页)、home.php
(动态首页) - 单篇文章:
single-{post_type}-{slug}.php
,single-{post_type}.php
,single.php
- 归档页面:
archive-{post_type}.php
,archive.php
- 分类:
category-{slug}.php
,category-{ID}.php
,category.php
- 标签:
tag-{slug}.php
,tag-{ID}.php
,tag.php
- 作者:
author-{nicename}.php
,author-{ID}.php
,author.php
- 日期:
date.php
- 搜索结果:
search.php
- 404 页面:
404.php
未经允许不得转载:老蒋玩运营 » WordPress主题开发必备的页面命名规则