WordPress主题制作（一）：主题文件结构

在上一篇文章中，我们安装好了WordPress，准备好了制作主题需要的工具和主题测试的浏览器，接下来就要开始制作了，但在开始制作之前，我们还需要了解主题由哪些文件构成，其次还需要知道WordPress是怎样与主题文件连接的。

下面是一个完整的主题含有的文件列表，到这里我们对这个列表有个初步映像即可：

• 404.php
• archive.php
• author.php
• category.php
• comments.php
• comments-popup.php
• footer.php
• front-page.php
• functions.php
• header.php
• home.php
• image.php
• index.php
• links.php
• page.php
• search.php
• sidebar.php
• single.php
• style.css

那么这些文件的层次结构是怎样的呢？

以主页为例，用于显示主页的文件有三个，分别是front-page.php、home.php、index.php，WordPress将从您的主题中依次查找这三个文件。

1. front-page.php：首先WordPress会判断我们是否设置了静态首页，如果是，将以front-page.php作为模板输出首页内容。
2. home.php：如果主题中没有front-page.php，那么使用home.php。它还用于在主页上显示博客文章。
3. index.php：如果front-page.php和home.php都不存在，那么WordPress会回退到index.php模板来显示首页。它是WordPress的默认回退模板，可用于显示任何页面。

主页

1. front-page.php——静态首页
2. home.php——动态首页
3. index.php——默认模板

文章单页

1. single-{post-type} – {slug} .php——用于显示任意类型的单个特定文章，例如：文章类型为”review”，文章是”hello-word”，那么WordPress将寻找single-review-hello-word.php
2. single-{post_type}.php——然后检查是否有模板显示特定类型的文章
3. single.php——然后回归single.php
4. singular.php——这是一个备用模板，用以显示任意文章类型的单个项目
5. index.php——最后回落到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

自定义分类归档

WordPress默认分类按照文章分类和标签进行分类，我们也可以创建自定义的分类！

1. taxonomy- {taxonomy} – {term} .php——如果你有一个名为genre(体裁)的自定义分类法，并且有一个特定分类”thriller”(惊悚片)，那么WordPress会寻找taxonomy-genre-thriller.php。
2. taxonomy- {taxonomy} .php——如果没有指定分类，WordPress会寻找taxonomy-genre.php。
3. taxonomy.php——显示任意自定义分类法归档的默认模板。
4. archive.php
5. index.php

自定义文章分类

1. archive- {post_type} .php——如果你的文章类型是review，WordPress会寻找archive-review.php。
2. archive.php
3. index.php

作者档案

1. author-{nicename}.php——如果作者的昵称为lilei，WordPress将会查找author-lilei.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. searchform.php——显示搜索表单的模板
3. index.php

404 (未找到)页面

1. 404.php——显示404错误页面的默认模板
2. index.php

附件页面

1. MIME_type.php——MIME_type代表文件类型，可以是任何MIME类型 (image, video, audio, application 或者其他).
2. attachment.php——显示附件页面的默认模板
3. single-attachment.php——显示单个附件
4. single.php
5. index.php

嵌入页面

从WordPress 4.5开始，可以使用模板渲染嵌入到WordPress中的文章。

1. embed- {post-type} – {post_format} .php——WordPress将首先查找帖子类型和帖子格式模板。例如，如果您对视频进行了审核，那么WordPress会寻找embed-review-video.php。
2. embed- {post-type} .php——如果帖子类型是review，WordPress会寻找embed-review.php。
3. embed.php——所有嵌入的默认回退。

详细说明，请看WordPress官方文档（英文）：

http://codex.wordpress.org/Template_Hierarchy

WordPress主题： 2 / 14

• WordPress主题制作：开始前的准备
• WordPress主题制作（一）：主题文件结构
• WordPress主题制作（二）：模板和模板文件
• WordPress主题制作（三）：牛刀小试
• WordPress主题制作（四）：制作头部模板header.php
• WordPress主题制作（五）：制作底部模板footer.php
• WordPress主题制作（六）：制作侧边栏模板sidebar.php
• WordPress主题制作（七）：制作基础模板Index.php
• WordPress主题制作（八）：制作文章单页模板single.php
• 计划: WordPress主题制作（九）：制作评论区模板comments.php
• 计划: WordPress主题制作（十）：制作单页（非文章）模板page.php
• 计划: WordPress主题制作（十一）：制作静态首页front-page.php
• 计划: WordPress主题制作（十二）：创建您自己的小工具
• 计划: WordPress主题制作（十三）：创建后台主题选项

本文采用 「CC BY-NC-SA 4.0」创作共享协议，转载请标注以下信息：

原文出处：Yiiven https://cloud.tencent.com/developer/article/2193178