WordPress 插件开发手册

title: "插件开发者常见问题解答" post_status: publish comment_status: open taxonomy: category: - developer-plugins-handbook post_tag: - Plugin Developer Faq - Wordpress Org - Repos

插件开发者常见问题解答

托管 WordPress 插件涉及诸多细节。在寻求帮助前，请花点时间查看您的问题是否已在此得到解答。

[info]最后更新：2024 年 8 月 25 日[/info]

插件团队

如何联系插件团队？

您可以通过电子邮件 plugins@wordpress.org 联系我们——我们会在 7 个工作日内回复所有邮件。

我可以加入团队吗？

请查看此手册页面。

提交与审核

在哪里提交我的插件？

请前往添加页面并上传您的文件。您应确保：

我们不接受占位符或尚未准备就绪的插件。

如果我的插件超过 10 兆怎么办？

请仔细检查是否包含了未使用的文件（如测试文件夹、文档以及完整的 node/vendor 文件夹）。大多数遇到此问题的插件都包含了各种不应出现在最终代码中的开发内容。

提交后会发生什么？

您将立即收到一封自动邮件，告知提交情况。您的插件将进入队列，一旦我们开始处理，便会手动下载并审核代码。如果安全性、文档或展示方面没有问题，您的插件将被批准。如果发现问题，您将收到第二封邮件，详细说明需要修复的内容。

我的插件固定链接（slug）会是什么？

提交插件后，您将收到一封自动邮件，告知您插件 slug 的命名。该名称基于您主插件文件（包含插件头部信息）中的“插件名称”字段自动生成。

例如：

如果已有同名或同 slug 的插件存在，提交时您会收到警告。

该 slug 还将决定以下内容：

插件一经批准，此名称无法更改。请谨慎选择。

为什么我得到的短链接与告知的不同？

如果我们必须更改您的固定链接（短链接），我们总会通过电子邮件向您解释原因。通常，我们会在您有明显拼写错误或错误（例如将 founder 写成 foundre）或与现有商标或其他插件冲突时更改您的固定链接。请务必仔细阅读您的审核邮件，因为我们确实会解释我们这样做的原因。

为什么我的提交失败，提示插件名称已存在？

出现这种情况有两个原因：

  1. 您尝试使用的插件固定链接已在 WordPress.org 上存在
  2. 您尝试使用的插件固定链接在 WordPress.org 之外 存在且拥有大量用户群

第一种情况显而易见。您不能拥有两个相同固定链接的插件，因此需要选择一个新的。

第二种情况令人困惑，因为它提示您该固定链接在 WordPress.org 之外的某个地方已被使用。需要理解的是，插件更新 API 的工作方式是将插件文件夹名称（即固定链接）与 WordPress.org 上托管的每个插件进行比较。如果匹配，则会检查更新并提示用户升级。

当这种情况发生时，“原始”插件（我们未托管的那个）的用户将升级到 WordPress.org 上的版本，如果这不是您实际想要的操作，可能会破坏他们的网站。

有时，当公司或个人私下发布插件（例如通过 Github）并决定在 WordPress.org 上重新发布时，会出现这种情况。在这些情况下，我们建议您通过电子邮件联系我们，我们将指导您如何解决此错误。

为什么我会收到错误提示，说我的插件名称不能以某个术语开头？

该错误提示是为了告知您，您的插件显示名称不能以他人的商标术语开头。这是为了保护您和插件目录免受商标滥用相关的法律问题。要解决此问题，您必须更改插件 readme 文件和主 PHP 文件中的显示名称。

请不要试图通过巧妙重命名插件（例如 WooCommerce 改为 WuuCommerce）来“规避”此限制。这样做只会让我们担心您将来可能无法遵守指南。

为什么我会收到错误提示，说不能在插件名称中完全使用某个术语？

部分商标持有者要求我们不再允许在插件名称中完全使用特定术语。若您看到此错误，则必须从插件名称中移除该术语。

要继续提交，您必须完全移除主插件文件和 readme 中 Plugin Name: 行内的 "[TERM]"。

若您试图通过将术语从 'Facerange' 改为 'Face-Range' 来规避此限制，我们将暂停您的提交并重申您不能使用该术语。请不要试图耍小聪明或取巧来绕过此限制。

如何提交官方插件？

请使用官方组织用户账户登录，并仅通过该账户提交。

我们如何确认您是官方组织？主要通过您的电子邮箱地址进行验证。

