WordPress模板主体文件构成

本文介绍了WordPress主题的文件结构和层次关系。主题由PHP文件构成,WordPress根据页面类型按特定顺序查找模板文件,例如主页优先使用home.php,其次index.php。文章详细列出了各类页面对应的模板文件查找顺序,包括文章页、分类页、标签页等,帮助开发者了解主题文件的作用和编写要求,为制作WordPress主题奠定基础。

文章作者:曾凤祥
阅读时间: 10 分钟
更新时间:2025年11月13日

在开始制作WordPress主题之前,首先得了解WordPress主题到底由哪些文件构成,你得清楚WordPress程序是怎样与主题文件连接的。

以下是WordPress默认主题default文件夹下的所有模板文件。看了下图,可能你还摸不着头脑,到底这些文件是干什么的。WordPress的主题是用PHP编写的,而不是纯HTML + CSS,所以模板文件的后缀名是.php,如果你想精通WordPress的主题制作,完美控制你的博客,最好要熟悉PHP编程。要是不会PHP编程怎么办?就做不了WordPress主题了吗?那也不是,至少看完本系列教程,你也能够掌握基本的WordPress主题制作方法。

下面是WordPress主题文件层次结构,它会告诉你:当WordPress显示特定的页面类型时,会使用哪个模板文件呢?只有了解了以下主题层次结构,你才能知道你的WordPress主题到底需要写哪些文件。

怎么看下面的文件层次结构?

以主页为例,下面有2个文件home.php和index.php,WordPress程序会从你的主题文件夹中依次查找这两个文件:

  • 如果找到home.php,则使用home.php作为博客首页模板,即使你的主题文件夹中有index.php;
  • 如果home.php未找到,则使用index.php作为首页模板;
  • 如果home.php和index.php都找不到,你的主题将不会被WordPress识别,等于废物。

主页

  1. home.php
  2. index.php

文章页

  1. single-{post_type}.php –如果文章类型是videos(即视频),WordPress就会去查找
  2. single-videos.php(WordPress 3.0及以上版本支持)
  3. single.php
  4. index.php

页面

  1. 自定义模板 – 在WordPress后台创建页面的地方,右侧边栏可以选择页面的自定义模板
  2. page-{slug}.php – 如果页面的缩略名是news,WordPress将会查找 page-news.php(WordPress 2.9及以上版本支持)
  3. page-{id}.php – 如果页面ID是6,WordPress将会查找page-6.php
  4. page.php
  5. index.php

分类

  1. category-{slug}.php – 如果分类的缩略名为news,WordPress将会查找category-news.php(WordPress 2.9及以上版本支持)
  2. category-{id}.php -如果分类ID为6,WordPress将会查找category-6.php
  3. category.php
  4. archive.php
  5. index.php

标签

  1. tag-{slug}.php – 如果标签缩略名为sometag,WordPress将会查找tag-sometag.php
  2. tag-{id}.php – 如果标签ID为6,WordPress将会查找tag-6.php(WordPress 2.9及以上版本支持)
  3. tag.php
  4. archive.php
  5. index.php

作者

  1. author-{nicename}.php – 如果作者的昵称为rami,WordPress将会查找author-rami.php(WordPress 3.0及以上版本支持)
  2. author-{id}.php – 如果作者ID为6,WordPress将会查找author-6.php(WordPress 3.0及以上版本支持)
  3. author.php
  4. archive.php
  5. index.php

日期页面

  1. date.php
  2. archive.php
  3. index.php

搜索结果

  1. search.php
  2. index.php

404(未找到)页面

  1. 404.php
  2. index.php

附件页面

  1. MIME_type.php – 可以是任何MIME类型 (image.php, video.php, audio.php, application.php 或者其他).
  2. attachment.php
  3. single.php
  4. index.php

这篇文章有用吗?

点击星号为它评分!

平均评分 0 / 5. 投票数: 0

到目前为止还没有投票!成为第一位评论此文章。

在AI工具中继续讨论:

曾凤祥

曾凤祥

WordPress技术负责人
小兽WordPress凭借15年的WordPress企业网站开发经验,坚持以“为企业而生的WordPress服务”为宗旨,累计为10万多家客户提供高品质WordPress建站服务,得到了客户的一致好评。我们一直用心对待每一个客户,我们坚信:“善待客户,将会成为终身客户”。小兽WordPress能坚持多年,是因为我们一直诚信。

相关文章

无论你是否已有网站,我们都能帮你把线上业务推上新高度

从0到1,快速搭建专业线上业务平台

从0到1,快速搭建专业线上业务平台

无论您从事何种行业,小兽WordPress​ 都能为您提供专业、可定制、易维护的网站构建方案。我们精选多款高品质模板,适用于展示型官网、品牌形象站、外贸独立站等多种场景,助您快速上线,抢占市场先机。无需代码,轻松启动,即享专业设计。

立即查看所有模版
已有网站?我们来帮你加速、优化、变现

已有网站?我们来帮你加速、优化、变现

您的网站是否遇到加载慢、跳出率高、SEO停滞、体验老旧等问题?这不仅影响技术表现,更会导致客户流失与增长瓶颈。小兽WordPress​ 为您提供全面诊断、提速优化与价值深耕服务,通过“技术+策略”双驱动,助力网站高效转化,推动业务持续增长。

马上获取专属优化方案
微信联系
chat 扫码联系
模板建站
挑选模板
网站定制
免费诊断
咨询热线
咨询热线

189-0733-7671

返回顶部