如何将您的插件添加到 WordPress 插件目录

您想将您创建的插件添加到 WordPress 插件目录吗?

向目录贡献有用的插件只是您回馈 WordPress 社区的方式之一。

在本文中,我们将讨论将插件添加到 WordPress 插件目录的好处以及如何将插件添加到存储库的分步指南。

如何将您的插件添加到 WordPress 插件目录

为什么将您的插件添加到 WordPress 插件目录?

如果您创建了一个您认为对其他人有用的 WordPress 插件,那么您应该考虑将其添加到官方WordPress 插件目录中。作为开发人员,这对您有很多好处。

WordPress 插件目录是许多用户在为其WordPress 网站寻找插件时首先去的地方。将您的插件添加到目录将使用户更容易找到,并为您作为开发人员提供更高的可信度。

您无需为下载插件所需的带宽付费,该目录将自动跟踪有多少人下载了它,并在升级时通知他们。

该目录还将帮助您支持该插件。用户可以评价您的插件,留下反馈和错误报告,并使用支持论坛。

AIOSEO插件支持论坛

当然,也有一些要求和限制。首先是您的插件必须具有与 WordPress 兼容的许可证。建议使用GPLv2或更高版本。

还有一些道德方面的考虑需要牢记。该插件不得做任何违法或违反道德的事情,并且您不能在未经用户许可的情况下包含指向外部网站的链接。

提交插件后,将手动检查常见错误并确保您已遵循插件目录指南。该过程可能需要 1 到 10 天。

话虽如此,让我们看看如何逐步将您的插件添加到 WordPress 插件目录。

为您的插件创建一个 readme.txt 文件

您需要做的第一件事是为您的插件创建一个“自述”文件。这将显示在目录中的插件页面上,并且需要使用正确的格式。

这是一个示例文件,您可以将其用作起点。您需要将其粘贴到您的文本编辑器中,并将文件另存为 readme.txt 在您的插件文件夹中。

=== Your Plugin Name === Contributors: Your WordPress.org UsernameTags: wpbeginner, plugin tutorialRequires at least: 5.5Tested up to: 5.8Stable tag: 1.0License: GPLv2 or laterLicense URI: http://www.gnu.org/licenses/gpl-2.0.html  A WordPress plugin to teach beginners how to write a WordPress plugin.   == Description ==  This simple plugin is part of our beginner’s guide to writing a WordPress plugin.   == Installation ==  1. Upload the plugin folder to your /wp-content/plugins/ folder.1. Go to the **Plugins** page and activate the plugin.  == Frequently Asked Questions ==  = How do I use this plugin? =  Answer to the question  = How to uninstall the plugin? =  Simply deactivate and delete the plugin.   == Screenshots ==1. Description of the first screenshot. 1. Description of the second screenshot.   == Changelog === 1.0 =* Plugin released.

您需要为自己的插件自定义文件,因此我们将解释 WordPress 插件自述文件语法的工作原理。

第一行是“插件名称”,它将作为插件的标题出现在 WordPress 插件目录中。

下一行是“贡献者”。这些是负责管理插件的 WordPress.org 用户 ID。如果您还没有用户 ID,则需要创建一个免费的 WordPress.org 用户帐户。

“至少需要”和“测试到”字段是指您的插件使用的 WordPress 版本。“稳定标签”是您自己的插件的版本。

您可以保持许可字段不变。然后,您应该编辑“描述”区域以解释您的插件的作用。

编辑插件的自述文件后,不要忘记保存更改。通过官方自述文件验证器运行文件并解决发现的任何问题也是一个好主意。

最后,您应该右键单击您的插件文件夹并创建一个 zip 文件。Mac 用户应该选择“压缩插件名称”,Windows 用户可以选择“发送到 » 压缩(压缩)文件夹”。

创建插件文件夹的 Zip 文件

将您的插件提交到目录以供审核

现在您的插件已准备好接受 WordPress.org 插件团队的审核。

要提交它,请访问添加您的插件页面。如果您尚未登录,请单击屏幕右上角的登录按钮。

登录 WordPress.org

登录后,您将能够上传并提交您的插件以供审核。

只需单击“选择文件”按钮以选择插件的 zip 文件,然后单击“上传”按钮。

上传您的 WordPress 插件以供审核

然后,WordPress.org 插件审查团队将查看您的插件代码以了解常见错误和安全检查。一旦获得批准,您将收到来自插件团队的电子邮件。

此电子邮件将包含指向您的插件将在 WordPress.org 上托管的 Subversion (SVN) 存储库的链接。上传插件时需要使用此链接。

使用 Subversion (SVN) 上传插件

一旦您的插件获得批准,您将需要使用 Subversion (SVN) 上传插件。

Subversion 是一个开源版本控制系统。它允许用户对文件和目录进行更改,同时保留更改记录、管理不同版本以及与其他用户协作。