我们无法接受以个人开发者账户名义提交的代表组织的插件，除非这些账户也明确属于公司。例如，使用带有 Gmail 地址的用户提交官方插件，很可能会因商标侵权被标记。

如果我提交插件时使用了错误的用户 ID 怎么办？

请立即回复邮件告知我们。我们可以为您转移所有权。如果您忘记这样做，可以自行修复：将正确的账户添加为提交者，然后让该账户移除您自己的权限。

请勿重新提交您的插件。只需立即告知我们，我们会为您解决。

插件审核需要多长时间？

由于每个插件都不同，因此没有官方的平均审核时间。如果您的插件规模较小且代码完全正确，通常会在十四天内完成_初步审核_。

如果您的插件存在代码问题，审核时间将取决于您修正问题所需的时间。无论哪种情况，您都_会_收到来自 plugins@wordpress.org 的邮件通知审核状态，请务必将该邮箱加入白名单并耐心等待我们的回复。

我已提交修复但无人回复。我应该等待多久？

我们力求在十个（10）工作日内回复所有审核。如果时间未到，那只是因为我们最近非常忙碌。如果只过了两天，比如跨越周末或假期，那么你合理来说不应期待回复。

请记住，审核团队完全由志愿者组成，他们都有全职工作和其他志愿职责。我们会及时回复，但我们在 WordPress 之外也有自己的生活。

如果我的插件出现问题，我需要多长时间来修复？

没有具体时间限制，只要我们知晓您正在处理且认为您有所进展，审核就会保持开放状态。插件将在 3 个月后被拒绝，但审核通道仍会保留。

为什么我的插件在三个月后被拒绝了？

如果您的插件审核在三个月后仍未完成，我们将拒绝您的提交以保持队列的可管理性。在任何时间点，我们都有超过 500 人处于审核中期，我们认为三个月是一个相当合理的时间范围。

我的插件终于修复好了，需要重新提交吗？

若插件因三个月未回应而被拒，请重新提交并回复邮件告知我们您希望继续之前未完成的审核。即使已过去 18 个月也没关系——目前最长记录是 3 年。我们完全理解修复需要时间。

但请注意：若插件因其他原因被拒，请勿重新提交，直接回复原邮件即可。

我一次可以提交多少个插件进行审核？

通常只能提交一个。如果您是拥有超过一百万活跃插件安装量的插件作者，我们理解您有更多正在进行的项目，因此您将有不同的限制，最多可以同时提交 10 个插件。

为何不能同时提交多个插件？

实践证明，允许用户同时提交多个插件会对审核流程产生不利影响。经常在所有插件中发现错误，导致相同的邮件被多次发送。此外，用户常常混淆正在处理的审核任务，使待解决问题变得模糊不清。改为一次只处理一个插件后，这类混淆情况显著减少。

此外，许多新用户不了解如何使用 SVN，最终提交了多个插件却从未使用过任何一个。这会消耗我们的资源，因此我们确实需要限制用户。

由于所有插件都会在四周内完成初步审核，这不应造成太大困难。

我可以用多个账户提交多个插件吗？

不可以。如果这样做，我们将暂停您的所有次要账户。请不要试图规避一次只能提交一个的规则。

我需要我的插件在特定日期前获得批准，该怎么办？

请尽早提交。除非插件旨在解决安全或法律问题，否则我们不允许插队。如果确实涉及此类问题，请发送邮件至 plugins@wordpress.org 并说明情况。

有哪些具体事项需要避免？

我们关注一些相当明显的问题，所有这些都在我们的指南中列出。大多数可以概括为"不要成为垃圾信息发送者"，但这里重点提及最常见的几种情况：

再次强调，这只是简要概述。请务必阅读完整指南，因为详细清单非常全面。

有哪些插件不被接受？

我们不接受那些“毫无功能”、非法或助长不良行为的插件。这包括黑帽SEO垃圾插件、内容伪原创工具、仇恨插件等。

同样，我们也不接受框架插件或库插件。如果你的插件必须依赖其他插件或主题进行自我修改才能使用，那么它就是一个库。如果你的插件是一个模板，通过直接定制文件可以构建更多代码，那么它就是一个框架或样板。框架和库应该与每个插件一起打包（最好以不与其他使用该框架或库的插件冲突的方式）。至少在核心支持插件依赖之前如此。

我们也不接受完全复制他人作品的插件，或重复WordPress核心功能的插件。基本上，你的插件应该提供新功能、新方法，或解决特定问题。

