从零开始制作主题：主题开发入门

欢迎阅读WordPress主题开发手册，这是学习WordPress主题开发必不可少的资源。

主题开发手册是WordPress主题开发相关问题的资源库。无论您是WordPress主题开发新手，还是经验丰富的主题开发人员，都可以在这里找到与主题相关问题的答案。

如果您不熟悉开发WordPress主题，请从第 1 部分开始，在第 1 部分中，您可以 了解什么主题，了解 WordPress 许可证， 设置开发环境以及 创建第一个主题。
一旦了解了什么是WordPress主题， 主题基础知识部分将向您介绍WordPress主题开发的知识板块。
主题功能部分向您展示了可以在WordPress主题中使用的各种核心功能。
如果您希望提供灵活性，并且让您的主题更加容易安装，请参考自定义 API 和 安全性章节。
掌握了主题开发的基础知识后，请查看子主题，最佳 UI 实践，主题测试等章节。
一旦您准备好了把您的主题分享给全世界，最后一部分将介绍 如何发布你的主题，教你一些主题发布的最佳实践，以及为 WordPress.org 主题目录做好准备的各项事宜。

WordPress主题开发手册由 WordPress 社区为 WordPress 社区创建。我们一直在寻找更多的贡献者; 如果您有兴趣，请访问文档团队博客，了解怎么参与其中。

入门

准备开始开发WordPress主题了吗？恭喜，你来到了正确的地方。

在开篇章节中，我们将了解什么是WordPress主题 以及它们是如何工作的。然后，我们将讨论 GPL —— 用于 WordPress 核心及WordPress主题目录中所有主题的许可证。

接下来，我们将向您介绍WordPress主题开发工具包中的一些工具，并教您如何 设置本地开发环境 。

我们将通过查看几个靠谱的 WordPress主题示例 来完成本章 。

谁应该阅读此手册

主题开发手册是一个独立资源，可以帮助您学习WordPress主题开发的基础知识。阅读本手册后，您可以：

制作一个基于父主题的子主题
基于现有主题开发新主题
了解主题的内部运作机制
根据你的想象力开发一个全新主题

必备技能水平

为了充分利用本手册，您应该对 Web 技术（如 HTML，CSS 和 PHP）有一定的了解和使用经验，除此之外，您还需要熟悉怎么使用 WordPress 安装和配置一个站点。

了解 MySQL 数据库的工作方式及一些常用的服务器技术是有用的，但不是开发WordPress主题的必要条件。同样，虽然 JavaScript 知识会很有用，但并不是必要条件。

本手册涵盖哪些内容

本手册提供了开发WordPress主题所需 的 基本信息 ，包括对模板标签和功能的深入介绍。

WordPress 是一个广泛的话题，本手册不可能涵盖有关 WordPress开发的方方面面。如果您需要特定功能的帮助文档，可以在代码参考中找到相关信息 。

本手册的目的是为您提供WordPress主题开发基础知识、构建主题基本步骤、一些有助于提高开发技能的技巧和资源。

什么是主题

WordPress主题负责站点的外观，包括布局、配色、功能模块等等。更改主题会更改网站的外观设计，即用户在浏览您的网站时看到的内容和版式。 虽然许多WordPress 网站使用定制开发的主题，但 WordPress.org 主题目录中 有数千个免费的WordPress 主题可供您使用。

主题可以做什么？

WordPress主题中数据库中获取数据，然后在浏览器中显示。创建WordPress主题时，我们可以决定该内容的外观和显示方式。例如：

使用一列、两列、多列布局、是否为响应式等。
把内容展示在站点中的任意位置。
指定您的内容在哪些设备或哪些操作中可见。
使用 CSS 自定义其排版和设计元素。
在主题的任何位置包含其他设计元素（如图像和视频）。

WordPress主题非常强大。但是，与其他网页设计项目一样，主题不仅仅是颜色和布局。优秀的主题不仅有一个美丽的外表，还可以提高网站的参与度 。

主题是什么？

从本质上说，WordPress主题是一些模版文件的集合，这些模版文件相互协同，创建了您所看到的内容，控制着网站的外观和交互方式。

主题所需文件

最基本的 WordPress 主题中只 需要两个文件 ：

