首页>建站相关>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-01-15

利用WordPress Settings API制作主题设置页

关于WordPress设置API在WordPress v2.7中添加了设置API,它允许开发人员创建管理选项页面。界面风格与WordPress后台风格保持一致,只是它使用起来并不那么简单。你不能只定义一个设置数组,您需要编写自己的字段...

建站相关 wordpress

wordpress 2025-01-13

woocommerce历史版本下载页

WooCommerce是一个开源的电子商务插件,专为WordPress网站设计,允许用户在其网站上创建和管理在线商店。自2011年推出以来,WooCommerce迅速成为全球最受欢迎的电商解决方案之一。https://develope...

建站相关 wordpress

wordpress 2025-01-13

关于wp_get_nav_menu_items()这个函数

自己手动书写css的情况,wp的wp_nav_menu()会提供一套分工明确的类,根据其默认类适配css基本就够用了。但应用一些其他框架的时候,不同框架的类名定义显然是不一致的,这个时候wp_nav_menu()提供的自定义功能就有些...

建站相关 wordpress

wordpress 2025-01-10

Wordpress主题中的单例模式

其实对于博主这样的初学者,这个话题是有点超纲的,但如果从零开始想做一个主题。观摩一些成熟的主题是必不可少的,这个时候就有可能遇到这种单例模式的写法,所以即便我们暂时用不到,但了解一下结构,多少能看明白这个类究竟在做些什么事情。单例模式...

建站相关 wordpress

wordpress 2025-01-06

Wordpress主题开发笔记之三 wp_head()

WordPress主题或插件都可以通过给wp_head()函数来向网站的head标签中加入内容,这个函数经常会和wp_footer()函数一起出现,顾名思义,wp_footer()负责在站点的尾部插入内容,这是官方推荐的引入资源的方式...

建站相关 wordpress

wordpress 2025-01-03

Wordpress主题开发笔记之零 劝退函数列表

在ytkah大佬的博客里看到了这个列表,原文地址如下,复制进excel表格内发现一共有951项(含中文小标题),粗略估计有900来个函数吧。当然这并不是Wordpress函数的全貌,但单这900多个函数中的部分函数,可能很多人终其职业...

建站相关 wordpress

wordpress 2024-12-26

从零开始做一个wordpress主题系列

一直想DIY一个wordpress主题,虽然梦想还是要有的,但念念不忘,至今也没有什么回响。博客里倒是攒了几篇相关的文章,眼瞅着孩子快放寒假,假期不再需要迎来送往,可能会空一点,就准备整理一下,顺便重拾这份初心。因为是随手做的笔记,所...

建站相关 wordpress

wordpress 2024-12-26

创建自定义WordPress主题设置页面

WordPress以其灵活性和易用性而闻名,使其成为各种规模网站的热门选择。有助于其灵活性的关键功能之一是能够为您的主题创建自定义设置页面。这使您可以为用户提供一个界面,以自定义主题的各个方面,而无需深入代码。为什么要创建自定义设置页...

建站相关 wordpress

wordpress 2024-12-25

如何重新安装一个wordpress

拖拖拉拉的,到今天为止,虾比比分站也才一个首页。倒是待审广告评论已经累计了2000多条,懒得一条条删除,干脆重新安装一下系统。首先进入数据库,删除掉原来博客对应的数据表。drop database yourdatabase接下来在对应...

建站相关 wordpress