我想重做、升级或重塑现有插件。直接重新提交就行了吧？

不行，你应该重写并升级现有插件，将其作为主要版本发布。我们无法重命名插件或转移用户，因此新插件不会继承任何现有用户、评论、支持话题、评分、下载量、收藏等。基本上，你会让所有现有用户陷入困境，这很不友好。

我提交时出了错，该如何修正？

您随时可以在提交页面更新您的插件文件。

提交后，您可以修改一次插件别名。

每次提交后都会收到一封包含指引的自动邮件。如果您遇到其他问题，请回复该邮件或发送邮件至 plugins@wordpress.org 说明情况。

关于插件别名，如需进一步修改，您需要联系我们。我们也会在审核前尽量检查名称中的拼写错误，但我们也难免会有疏漏。

插件名称有哪些限制？

我们有以下规定：

我们鼓励大家发挥创意，构思独特的别名。对于任何使用不可接受别名的插件，我们将自动进行修正。若对最佳选择存有疑问，我们会与您联系确认。

使用 SVN 仓库

我应该把文件放在哪里？

请将您的代码文件直接放在仓库的 trunk/ 目录中。每当您发布新版本时，请通过将当前主干修订版复制到 tags/ 目录的新子目录中来标记该版本。

请确保更新 trunk/readme.txt 以反映新的稳定版本标签。

自述文件所需的图片（例如截图、插件标题和插件图标）应放在您 SVN 检出根目录下的 assets/ 目录中（您可能需要创建此目录）。例如，该目录将与 tags/ 和 trunk/ 处于同一层级。

我能否将文件放在 trunk/ 的子目录中？

不可以。这样做会导致 zip 生成器失效。

如果你的插件结构复杂、文件众多，当然可以将它们组织到子目录中，但 readme.txt 文件 和主插件文件应直接放在 trunk/ 目录下。

如何命名我的标签（即发布版本）？

您的 Subversion 标签应看起来像版本号。具体来说，它们应仅包含数字和句点。2.8.4 是一个好看的标签，my neato releaso 则是一个难看的标签。我们建议您使用语义化版本控制来跟踪发布版本，但我们并不强制执行此规则。

请注意，这里讨论的是 Subversion 标签，而非 readme.txt 搜索类型的标签。

我应该在 SVN 中保留多少个旧版本？

越少越好。几乎没有人需要你发布仓库中的旧代码。记住，SVN 不是用来进行代码版本控制的。你可以使用 Github 来处理这类事情。SVN 应该只存放你当前的发布版本，你不需要保留所有旧版本的所有次要发布。只保留每个旧版本的最后一到两个版本就足够了。

我可以在插件中包含 SVN 外部引用吗？

不可以。您可以将 svn externals 添加到您的代码仓库中，但它们不会被添加到可下载的 zip 文件中。

我可以在插件中放入压缩包和其他压缩文件吗？

不可以。

我可以包含压缩后的 JS 文件吗？

可以！但您必须在插件中保留未压缩版本，或者通过自述文件告知用户何处可以获取未压缩文件。

允许压缩代码，但禁止隐藏代码。所有提交至此目录的代码都必须具备人工可读性。

您的 WordPress.Org 页面

我的插件何时“上线”？

一旦您将代码推送到 SVN 文件夹，您的插件就会上线。请勿在未准备好时推送代码，因为除了关闭插件外，没有“关闭”开关。由于关闭插件是永久性的，我们建议您在准备好上线之前不要推送代码。

WordPress.org 插件目录的数据来源是什么？

数据来源于您在插件文件和 readme.txt 文件中指定的信息，以及 Subversion 代码库本身。请阅读关于 readme.txt 如何工作以获取更多信息。

您还应充分利用主插件文件中的插件头部信息。这些信息将定义您的用户名在 WordPress.org 托管页面以及 WordPress 管理后台中的显示方式。我们建议使用所有这些头部信息来完整记录您的插件。

我能否指定 WordPress.org 插件目录应使用哪个版本的插件？

可以，通过在主干目录的 readme.txt 文件中指定 Stable Tag 字段即可。

我们要求您不要使用 'trunk' 作为稳定标签，因为这会使回滚操作变得比实际需要更复杂。

"Tested Up To" 值应设为哪个 WordPress 版本？

理论上，应填写你实际测试过的最高版本。但切勿超过当前的候选发布版。若无候选版，则不超过当前活跃版本。例如，若 WordPress 稳定版为 6.0.9，你可填写 6.0 至 6.0.9 之间的任何版本。若存在 6.1-RC 候选版，则可填写 6.1，但绝不可超过此版本。