您需要在您的计算机上安装一个 SVN 客户端来上传您的插件。Windows 用户可以使用SilkSVN或TortoiseSVN(免费)。Mac 用户可以在他们的计算机上安装SmartSVN或版本应用程序。

在本文中,我们将使用适用于 Mac 的版本应用程序。但是,在上面列出的所有 SVN 应用程序中,该过程都非常相似。

安装后,您需要打开版本应用程序并查看 WordPress 插件存储库的副本。为此,只需单击“新建存储库书签”按钮。

新存储库书签

这将弹出一个弹出窗口,您首先需要为此书签提供一个名称。你可以用你的插件来命名它。之后,您需要添加 WordPress 插件的 SVN 存储库 URL。

您可以将用户名和密码字段留空。

连接您的存储库

现在您应该单击创建按钮。版本将连接到您的存储库并将插件存储库的副本下载到您的计算机。

接下来,您需要在浏览器视图中右键单击存储库名称,然后选择“Checkout”。

查看您的存储库

系统将要求您提供文件夹的名称并选择要将其存储在计算机上的位置。您可以使用与插件目录相同的文件夹名称,然后单击结帐按钮继续。

现在,版本应用程序将在您的计算机上为您的插件创建所需的文件夹。您可以在插件的存储库下查看它或在 Finder 中浏览它。

在 Finder 中显示本地存储库

现在您需要复制插件文件并将它们粘贴到本地存储库的主干文件夹中。

当您这样做时,您会注意到版本应用程序中的新文件旁边有一个问号图标。

由于这些文件以前不存在,因此您需要添加它们。选择新文件并单击添加按钮将这些文件添加到本地文件夹。

添加文件

现在您的插件文件已添加到 Subversion,您可以上传它们了。您可以通过同步本地文件夹和 subversion 目录中的更改来做到这一点。

您应该单击本地存储库以选择它,然后单击“提交”图标。

提交更改

将出现一个新的弹出窗口,您将看到更改列表和一个用于添加提交消息的框。单击提交按钮后,版本应用程序将同步您的更改并将它们提交到插件的存储库。

添加提交消息

现在您已将插件文件上传到主干,是时候将它们标记为版本了。

转到插件的本地副本并复制主干文件夹中的文件。之后,您需要打开标签文件夹并在其中创建一个新文件夹。

使用版本名称命名此文件夹。确保它与您在插件标题中输入的版本相匹配。在上面的示例代码中,我们为插件使用了 1.0 版本。

添加 1.0 文件夹后,您需要将插件文件粘贴到其中。由于这是一个新文件夹,您还需要单击“添加”按钮以将文件夹及其所有文件包含在存储库中。

添加文件

之后,您可以继续并单击“提交”图标以像之前一样同步您的更改。您现在可以访问 WordPress 插件目录并预览您的插件。

每当您需要编辑插件文件时,都应该编辑本地副本。完成更改后,只需单击“提交”图标即可将它们与 WordPress 插件目录同步。

当您对插件进行重大更改时,您需要通过将具有该版本号的新文件夹添加到 tags 文件夹来添加新版本。确保版本号与插件的标头匹配。

将艺术品添加到 WordPress 插件目录

MonsterInsights 插件页面

现在我们可以将一些艺术作品和屏幕截图添加到 WordPress 插件目录。这些项目需要遵循标准命名惯例并且应该使用 Subversion 上传。

插件标题横幅

标题横幅是出现在插件页面顶部的大图像。其大小应为 772×250 或 1544×500 像素,您应使用 JPEG 或 PNG 文件格式。

根据图像的大小和文件类型,您需要为标题横幅提供以下名称之一:

横幅-772×250.jpg

横幅-772×250.png

横幅-1544×500.jpg

横幅-1544×500.png

插件图标

该图标是一个较小的方形图像,将显示在搜索结果和插件列表中。其大小应为 125×125 或 250×250 像素,您应使用 JPEG 或 PNG 文件格式。

根据图像的大小和文件类型,您需要为图标指定以下名称之一:

图标-128×128.jpg

图标-128×128.png

图标-256×256.jpg

图标-256×256.png

截图

您可以添加任意数量的屏幕截图。这些屏幕截图应列在您的 readme.txt 文件中的屏幕截图说明中。

截图文件应该这样命名:

截图-1.png

截图-2.png

准备好所有艺术品后,您可以将它们放入插件本地副本的assets 文件夹中。

之后,您会注意到资产文件夹旁边有一个问号图标。您需要单击“添加”按钮将新资产文件添加到您的存储库中。

添加资产

最后,继续并单击提交图标将您的文件上传到 WordPress 插件目录。一段时间后,您将能够看到艺术品出现在您的插件页面上。

提交更改

我们希望本教程能帮助您了解如何将插件添加到 WordPress 插件目录。

您可能还想学习创建电子邮件通讯的正确方法,或查看我们挑选的WordPress 用户认为有用的必备插件。