微信关注,获取新知

WordPress主题开发必备的页面命名规则

我们在开发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.phptag.phpauthor.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}.phpauthor-{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.phptemplate-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}.phptaxonomy-{taxonomy}.php
  • 说明: 用于显示自定义分类法的归档页面。例如,如果你有一个自定义分类法 genre 和一个分类项 action,则可以使用 taxonomy-genre-action.php 来定制该分类项的显示方式。

常见文件加载顺序

WordPress根据模板层次结构来决定使用哪个模板文件显示特定页面。以下是常见的模板加载顺序(从高到低优先级):

  1. 自定义模板页面page-{slug}.phppage-{ID}.php
  2. 特定页面模板: 如 front-page.php(静态首页)、home.php(动态首页)
  3. 单篇文章single-{post_type}-{slug}.phpsingle-{post_type}.phpsingle.php
  4. 归档页面archive-{post_type}.phparchive.php
  5. 分类category-{slug}.phpcategory-{ID}.phpcategory.php
  6. 标签tag-{slug}.phptag-{ID}.phptag.php
  7. 作者author-{nicename}.phpauthor-{ID}.phpauthor.php
  8. 日期date.php
  9. 搜索结果search.php
  10. 404 页面404.php
投上你的一票

未经允许不得转载:老蒋玩运营 » WordPress主题开发必备的页面命名规则