WordPress主题文件结构
 doctorrm      2019-03-06 18:05:46      22      0      

主题的文件结构

WordPress主题放在wp-content/themes/下,作为一个独立的文件夹存在。文件夹的名字随意,但不要使用纯数字,否则会导致主题无法在主题列表中正常显示。主题文件夹中包含该主题需要的所有样式文件、模板文件、函数文件、JavaScript脚本文件、静态文件等。

一个最小的主题包括三类文件:
1,样式表style.css
2,模板文件
3,函数文件functions.php(可选)

注意,这些文件的名称是固定的,不能随意更改。

样式文件

style.css是一个主题的必选文件,因为其中包含了对这个主题的描述信息。

一个style.css的头部信息如下:

/* Theme Name: 主题名称(必选)
Theme URI: 主题的地址,可选,格式为一个URL,如http://wordpress.org/
Description: 对主题的描述,会显示在主题列表中。
Author: 作者
Version: 版本,如1.0
Tags: 给主题加的一些标签,可选,一般是为了让用户更方便搜索到这个主题。
*

需要注意的是,每个主题都应该有一个自己的主题名称(Theme Name),以便于在主题列表中可以区分。

模板文件

模板文件不是一个文件,而是一类php文件。它们决定了你每个页面的最终显示效果。模板文件遵循一定的命名规则,下面是每个模板的名称和用途。

index.php
这是WordPress主题中最通用的模板文件和主题的两个必需文件之一(另一个是style.css)。

当没有更具体的内容与查询匹配时,它用于显示页面。例如,当没有home.php文件时,它将作为主页。

comments.php:评论模板

front-page.php:首页模板,仅用于开启静态首页时(使用page作为首页)。

single.php
单独页面模板。显示单独的一篇文章时被调用。对于这个以及其他的请求模板,如果模板不存在会使用 index.php。

category.php:分类模板,分类页面调用。

tag.php:标签模板,标签页面调用。

taxonomy.php:术语模板,请求自定义分类法的术语时使用。

author.php:作者模板,作者页面调用。

date.php:日期/时间模板,按时间查询时使用的模板。

archive.php:存档模板,查询分类,作者或日期时使用的模板。需要注意的是,该模板将会分别被category.php, author.php, date.php所覆盖(如果存在的话)。

search.php:搜索结果模板,显示搜索结果时使用的模板。

attachment.php:附件模板,查看单个附件时使用的模板。

image.php:图片附件模板,当在wordpress中查看单个图片时将调用此模板,如果不存在此模板,则调用attachment.php 模板。

404.php:404 错误页面模板,当WordPress无法查找到匹配查询的日志或页面时,使用404.php文件。

没有特别的数量要求,你甚至可以仅仅使用一个文件index.php作为模板文件,所有 页面都会使用这个模板,多数情况下,你会有多个模板来显示不同的页面。

函数文件

除非你建立一个纯静态的主题,否则你一定会调用到Wordpress的API。这些主题所要用到的函数就写在functions.php文件中。你可以以Wordpress自带主题中的functions文件做为参考。

附录

在模板文件中所有你可能用到的Wordpress函数在这里都可以找到:WordPress Function Reference

参考

https://tutorials.hostucan.cn/article-5125

去打赏

您的支持将鼓励我们继续创作!

[微信] 扫描二维码打赏

[支付宝] 扫描二维码打赏

正在跳转到PayPal...

发表评论