WordPress主题开发中模版文件名的命名规则汇总

我们在开发WordPress主题的时候，主题文件名的命名规则需要规范，这样才能会被默认自动识别，否则你全部自定义肯定不利于二次开发，或者后续的修改。在这里，我们整理一些常见的WordPress主题文件名的命名以及优先级。

主页模板

home.php
index.php

如果设置中将首页显示设置为”您的最新文章”，那么主页优先加载home.php，如果home.php不存在，则加载index.php。如果front-page.php文件存在，会最先加载front-page.php。

首页模板

front-page.php
home.php
page.php
index.php

如果阅读设置中将首页显示设置为”一个静态页面”，那么加载顺序如上列表，这里需要注意page.php的加载优先级高于index.php，因为”一个静态页面”指定的就是一个Page页面。

文章页面模板

single-{post-type}-{slug}.php：这里{post-type}是指文章类型，{slug}是指文章的别名。WordPress常用的两种Post Type：Post（文章）、Page（页面），你也可以自定义文章类型，不过自定义文章类型用得比较少，可能是太过于复杂，如无特殊需求一般不建议使用。示例：single-post-wordpress-template-hierarchy.php，其中wordpress-template-hierarchy是我当前文章的别名；
single-{post-type}.php：这里{post-type}是指文章类型；
single.php
singular.php
index.php

Page页面

自定义页面模板；
page-{slug}.php：这里{slug}是指页面的别名。示例：page-about.php；
page-{id}.php：这里{id}是指页面的ID。示例：page-2.php；；
page.php
singular.php
index.php

分类页面

category-{slug}.php：这里{slug}是指分类的别名。示例：category-resources.php；
category-{id}.php：这里{id}是指分类的ID。示例：category-3.php；
category.php
archive.php
index.php

标签页面

tag-{slug}.php：这里{slug}是指标签的别名。示例：tag-wordpress-template-tags.php；
tag-{id}.php：这里{id}是指标签的ID。示例：tag-28.php；
tag.php
archive.php
index.php

自定义分类法

做企业网站的时候会经常用到，比如将产品分类独立分类。

taxonomy-{taxonomy}-{term}.php：这里{taxonomy}为自定义分类法名称，{term}为分类别名。示例：taxonomy-product-books.php
taxonomy-{taxonomy}.php：这里{taxonomy}为自定义分类法名称。示例：taxonomy-product.php
taxonomy.php
archive.php

自定义文章类型

archive-{post_type}.php：这里{post_type}是指自定义文章类型的名称。示例：archive-product.php
archive.php

作者页面

author-{nicename}.php：这里{nicename}是指作者的昵称；
author-{id}.php：这里{id}是指作者的ID；
author.php

日期归档页面

date.php

搜索结果页

search.php

404页面

404.php

附件页面

MIME_type.php：用MIME类型作为文件名称，例如：image.php, video.php
attachment.php
single-attachment.php

嵌入型模板

embed-{post-type}-{post_format}.php
embed-{post-type}.php
embed.php

嵌入型模板可以用get_template_part()函数来加载，例如：

get_template_part( 'embed', 'content' );

一般我们在开发主题的时候尽量的根据规范设置名称。有一些特别的模版，我们也可以用定义函数的方式来优先。比如前面的搜索结果页面，我们可以在 Functions.php中定义。

未经允许不得转载：老蒋玩运营 » WordPress主题开发中模版文件名的命名规则汇总