按照这些分步说明在公共 WordPress 插件目录中添加和更新插件。

视频中的这些基本步骤如下：

• 开始使用您的插件
• 注册 WordPress.org 帐户
• 请求将您的新插件放入 WordPress 插件目录
• 为您的机器安装 SVN 客户端
• 为您的项目选择本地目录
• 您的插件请求批准电子邮件
• 本文的目录条款
• 将新的服务器目录拉到您的本地计算机
• 完成插件的开发
• 向公众提供您的第一个版本
  • 更新项目目录主干
  • 在服务器上标记新版本
  • 使用新的标记版本更新本地项目目录
  • 更新 readme.txt 稳定标签
• 插件的新发展

开始使用您的插件

无论您只是有一个想法还是即将完成 0.1 版，您都需要插件的名称和描述。 使名称简短且具有描述性，让您了解插件的作用。 “Wax on Wax off Plugin”不是一个好名字。 “Drop Shadow Maker”要好得多。 您无需在实际标题中添加“插件”。

为了配合你的标题，你应该写一个简短的描述告诉人们你的插件提供了什么好处。 我建议此描述少于 150 个字符。

注册 WordPress.org 帐户

如果您还没有 WordPress.org 帐户（用于在支持论坛等中进行交互），您需要获得一个。 只需访问：https://login.wordpress.org/register

请求将您的新插件放入 WordPress 插件目录

大多数带有兼容许可证的合理插件都可以在 WordPress 插件目录中获得空间。

1. 转到：http://wordpress.org/extend/plugins/add/
2. 填写您的标题和描述
   （我告诉过你你需要那个！）
3. 跳过此表单中插件的上传——即使您的插件已准备就绪。

您的插件目录请求由真人处理，因此可能需要一段时间。

为您的机器安装 SVN 客户端

要使用插件目录，您的机器上需要一个 Subversion 客户端。

• 对于 Windows，我推荐 TortoiseSVN。
• 对于 Mac，SCPlugin 似乎是一个不错的软件包。

只需选择一个并安装它。 关于这一点没有太多可说的。

为您的项目选择本地目录

Subversion 将使用 WordPress 插件目录使您的插件文件的本地副本保持最新。 我建议在您的本地计算机上创建一个目录，您将在其中保存所有 Subversion 跟踪的项目。 警告： 如果您在本地计算机上有 Web 开发环境，请不要试图使用本地 Web 服务器的 WordPress 插件目录作为您的项目目录。

例如，如果您在插件文件夹所在的计算机上安装了本地 WordPress：

documents/public_html/devdomain.com/wp-content/plugins/

…不要认为您可以使用该目录来同步您的 WordPress 插件目录项目。 那会给你带来痛苦。

相反，创建一个像这个例子一样的目录：

documents/projects/wp-plugins-public/

您的每个插件项目文件夹都将位于“wp-plugins-public”中。 对于本教程，我将使用一个名为“content-scheduler”的插件文件夹。 因此，我将创建一个这样的目录：

documents/projects/wp-plugins-public/content-scheduler

您的插件请求批准电子邮件

一旦您的插件请求获得​​批准，您将收到一封电子邮件，其中包含指向您的 SVN 存储库的链接。 这是专门针对那个插件的，是继续进行 Subversion 同步所必需的。

本文的目录条款

这篇文章中提到了这么多不同的目录、项目和文件夹，很容易让人感到困惑。 在使用这个 Subversion 工作流时，让我们在三个不同的位置上达成一致。

1. 工作目录
   这是您正在更改和测试的代码的当前副本。 它应该位于开发 Web 服务器上的“/wp-content/plugins/”文件夹中。 在我的机器上，它恰好是：
   documents/public_html/devdomain.com/wp-content/plugins/content-scheduler/
2. 项目目录
   这是您的 Subversion 客户端将与 WordPress 插件目录保持同步的目录。 在我的机器上，这是：
   documents/projects/wp-plugins-public/content-scheduler/
3. 服务器目录
   这指的是存储在 WordPress 插件目录中的项目。 这是公众可以获取您的插件的地方。 根位置称为您的“SVN 存储库”，将在您的插件请求批准电子邮件中分配给您。 对于我的示例，这是：
   http://plugins.svn.wordpress.org/content-scheduler

将新的服务器目录拉到您的本地计算机

即使您没有在插件目录中的新插件位置放置任何文件，您也需要将该目录的副本下载到您的机器上。 这样做会在幕后设置一些标志，以帮助您的 Subversion 客户端知道怎么了最新的，什么不是。

1. 右键单击您的项目目录插件文件夹。
2. 选择“SVN结帐”。
3. 在第一个字段中输入您的 WordPress SVN 存储库 URL（来自您的批准电子邮件）。
4. 您的项目目录插件文件夹应该在第二个字段中。
   由于您通过右键单击该文件夹开始此过程，因此应该已经填充了该字段。
