如何添加插件到 WordPress 存储库？

问题描述

我刚刚做了我的第一个插件，它被 WordPress 批准。对我来说好消息，但现在呢？食品法典中的”instructions” 对我而言都是清楚的。我找到一篇关于 Dig WP 的文章，我设法得到第 3 行代码。之后没有快乐。

有没有人在这里有一个明确的说明，如何做到这一点，而不需要阅读整本书？我相信这里有非常有经验的人一直在做这些事情…

提前致谢！

最佳解决方案

步骤 1 – 确保事物的格式正确

WordPress 本身取决于您的主要插件文件顶部的标题。在许多情况下，如果你的插件是「我的酷插件」，这个文件是 my-cool-plugin.php 在你的文件夹的主目录。确保文件的顶部遵循以下格式：

<?php
/*
=== [Plugin Name] ===

Plugin Name: [Plugin name]
Plugin URI: [Website where plugin information can be found - your blog, maybe]
Description: [Short description of your plugin]
Author URI: [Your website]
Author: [Your name]
Version: [This version number]
*/

WordPress.org 存储库取决于您的 readme.txt 文件来创建描述和下载页面。所以确保您的 readme.txt 文件符合以下格式：

=== [Plugin Name] ===
Contributors: [Your WordPress.org username]
Donate link: [A site people can go to to give you money]
Tags: [Search terms related to your plugin]
Requires at least: [Minimum version of WordPress required]
Tested up to: [Newest version of WordPress you've tested with]
Stable tag: [This version number]

[Short, one-sentence description of your plugin]

== Description ==

[Long description of your plugin]

== Installation ==

[Steps required to install the plugin]

== Frequently Asked Questions ==

= [A question] =

[An answer]

= [Another question] =

[Another answer]

== Screenshots ==

== Changelog ==

== Upgrade Notice ==

在 WordPress.org 上有一个方便的 readme validator，您可以使用它来确保您的自述文件具有所需的一切。只是 copy-paste，它会检查，以确保所有的部分在那里，你准备好了。

步骤 2 – 查看 SVN 信息库

将开发版本与 WordPress.org 插件存储库分开是个好主意。是的，SVN 用于版本控制，但 WordPress 更多地用于发布管理。如果您开始提交存储库中的每个更改集，您都可能遇到问题。许多开发人员做的一件事是使用 Git 在本地开发，然后当您准备好发布时，将文件传输到 Subversion 存储库。

These instructions assume you’re using a Windows computer. If you’re on a Mac, you can use SCPlugin instead of TortoiseSVN. The steps you’ll need to follow will be the same, only the contextual menus and screenshots will differ slightly because of the UI. I don’t have a Mac, so I can’t create screenshots to walk you through a tutorial … but trust me, it’s the same process.

如果您还没有安装 TortoiseSVN 。

TortoiseSVN 是 Windows 的开源 Subversion GUI 。相信我，使用 GUI 比从命令行做起的事情要容易得多。你也会遇到更少的问题。

查看您的 WordPress-hosted SVN 信息库

找到您要存储 WordPress-hosted 版本的插件的地方。默认情况下，我使用/My Documents/WordPress/进行我所有的托管开发工作。文件夹中的 Right-click，并从下拉菜单中选择”SVN Checkout” 。

在弹出的对话框窗口中，输入您的 WordPress.org 插件存储库 URL(我正在使用我的一个演示目的)，并选择要创建的子文件夹。

乌龟会考虑一下，然后它将从 WordPress.org 下载存储库。新创建的文件夹将为您设置所有必需的文件夹。现在你只是 copy-paste 并提交… 一步一步。

将您的最新版本复制到`/tags`

这是我从大多数教程中向后退的地方。其他人都会告诉你提交/trunk，但是请记住，WordPress 在/trunk 中不使用任何东西，除了 readme 文件，看看插件。所以如果你把你的插件放到/trunk 中，并在你提交标签之前丢失你的网络连接 (或其它的一些问题)，你会有问题。

在/tags 文件夹中，创建一个名称与您为插件发布的版本相同的文件夹。所以如果你发布版本 0.1，创建一个/tags/0.1 文件夹。

将整个插件复制到此文件夹中。

现在 right-click 在文件夹内，从下拉菜单中选择”SVN Commit” 。

您将看到一个弹出窗口，显示所有更改 (您应该看到所有新文件标记为”non-versioned”) 。

选中所有插件文件旁边的框 (或单击”Select All” 选择所有的文件) 。

在顶部的框中，输入提交消息。由于您提交标签，您应该使用以下内容：

Tagging version 0.1 of [My Plugin].

单击确定。

再次，龟龟会想几分钟，那么它会要求你的 WordPress 用户名和密码来提交服务器。提供他们，等待事情通过，并说”Success,” 然后继续下一步。

将您的最新版本复制到`/trunk`

现在导航到存储库的/trunk 文件夹，再次将 copy-paste 插入该文件夹。通过上述相同步骤选择您的文件并准备提交。但是对于一个消息，请使用一些解释新版本的内容：

Version 0.1 of [My Plugin] – adds support for OpenID.

一旦一切顺利，您只需等一下 WordPress.org 的服务器赶上。他们可能比其他人慢几天，但在一个小时左右，您应该在存储库中看到您的新版本。

将插件更新到新版本

一旦您的插件在野外，准备更新是相对容易的。

首先，使用 SVN 更新命令确保拥有存储库的最新版本。如果你是唯一的开发人员，那么你应该已经有了，但是在做任何事情之前都要进行更新。

然后，通过上述过程，在/tags 中为您的新版本创建一个新的 sub-folder 。说，/tags/0.2 。不要触摸旧的/0.1 文件夹。这是一个理由，你永远不会再碰到它。

提交您的新标签，然后转到/trunk 文件夹。使用新版本替换/trunk 中的所有内容，并按上述提交。一旦服务器更新，他们将开始谈论新版本而不是旧版本。

参考文献

How to add plugin to WordPress Repository?

注：本文内容整合自 Google/Baidu/Bing 辅助翻译的英文资料结果。如果您对结果不满意，可以加入我们改善翻译效果：薇晓朵技术论坛。

如何添加插件到 WordPress 存储库？