切勿自作聪明填写 6.5 或 7 等未来版本，这将导致页面报错。

每次更新自述文件都需要发布插件新版本吗？

不需要。如果只是对自述文件或图标/标题进行外观调整，您无需发布新版本。只需确保更新 trunk 和 tag 文件夹即可。

每次更新代码都需要发布新版本吗？

是的。否则用户无法获取更新。

更新日志应包含哪些内容？

更新日志是记录插件所有或重大变更的文档，包括错误修复、新增功能等变更记录。如需更新日志格式指导，我们推荐使用 Keep A Changelog 格式，这是目前众多产品采用的通用格式。

应在更新日志中保留多少个版本？

始终在更新日志中保留当前主要版本。例如，若当前版本为 3.9.1，则需保留 3.9.1 和 3.9 版本。旧版本应移除并迁移至 changelog.txt 文件，这样既方便用户查阅，又能保持自述文件简洁相关。最多在自述文件的更新日志中保留插件的最新版本及上一个主要版本。changelog.txt 文件不会在 WordPress.org 插件目录中显示，但这并无大碍，因为多数用户仅关注最新动态。

如何在插件描述页面中嵌入视频？

对于 YouTube 和 Vimeo 视频，只需在描述中单独一行粘贴视频链接。请注意，视频必须设置为允许嵌入才能生效。对于 WordPress.com VideoPress 服务托管的视频，请使用 [wpvideo] 短代码。如有需要，短代码也可用于 YouTube 和 Vimeo 视频，就像在 WordPress 中一样。

为什么我的插件显示未在最新 WordPress 版本中测试？

当您在 readme 文件中未正确设置 'Tested Up To' 值时会出现此情况。该值应为您测试插件时所用的最新 WordPress 版本。若当前最新 主 版本为 4.9，则应填写 4.9 以表明兼容性。次版本更新无需修改（若您的 readme 兼容 4.9，则自动涵盖 4.9 至 4.9.1000 的所有版本）。

请注意，若填写未发布的 WordPress 版本（如 6.0），同样会显示此提示信息。

插件目录需要多长时间才能反映我的更改？

WordPress.org 插件目录每隔几分钟更新一次。但根据更新队列的大小，您的更改可能需要更长时间才能显示。请至少等待 6 小时 再联系我们。

如何为我的插件页面制作一个酷炫的横幅？

您可以通过将正确命名的文件上传到 assets 文件夹来制作自己的插件头部横幅。阅读关于插件头部横幅以获取更多信息。

如何制作插件图标？

您可以通过将正确命名的文件上传到 assets 文件夹来制作自己的插件图标。如需更多信息，请阅读关于插件图标的说明。

我可以在插件横幅/图标中使用官方徽标吗？

通常不可以。

你的插件图标绝不应直接使用未经修改的官方徽标（例如 Facerange 的徽标），这将侵犯其知识产权。你不可以在横幅或图标中使用官方徽标进行品牌宣传。即使你在自己的网站上获得了使用许可，我们在此处也并未获得相应授权。

与插件命名类似，我们建议你的图标和横幅设计应具有独特性。独特的设计往往更容易让人记住。

我可以在自述文件中使用多少个标签？

根据指南，插件在其自述文件中最多只能使用 12 个标签。这是为了控制垃圾信息。也就是说，出于同样的原因，只有前 五个 标签会在 WordPress.org 上显示。前 12 个标签用于搜索，其余标签将被忽略，因此堆砌标签对你毫无帮助。

此外，任何只有你一个人使用的标签都不会显示，因为它们无助于他人找到另一个类似的插件。

插件名称

插件审核通过后能否更改名称？

可以，但有限制。您可以更改显示名称，但插件审核通过后，其 slug（即插件 URL 中属于您的那部分）无法更改。这就是为什么我们在提交过程中多次提醒您。

要更改显示名称，请编辑您的主插件文件，将 "Plugin Name:" 的值更改为新名称。同时建议您同步更新 readme.txt 文件中的标题以保持一致。

为什么我不能使用他人的商标/品牌作为插件名称？

简而言之，因为你不是他们。

如果你为 BooCommerce 编写了一个附加插件，你不能将其命名为 "BooCommerce Improved Product Search"，因为这会生成 slug boocommerce-improved-product-search，从而与 'BooCommerce' 的商标冲突。不过，提交名称 "Boo Improved Product Search" 是可以接受的，它将使用 slug bc-improved-product-search（"bc" 未被注册商标）。