5. 点击“确定”

完成插件的开发

开发和测试你的插件。 这包括创建一个适当的“readme.txt”文件来配合它。 “readme.txt”文件不仅仅是一些关于你的插件的随机注释。 WordPress 插件目录使用“readme.txt”文件的内容来了解​​您的插件的哪个版本被认为是最新的，并在目录中构建插件页面的内容。

• 有关创建正确的“readme.txt”文件的更多信息，请参阅这个 WordPress readme.txt 示例。

“readme.txt”文件的一个重要部分是“Stable”标签。 在开发插件时，请将此标签保留为“主干”。 一旦您发布了供公众使用的版本，我们将使用正确的版本号对其进行更新。

向公众提供您的第一个版本

更新项目目录主干

1. 将工作目录的内容复制到项目目录的“trunk”文件夹中。
   就我而言，我正在从工作目录复制插件的全部内容：
   /documents/public_html/devdomain.com/wp-content/plugins/content-scheduler/
   到我的项目目录：
   /documents/projects/wp-plugins-public/content-scheduler/
2. 右键单击项目目录中的“content-scheduler”插件文件夹，然后选择“SVN Commit”。
3. 如果需要，请为提交输入注释。
4. 查看被视为新文件并将复制到服务器的文件列表。 如果此列表看起来准确，请单击“确定”，文件将被复制到 wordpress.org 上的服务器目录。

在服务器上标记新版本

您已经更新了“主干”中的文件，但这不是公众应该下载的内容。 您需要使用“标记”来创建“主干”的副本。 此副本将不再更改，将提供给公众使用。 对于这个例子，让我们创建一个 1.0 版本。

1. 右键单击项目目录的“trunk”文件夹并选择“Branch/Tag”。
   对我来说，这是：
   /documents/projects/wp-plugins-public/content-scheduler/trunk/
2. “To URL”位置字段将以“/trunk”结尾。 您需要将其更改为“/tags/1.0”以创建您的 1.0 版本。
3. 如果需要，您可以添加有关此标记操作的注释。
4. 单击“确定”，然后 忽视 任何有关“更改此分支的重要信息……”的消息

使用新的标记版本更新本地项目目录

您刚刚告诉服务器在“/tags/1.0”目录中创建项目文件的新副本。 现在，我们需要使用该新标签更新您的本地项目目录。

这个过程可能看起来很奇怪。 您可能想知道为什么不能在本地“/tags/1.0”目录中制作自己的副本。 如果你这样做，服务器目录和项目目录可能会变得混乱和混淆什么是更新的，什么不是。

• 再次右键单击项目目录并选择“SVN更新”。
  这会将更改从服务器目录拉到本地项目目录。 在这种情况下，更改是添加文件的“/tags/1.0”副本。

更新 readme.txt 稳定标签

所有正确的文件都已准备好供公众使用您的插件。 但是，我们必须告诉插件目录公众应该使用哪个标记版本。

1. 编辑本地项目目录的“trunk”文件夹中的“readme.txt”文件。
   对我来说，这是以下内容：
   /documents/projects/wp-plugins-public/content/scheduler/trunk/readme.txt
2. 将“稳定标签”更改为您的发布版本，“1.0”
3. 保存文件
4. 右键单击刚刚更新的“readme.txt”文件，然后选择“SVN Commit”。

而已！ 在 15 分钟左右：

1. WordPress 插件目录将更新您的项目列表
2. “1.0”将被视为稳定标签
3. “/tags/1.0/readme.txt”中的信息将用于填写您的项目页面。

插件的新发展

最有可能的是，您将对插件进行改进并需要发布它们。 这是它的工作原理。

1. 对工作目录中的插件进行更改。
   这些更改应根据需要包括对 readme.txt 文件的更改，例如更改日志条目。
2. 将工作目录中的更改复制到本地项目目录中。
3. 确保 readme.txt 文件具有当前公共版本的正确“稳定”标签。
4. 右键单击项目目录并选择“SVN Commit”以将新的主干更改放入服务器目录。
5. 右键单击项目目录中的“trunk”目录并选择“Branch/Tag”以创建新的版本标签以进行发布。 （确保“在存储库中创建副本：”设置为“工作副本”。）
6. 右键单击项目目录并选择“SVN 更新”以从服务器目录中下拉标签更改。
7. 更新项目目录的“/trunk/readme.txt”文件中的稳定标签以匹配您创建的新发布标签。
8. 右键单击项目目录（是的，再单击一次）并选择“SVN Commit”以将更新后的 readme.txt 文件发送到服务器。

呸。 就这样！

• 开发商
• wordpress.org