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

2025-10-21 0 308

我们在开发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中定义。

收藏 (0) 打赏

感谢您的支持,我会继续努力的!

打开微信/支付宝扫一扫,即可进行扫码打赏哦,分享从这里开始,精彩与您同在
点赞 (0)

本文版权归趣咪跨境 / 原作者所有,转载需联系客服获授权,标注来源及原文链接;个人学习引用不超 10%,禁止商用。ICP 备案号:粤 ICP 备 2025472990号

技术博客 WordPress主题开发中模版文件名的命名规则汇总 https://www.quminews.com/1295.html

常见问题
  • 是正版授权教程。所售内容为完整原版(含全部视频、课件、素材包),无删减、无盗版水印,可放心购买。
查看详情
  • 下单支付成功后,系统会立即发送「教程获取链接」到你填写的邮箱(5 分钟内到账,若在垃圾邮件箱可手动标记 “非垃圾邮件”);也可在网站「个人中心 - 我的订单」中直接下载,支持电脑 / 手机端操作,下载无次数限制。
查看详情
  • 支付方式:支持微信支付、支付宝、银联卡,付款流程加密,保障资金安全; 发票申请:购买后可在「个人中心 - 发票管理」提交申请,填写企业 / 个人信息(需真实准确),我们会在 1-3 个工作日内开具电子发票并发送到你邮箱,无额外费用。
查看详情
  • 因教程为「数字虚拟产品」,具有可复制性和一旦获取即无法收回的特性,且购买后你可立即下载全部内容,故购买成功后不支持退款。建议你先在课程详情页免费试看前 2 节内容(含讲解风格、操作难度演示),确认符合学习需求后再下单,避免不必要的纠纷。
查看详情

相关文章

发表评论
暂无评论
官方客服团队

为您解决烦忧 - 24小时在线 专业服务