首页>建站相关>Wordpress主题开发笔记之一 文件结构

Wordpress主题开发笔记之一 文件结构

打开wp-config.php,设置调制模式为开启,开发结束后记得要回来关闭哦;

define('WP_DEBUG',true);

主题目录结构

- wp-content
  - themes
    - yourtheme

这里博主命名了一个中二的名字'tsubasa';

- wp-content
  - themes
    - tsubasa
      - index.php
      - style.css

在wordpress中,主题相关信息存储在style.css中,比如以下是Twenty Sixteen主题的一个头部说明片断;

/*
Theme Name: Twenty Sixteen
Theme URI: https://wordpress.org/themes/twentysixteen/
Author: the WordPress team
Author URI: https://wordpress.org/
Description: Twenty Sixteen is a modernized take on an ever-popular WordPress layout — the horizontal masthead with an optional right sidebar that works perfectly for blogs and websites. It has custom color options with beautiful default color schemes, a harmonious fluid grid using a mobile-first approach, and impeccable polish in every detail. Twenty Sixteen will make your WordPress look beautiful everywhere.
Version: 1.3
......
*/

学习过程中我们暂时不用写得这么复杂,可以先输入一些基础信息比如:

/*
Theme Name: tsubasa
Author: alphonse
Description: just so so
Version: 1.0
*/

在index.php中放入一个标准模板:

<!DOCTYPE html>
<html lang="zh-CN">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1">
    <title>主题首页</title>
</head>
<body>
    <p>Hello World!</p>
</body>
</html>

这两个文件构成了一个最小主题,你甚至可以直接将其打包上传至服务器试运行,当然这个极简主题除了现实一行“Hello World!”并不具备什么意义。

主题常见文件

//常见文件
style.css:主题样式文件;
index.php:主题入口文件;
header.php:页眉内容;
footer.php:页脚内容;
single.php:单篇文章模板;
page.php:分页页面模板;
functions.php:主题功能文件,存放一些主题支持函数,添加自定义功能;
//常见文件夹
assets:存放css,js和图像等资源的文件夹;
inc:存放php文件,文件内一般是自定义函数;

太长不看的加长版本

css(文件夹):存放 css 文件
genericons(文件夹):存放字体文件
inc(文件夹):存放 php 文件,文件内一般是自定义函数
js(文件夹):存放 js 文件
languages(文件夹):存放语言文件
template-parts(文件夹):为了代码简洁,作者把一些代码(可能重复用到的)分开放到了此文件夹下
404.php:出现404错误时使用的文件
archive.php:分类页面
comments.php:评论
footer.php:页脚
functions.php:定义函数
header.php:页头
image.php:图片
index.php:首页
page.php:页面(page)
rtl.css:关于字体的一些样式
screenshot.php:主题缩略图,在后台显示
search.php:搜索页面
searchform.php:搜索框
sidebar.php:侧边栏
sidebar-content-bottom.php:侧边栏底部
single.php:文章(post)页面
style.css:样式文件

更可以跳过的文件执行优先级

以主页为例,下面有2个文件 home.php 和 index.php,WordPress 程序会从你的主题文件夹中依次查找这两个文件(后台设置首页显示为”最新文章”的前提下):

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

主页

home.php
index.php

文章页:

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

页面

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

分类

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

标签

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

作者

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

日期页面

date.php
archive.php
index.php

搜索结果

search.php
index.php

404 (未找到)页面

404.php
index.php

附件页面

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

可以看到,最低优先级都是index.php,也就是说,没有找到优先级靠前的专属文件时,系统最后都可以拿index.php做为备胎,这也是前文2个文件组成一个最low主题的理论基础。

标签: wordpress

移动端可扫我直达哦~

推荐阅读

wordpress 2025-04-07

wordpress主题目录穿越导致的bug

尝试从知乎的热榜api提取数据并保存到本地,隔几个小时刷新一次,前几天运行的好好的,这几天突然发现数据有几天没有更新了。手动刷新了一下数据获取页,一直提示无需更新,将文件下载到本地测试,功能又是完好的。开了wp的debug模式,修正了...

建站相关 wordpress

wordpress 2025-03-31

wordpress 重新生成缩略图

测试wp缩略图功能的时候不小心把所有的缩略图都删掉了,但保留了原图,不想一个个重新上传以生成缩略图,就使用了这段代码,注意生成成功之后,这段代码就可以删掉了。忽然想起之前钉钉宣传的某个功能,阅后即焚~~function regener...

建站相关 wordpress

wordpress 2025-03-29

WordPress的主循环与WP_Query

WordPress的主循环和WP_Query是主题开发中最重要的两个概念,它们负责从数据库获取内容并显示在页面上。主循环 (The Loop)主循环是WordPress用来显示文章的核心机制。它是一个PHP代码结构,用于遍历当前页面请...

建站相关 wordpress

wordpress 2025-03-22

在phpstudy中为wordpress开启伪静态

原文修改主题都是在服务器上一边在线修改一边调试,用上了phpstudy后才发现自己之前的方式有多没有效率。但测试设置固定链接的时候遇到了一个问题,就是设置前也无风雨也无晴,设置后统一返回404。这个问题之前尝试搭建站点的时候也遇到过,...

建站相关 wordpress

wordpress 2025-03-17

WordPress分页中遇到404错误:posts_per_page

这个问题可能更多为主题开发者所遇见,一款推向市场的主题一般都会几经测试,应该不容易到客户手中才发现这个问题。所以网络上的相关讨论不多,博主也是调试了几天才大致有了一些思路:后台的默认参数在wordpress的后台设置里,是可以设置归档...

建站相关 wordpress

wordpress 2025-03-14

WORDPRESS HEADER模块常用函数

在 WordPress 开发中,header.php 文件是主题的重要组成部分,用于定义网站的头部内容。以下是一些在 header.php 中常用的 WordPress 函数及其用途,如果嫌部分函数生成的默认模板不需要的元素过多,也可...

建站相关 wordpress

wordpress 2025-03-12

wordpress的前后台数据交换ajax

ajax是个耳熟能详的词儿,但因为有点儿复杂,博主一直是规避学习的,今天刚好碰到一个前台jquery向wp后台申请数据的问题。躲不过,那就慢慢调试吧。钩子wp的ajax还区分了用户,对于不同的用户(登录与否)采用不同的钩子,不过这里只...

建站相关 wordpress

wordpress 2025-03-07

WordPress中add_meta_box函数参数详解

add_meta_box 是 WordPress 中用于在后台编辑页面添加自定义元框(Meta Box)的函数。它允许开发者在文章、页面、自定义文章类型等编辑页面中添加自定义字段或内容。以下是 add_meta_box 函数的参数及其...

建站相关 wordpress

wordpress 2025-03-07

wordpress 手动添加自定义字段

自定义字段可以扩展文章的信息,也有很多相关的成熟的插件,比如Advanced Custom Fields (ACF) 插件,如果希望添加的字段不多,也不愿意为此安装过多的插件,我们也可以考虑手动来添加它。为post文章添加字段// 添...

建站相关 wordpress