再举一个例子，如果你有一个插件，将某项服务与一家名为 Amazorn 的流行云托管公司集成，你可以将其命名为 "My Service Integration for Amazorn"，但不能使用 "Amazorn – My Service Integration"。

考虑现实中的 Keurig 例子。如果你制作了一个环保的冲泡杯，你可以将其营销为 "EcoBrew Pod for Keurig"，但不能尝试将其营销为 "Keurig EcoBrew Pod"。后者暗示与 Keurig 有直接关系，在某些国家实际上是违法的。为了保护你，我们需要你在使用知名品牌名称和商标时谨慎行事。宁可过于谨慎；如果他们来找我们，要求关闭你的插件，因为你在显示名称中首先使用了他们的术语，我们必须照做。

注意：我们不再允许新插件在其固定链接中使用 woo 开头，而是必须强制使用 wc。

公司能否授权我在永久链接中使用其商标？

不能。

尽管我们理解公司可以也确实会授予使用许可，但我们出于一个非常重要的原因不接受将其用于永久链接：一旦插件通过审核，我们 无法 更改您的永久链接。这意味着，如果公司后来改变主意并撤销许可，该插件将被关闭，所有用户都将被放弃。

为了前瞻性地确保插件在目录中的长期存续，我们不接受“许可”。除非是官方所有者，否则永久链接不得以商标（或广为人知的品牌/术语）开头。

能否更改插件的 URL/别名？

插件一经批准，其 URL 便无法更改，我们在审核流程中已通过多处提醒告知此事。

因此，我们拒绝大多数仅为了获得更好别名而提交的“新”插件替换旧插件的请求。

这是因为我们无法在插件之间迁移用户，也无法重定向流量。这意味着，提交新插件来更改别名将对插件的 SEO 和声誉造成极大损害，因为用户将被遗弃。大多数插件实际上并不需要新的 URL，而只是希望编辑其显示名称。

除非您的别名存在严重拼写错误、语言问题或法律问题，否则我们不太可能批准新的别名。如果我们确实批准了，我们将标记您的账户，注明未来更名请求将被拒绝。

如何更改插件的显示名称？

您需要在自述文件 和 插件主文件中进行更改。

显示名称可以随意设置吗？

请勿使用粗俗、侮辱性或任何蓄意冒犯的语言。若非官方来源，不得声称或看似声称自己是官方。例如，如果您开发了一个连接 Frozbaz 服务的插件，应将其命名为“Frozbaz 服务连接器”——这样能明确表明您是为该服务开发插件，而非代表服务本身。

若整合多项服务（例如为热门电商插件添加支付网关），我们强烈建议您构思一个原创且独特的显示名称。

我可以在展示名称中使用 WordPress 或 Plugin 吗？

目前可以，但不建议这样做。这完全是多余的，对 SEO 没有任何实际帮助。我们已经在页面标题中包含了 WordPress 和 Plugin。

我应该在插件名称中使用商标或注册符号吗？

假设您确实申请了商标，您当然可以这样做，但这并不常见。即使是谷歌或脸书也不这样做。只要使用您的商标术语并保留相关记录（如您的 SVN 日志），您通常就完成了保护品牌所需的法律行动。具体细节请咨询律师。

搜索

我的插件需要多久才能在搜索结果中显示？

通常插件提交到 SVN 后需要 6 到 14 天。这是因为我们需要添加您的数据、解析数据，并将其分发到我们所有高度缓存的服务器上。这个过程不是即时完成的。此外，作为新插件，我们没有使用数据，因此您可能需要等待一段时间。

如何提高排名？

为语言编写一份优秀的自述文件，及时回复支持帖子，获得好评。

我的 URL 和显示名称哪个权重更高？

两者都不。为了让效果最大化，请让你的显示名称令人难忘且具有描述性，同时保持在 5 个词以内。

支持论坛

如何获取论坛帖子通知？

访问 https://wordpress.org/support/plugin/YOURPLUGIN 并查看右侧边栏。点击“订阅此插件”按钮即可接收邮件提醒。

如何获取所有插件的通知？

每个插件支持论坛页面顶部都有一个"订阅"按钮。点击该按钮后，您将通过电子邮件接收通知。您可以在 https://wordpress.org/support/users/YOURID/subscriptions 查看已订阅的插件论坛。