index.php – 主模板文件

style.css – 主样式文件

以下文件不是必需的，但是我们很可能会在各种主题中看到：

PHP 文件 – 包括模板文件

本地化文件

CSS 文件
图像
JavaScript 文件
文本文件 – 通常是许可证信息 ， readme.txt说明和更新日志文件

主题和插件有什么区别？

主题功能既可以出现在主题中，也可以出现在插件中，但是，最佳实践为：

主题控制网站外观
插件控制网站的行为和功能

我们创建的任何主题都不应添加关键功能。 这样做意味着当用户更换主题时，他们将无法使用该功能。例如，用户的站点中需要一个作品集功能，如果我们在主题中包含了此功能，使用你的主题创建了作品集的站点在更换主题时，这些作品集的内容将无法访问。

通过将关键功能转移到插件中，我们可以在更换主题的的同时保持网站内容不变。

请记住，有些用户经常更换主题。最佳做法是使用插件实现您网站的所需的关键功能，这样即使用户更换了主题，内容也不会丢失，同时，您的工作量也会减小很多。

WordPress.org 上的主题

 WordPress.org 主题目录 是下载WordPress主题最安全的地方之一，所有主题都经过了仔细审查，符合严格的主题审查指南，以确保质量和安全。

入门

现在，你应该知道什么是主题了，是时候开始开发一个WordPress主题了。如果您还没有设置本地开发环境 ，请先设置一个。然后 查看一些WordPress主题示例，如果您是个急性子，可以直接 深入了解怎么开发您的第一个主题 。

WordPress 证书和 GPL

如果您打开公开您的WordPress主题给大家使用（ 免费或付费），您需要了了解一下 WordPress 使用的 GNU 通用公共许可证（GPL）。

GPL 基本自由

作为构成 GPL 许可证的基本原则，开放和分享的精神在 WordPress 社区中蓬勃发展。GPL 是一种开源软件的 “权利法案” ，规定了下列四项自由：

自由地为任何目的运行程序 。
自由地研究程序如何工作 并修改程序，以便让程序按照您的意愿执行。
自由地重新分发副本， 以便帮助其他人。
自由的分发修改后软件副本 ，让社区有机会从您的更改中受益。

什么是软件环境中的 “free”？

自由软件中的 “free” 是指自由而不是价格。自由软件基金会喜欢说“言论自由，而不是啤酒。”，自由软件是指用户可以随意使用和修改的软件，而不是说自由软件必须是免费的软件，尽管 WordPress.org主题目录 中托管的软件确实是免费的。

自由软件可以标价出售。换句话说，我们可以创建一个 GPL 主题并以 50 美元的价格出售，它仍然是自由软件。为什么？因为用户可以自由运行，修改和分发软件或对软件修改。

保持所有人的自由

GPL 的自由不仅适用于原软件; 基于 GPL 软件修改的作品也必须采用相同的许可证，不得做任何限制或添加附加条款。

从这个意义上说，GPL 通过确保任何从自由软件派生的东西在日后不能被”锁定”,从而提供了对自由的终极保护；它必须永远自由，以方便未来的实验和探索。

我是否需要为我的主题添加 GPL 许可？

如果您不准备分发您的主题，就不需要采用 GPL 许可。GPL 仅适用于可分发的软件，如果您不分发软件（例如，你为自己的网站定制开发了一个主题，这个主题只有你自己使用）您就不需要采用GPL。

如果准备将你的主题提交到 WordPress.org 上的免费主题仓库，则必须 100％ 符合 GPL 标准，包括 CSS 和图像文件。因为 GPL 中阐述的自由是 WordPress 的核心原则，我们鼓励开发人员使用 100％ GPL 兼容许可证分发他们的主题。

自由是开发WordPress主题的重要部分。 如果您准备分发您的主题，最好在 GPL下完全授权 ，以便其他人可以同样享受您在创作主题时所享受的自由。

进一步阅读

加深您对 WordPress 和 GPL 的理解：

WordPress.org：主题也是 GPL
Matt：问答：WordPress 和 GPL
Matt：四大自由
GNU 通用公共许可证，版本2
GNU 通用公共许可证，版本3