对于 RSS 订阅，访问 https://wordpress.org/support/view/plugin-committer/YOURID 将列出您拥有提交权限的所有插件的支持请求和评论。如果您不是提交者，只是被列为作者？请使用 https://wordpress.org/support/view/plugin-contributor/YOURID

您还可以访问 https://profiles.wordpress.org/YOURID/profile/notifications/ 并设置任何您希望通过电子邮件接收通知的关键词。请注意，如果使用通用关键词，可能会导致通知过多。

如何为支持账户授予插件访问权限？

您可以将支持代表添加到您的插件中。支持代表可以将论坛主题标记为已解决或置顶（与插件作者和贡献者权限相同），但无权提交代码到插件库。

管理插件支持代表的界面位于插件页面的“高级视图”中，紧邻代码提交者管理功能。当某人被添加为支持代表后，他们在回复插件支持主题或评论时将获得“插件支持”徽章。

你们会删除针对我插件的差评或负面评论吗？

通常不会。评论反映了用户对您产品的使用体验。如果他们不喜欢，我们无权更改。如果您认为某条评论无效（例如针对其他插件），请使用帖子上的 modlook 按钮。论坛团队的一名成员将进行调查。

滥用 modlook 功能可能导致您的插件被暂停。请明智使用此功能。

什么是“马甲账号”？

当有人在论坛上创建多个账户时，通常是为了给自己刷五星好评，或制造虚假支持工单以显得响应迅速。马甲行为违反我们的准则，将导致评论和帖子被删除，也可能导致您的账户和所有插件被移除。请勿这样做，也不要公然指责他人这样做。

已关闭插件

如何关闭我的插件？

自 2020 年 4 月起，您可以随时关闭自己的插件。为此，请转到插件页面上的 高级 选项卡（即 https://wordpress.org/plugins/myplugin/advanced/），然后向下滚动到 关闭此插件 部分。您将在此处看到一条警告信息和一个按钮。

“关闭此插件”功能的图片，附有说明：“警告：关闭插件是一项旨在永久生效的操作。您将无法在不联系插件团队的情况下重新打开它。”下方是一个写着“我明白了”的按钮。

如果您同意警告并希望关闭插件，请按下该按钮。

请记住，除非您能证明您的情况合理，否则您的插件将不会被恢复。根据请求关闭插件旨在成为永久性操作。

如果我意外关闭了插件怎么办？

请发送邮件至 plugins@wordpress.org 并请求重新开放您的插件。不过，我们可能会询问您是如何操作的，以便我们改进该功能。

为什么无法关闭我自己的插件？

假设您已使用正确的账户登录，这很可能是因为您的插件用户数量过多。如果插件用户超过 10,000 名，您需要发送邮件至 plugins@wordpress.org 并请求我们协助关闭。

我可以暂时关闭我的插件吗？

不可以。

我们不允许这样做，因为这会给用户带来糟糕的体验。隐藏插件会让用户认为该插件因安全或准则问题而被下架，从而导致他们不再信任你。我们无法阻止他们的想法，因此我们禁止“暂时”关闭。

通常人们希望在插件存在正在修复的错误或无法提供支持时这样做。我们建议你尽快修复错误，或者如果你无法支持该插件，请更新自述文件，说明其目前不受支持及原因。

如果这是一个全新的插件，你应该将其称为“公开测试版”，以便人们了解其状态。

插件关闭后会发生什么？

当插件被关闭时，页面将显示为关闭状态，并且不再生成压缩包。用户将无法通过网站下载该插件，也无法通过 WordPress 管理后台进行安装。根据目录原则，SVN 代码库将保持可访问状态，以便其他人按需下载和分叉代码。

60 天后，关闭信息将更新为提示关闭原因，但仅以最宽泛的术语（如违反准则、安全问题等）说明，不会提供具体细节。

为什么我的插件被关闭了？

插件可能因违反准则、存在安全问题或作者主动要求而被关闭。若涉及侵权、滥用或安全等活跃问题，所有对该插件拥有提交权限的账户都会收到通知。

如果插件在 6 个月内从未被使用（即未向 SVN 推送任何代码）、SVN 损坏超过 12 个月，或插件自述文件显示其已弃用，我们可能在不通知的情况下关闭插件。

为何他人的插件被关闭？

自 2017 年起，插件关闭原因已在插件数据库中记录。插件关闭六十天后，关闭原因将对外公开：

已关闭插件示例，原因为“作者要求”

请注意：我们不会公开披露插件被关闭的具体细节。

我能让他人的插件被关闭吗？

如果您向 plugins@wordpress.org 报告插件中的安全问题或准则违规，我们将进行审查并采取适当措施。大多数情况下，这会导致插件被关闭。除非您主动要求，否则您的姓名不会被公开，以保护您免受反弹影响。

有人发布了我的插件副本！我该怎么办？

请发送邮件至 plugins@wordpress.org，并提供被盗插件的链接。同时，请附上您自己插件的下载链接或直接附上 zip 文件。我们将对比两个文件以及我们拥有的所有编码历史记录，以确定该插件是否确实属于盗窃行为，或者仅仅是一个未注明来源的分支。

请注意，如果您将插件授权为 GPLv2 或更高版本，那么只要版权信息保持不变且您被署名，他人分支您的作品是完全允许的。

如果有人复制了我的代码但未注明出处，我该怎么办？

请立即发送邮件至 plugins@wordpress.org！特别是当你的代码采用非 GPL 许可证时。虽然我们允许他人分叉其他插件并将其代码纳入自己的插件中，但必须始终注明来源。版权归属和出处声明是强制要求。

你们是否会因品牌/商标侵权而关闭其他插件？

我们尽力维护版权和商标要求，并防止品牌混淆。在插件获得批准前，我们通常要求开发者对一些较为明显的部分进行修改。然而，考虑到目录中有 60,000 个插件，且某些术语相当常见（如“popup”或“all-in-one”），URL 或名称的“差异”程度是有限的。因此，我们要求开发者更改插件的显示名称，以避免冲突或混淆。

如果有人明显侵犯了您的版权、商标或现有品牌，无论是通过显示名称还是使用受商标保护的图像，请发送邮件至 plugins@wordpress.org 并提供相关证据，我们将联系开发者并要求其进行修改。

我们期望这些请求是合理的。也就是说，如果您向我们投诉并列出 12 个使用“最佳联系表单”这一术语的插件，仅仅因为这是您插件的名称，我们将审查这些插件，并仅在它们过度使用该短语时才会关闭它们。如果它们仅使用一次（例如“这是法罗群岛的最佳联系表单插件”），则是可以接受的。如果它们进行关键词堆砌，我们更可能因关键词堆砌而关闭它们。简而言之，如果您的插件名称非常通用，这种情况很常见，通常不构成侵权案件。

另外请注意，如果这不是您的商标，我们无法接受您的报告。管理和维护商标是商标所有者的责任，而非其用户的责任。

如何提交安全报告？

请将清晰简洁的问题描述发送至 plugins@wordpress.org 邮箱。详情请阅读我们关于报告安全问题的文档。

你们是否为插件漏洞发现提供赏金？

不提供。我们与任何漏洞赏金计划均无关联，因此不会将您的报告提交给他们。我们唯一合作的平台是 hackerone.com/automattic，且仅限与 Automattic 资产相关的漏洞。其他所有情况请自行处理，请勿要求我们代为提交。

你们是否协助提交或提供 CVE？

不。我们没有能力协助处理 CVE。

我的插件被关闭了，可以重新开放吗？

也许可以。如果是因为安全问题被关闭，请修复问题并回复邮件，大多数情况下我们会重新开放插件，除非它存在更多安全问题或严重的准则问题。如果是因为违反准则被关闭，这取决于违规的严重性和性质。例如，重复违规者比初犯者更不可能重新开放插件。

如果你主动要求关闭插件，需要解释为何改变主意。当开发者请求关闭插件时，插件应保持关闭状态，而不是一个月后又重新开放。

所有插件都必须通过当前的标准和安全审查才能恢复。这是强制要求。多次关闭插件会让用户对你失去更多信任，不如一次性彻底解决所有潜在问题，即使关闭时间更长。

为什么我的插件因员工/同事违反规定而被关闭？

从技术支持到开发者，所有代表插件的人员都由插件所有者负责。如果他们严重违反规定，所有者应承担相应后果并纠正行为。若未能做到这一点，插件将被关闭。我们会通知插件所有者并解释原因，同时尽力保持插件开放。

我的所有插件都被关闭了！如何恢复？

我们极少会关闭开发者所有的插件。通常发生这种情况是由于以下原因：

  1. 您要求我们关闭您的所有插件
  2. 电子邮件问题
    1. 邮件被退回，我们无法联系到您
    2. 邮件发送了自动回复，且我们至少发送了两次警告要求修复
  3. 准则问题
    1. 之前因行为问题受到过谴责和/或收到最终警告
    2. 向目录和/或志愿者发出法律威胁
    3. 违规行为被视为"极其恶劣"（死亡威胁、大量傀儡账号、骚扰等）

如果您要求我们关闭插件，您需要解释为何改变主意。

如果您遇到电子邮件问题，您必须解决这些问题，并且需要将您的所有插件更新到当前的安全和准则标准。

至于最后一种情况……通常您无法恢复。如果我们因您的行为向您发出最终警告，并且在不到一年的时间内，您再次出现同样的问题（或未能解决我们提到的所有问题），我们将不会重新开放您的插件。

我刚刚收到了最终警告，该怎么办？

首先，请认真对待此事。邮件会详细列出存在的问题以及我们决定升级为最终警告的原因。插件所有者需要解决所有问题，停止违反新规定，并密切监控所有协作者的行为。简而言之，停止违反准则、停止找借口、为不当行为道歉并纠正方向。

我们最不希望做的就是封禁某人并禁用其所有插件。这对社区不利。但与此同时，如果开发者无法或不愿遵守与其他所有人相同的规则，将其保留在目录中是有害的，也是对他人不尊重的表现。

插件所有权

如何让他人访问我的插件？

要将用户添加为提交者（即授予他们更新代码的权限），请访问 https://wordpress.org/plugins/YOURPLUGIN/advanced 并将他们的用户名添加为提交者。

若希望他们显示为作者，请将其用户名添加到 readme.txt 文件中。

请勿将普通用户添加为作者。 此角色仅适用于协助开发的人员。这意味着如果有人“启发”了你，你不应将其添加为作者。

如何移除他人对我插件的访问权限？

任何拥有提交权限的人都可以执行此操作。前往 https://wordpress.org/plugins/YOURPLUGIN/advanced 并将鼠标悬停在其 ID 上。会出现一个删除链接，点击它即可。

请不要删除您自己的权限。

如何更改插件所有者？

前往“高级”选项卡并向下滚动至“危险区域”。您将在此处看到 “转移您的插件” 部分。从下拉菜单中选择接收者并点击按钮。

更多详细信息，请阅读关于转移插件的文档。

我尝试转移插件但系统提示无法操作，这是为什么？

拥有大量用户（超过 10,000 名）或被认定为 WordPress 项目核心的插件（例如精选或测试版插件）仅能通过向插件团队提交书面申请进行转移。请查阅插件转移文档了解详情。

如何接管被遗弃的插件？

我们允许用户接管当前不再开发的现有插件。

我们建议您首先尝试联系原始开发者，以便他们可以将您添加为维护者。在某些情况下，这不可行，您应该从修复插件开始。确保它符合编码标准、安全可靠，并更新版权信息以包含您自己。然后，您可以联系我们讨论插件接管事宜。

我们不保证您会被授予任何人的插件，即使审查成功也是如此。

这些购买我插件的提议可信吗？

简短回答：很可能不可信。

许多开发者会收到主动发来的电子邮件或购买他们插件的提议。我们发现绝大多数此类提议都是欺诈性的，因此不建议您跟进。

虽然确实存在合法的购买提议，但它们通常来自与插件相关的官方公司，或来自一家成熟的插件公司。那些以“我们正在联系 WordPress 社区……”或“我们正在寻求收购现有的 WordPress 插件……”开头的提议不应被信任。此类收购常常通过采用诸如跟踪用户或其他严重违反准则的卑劣手段，破坏了插件（以及原始开发者）的声誉。

如果您确实选择出售您的插件（或将其转让给他人），请确保新所有者理解代码库的所有准则。如果他们违反我们的条款，插件将被移除，并且根据违规程度，我们可能不会将其归还。任何拥有插件提交权限的人，都对其用户行为拥有所有权和责任。发送垃圾邮件、插入跟踪数据以及添加无用功能是毁掉您插件的最快方式。

我们主张只将您的插件交给您亲自审查过并且信任其能对您的代码和用户负责的人。

当插件开发者去世时会发生什么？

当确认开发者已去世时，他们将从自己的插件中被移除，以防止不道德者获取访问权限并伤害用户。如果他们是唯一的开发者，插件可能会被关闭。我们会尽力寻找他们的朋友和同事，首先给予他们接管代码的机会，但如果找不到可靠或愿意接手的人，插件将被关闭。