wp-plugin-directory-guidelines

概述

WordPress.org 插件目录 18 条指南的权威参考。涵盖 GPL 许可、插件命名和商标规则、试用软件限制以及所有其他提交要求。

适用场景

在以下情况下使用此技能：

• 检查 WordPress 插件是否符合 WordPress.org 插件目录指南
• 检查插件或其捆绑库的 GPL 许可证兼容性
• 验证插件文件中的许可证标头
• 在提交前识别常见的指南违规
• 回答有关 WordPress.org 上哪些内容允许或不允许的问题
• 评估高级版/升级销售流程、许可证检查或免费增值定位
• 检查“预告”或“预览”界面是否违反试用软件规定
• 使用 Plugin Check 验证插件变更，并结合上下文评估错误或警告

所需输入

• 插件源代码（或要检查的特定文件）
• 可选：用于命名和许可证检查的插件 readme 和插件标头元数据
• 自动化验证所需内容：目标插件 slug/路径、本地 WordPress 环境和命令运行器、可用测试，以及任务是否授权修复还是仅限检查

流程

根据请求确定检查范围。概念性的许可或命名问题不需要 WordPress 安装或完整审计。

1. 根据下方的 有效许可证标头 部分检查插件的许可证标头。
2. 按照 18 条指南 清单逐项检查，尤其关注指南 1、4、5、7、8 和 17。
3. 根据 guideline-review-checklist.md（指南 5 部分）中的清单确认试用软件/免费增值模式是否合规。
4. 对于捆绑的第三方代码，根据下方的 GPL 兼容许可证（速查） 检查许可证兼容性。
5. 标记下方 常见 GPL 违规（速查） 中列出的匹配项。
6. 对于边缘情况，请查阅详细参考资料和 GNU GPL FAQ。
7. 对于源代码检查或变更后的验证，请加载 Plugin Check 验证：测试、检查、评估结果、应用已授权的修复并重新测试。该文件包含命令、报告要求和故障排查说明。

验证

• 根据下方的许可、命名或 Plugin Check 报告指南，为每项结论提供证据。区分人工检查、已执行的检查和建议的后续步骤。

故障模式/调试

• 如果无法进行自动化验证，请继续人工检查，并采用 Plugin Check 验证 中的先决条件和覆盖范围备选方案。绝不要将未执行的检查报告为已通过。

升级处理

使用官方 Plugin Check 文档了解工具行为，使用目录指南了解政策。将尚未解决的政策歧义、不确定的发现以及超出授权范围的修复交由人工审核。

18 条指南检查清单

使用 guideline-review-checklist.md 中按指南划分的详细检查清单。仅在请求完整指南审计时加载此参考文件。

GPL 合规性（指南 1 详解）

如需完整的许可证表、兼容性细节和示例，请使用 gpl-compliance.md。将本节作为快速判断参考。

验证（许可）

• 每个与许可相关的问题都必须注明 指南 1，并包含文件路径和准确的许可证字符串。
• 根据 GPL 兼容许可证（速查） 确认兼容性声明；遇到有歧义的许可证时应升级处理。
• 建议更正标头时，请提供下方示例中的字面值 License: 和 License URI:。通过链接到 gpl-compliance.md 说明兼容性依据；不要只建议添加匹配的 URI。

失败模式（许可）

• 如果许可证是否与 GPL 兼容并不明确，请勿猜测。请查阅 GNU 许可证列表。
• 对于双重许可的软件包，请核实两种许可证及其再分发条款。

快速参考：WordPress GPL 要求

• WordPress 使用 GPLv2 或更高版本。
• 在 WordPress.org 上分发的插件必须 100% 与 GPL 兼容（包括代码和资源）。
• 在主插件文件中包含有效的 License: 标头和 License URI:。
• 不得添加与 GPL 所保障的自由相冲突的限制。

有效的许可证标头

GPL 版本概览

版本	年份	主要新增内容
GPLv1	1989	基础 Copyleft：修改后须以相同方式共享
GPLv2	1991	“不自由毋宁死”条款（第 7 节），更明确的分发条款
GPLv3	2007	禁止 Tivoization，明确授予专利权，兼容性条款

WordPress 使用 GPLv2 或更高版本，也就是说，插件可以使用 GPLv2、GPLv3 或“GPLv2 或更高版本”。

如需查看完整许可证文本，请参阅：

• GNU 通用公共许可证 v1
• GNU 通用公共许可证 v2
• GNU 通用公共许可证 v3

许可证合规检查清单

审核插件时，请核实：

• 主插件文件包含有效的 License: 标头（例如，GPL-2.0-or-later、GPL-2.0+、GPLv2 or later）
• 主插件文件包含指向 GPL 文本的 License URI: 标头
• 如果包含捆绑库，每个库都具有与 GPL 兼容的许可证
• 不存在“拆分许可”（例如，代码采用 GPL 许可，但高级功能为专有）
• 不存在超出 GPL 允许范围的额外限制
• 不存在限制商业使用、修改或再分发的条款
• 不存在混淆代码（这违背了提供源代码的原则）

WordPress 插件的有效许可证标头

License: GPL-2.0-or-later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

License: GPL-3.0-or-later
License URI: https://www.gnu.org/licenses/gpl-3.0.html

License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

与 GPL 兼容的许可证（速查）

• 安全的默认选项：GPL-2.0-or-later、GPL-3.0-or-later。
• 常见且通常被接受的宽松许可证系列：MIT/Expat、BSD、ISC、zlib、Boost。
• 有条件兼容的许可证需要谨慎处理：Apache-2.0 和 MPL-2.0（请核实具体使用情境）。
• 如需查看完整的接受和拒绝标识符，请使用 gpl-compliance.md。

常见 GPL 违规行为（速查）

• 以拆分许可限制所分发的代码。
• 分发混淆代码或与实际代码不对应的源代码。
• 设有限制性条款（禁止商业用途、禁止转售、强制添加反向链接）。
• 捆绑与 GPL 不兼容的库或资源。

插件命名规则（指南 17）

完整的商标列表、禁用 slug 和命名示例请参阅 naming-rules.md。此处的内联检查清单仅供快速筛查。

审核命名时，请引用指南 17，说明适用的商标规则或禁用 slug 规则，并链接至参考资料。提出替代名称时，请同时提供名称和 slug，并明确核实其使用小写字母、以连字符分隔且不超过 50 个字符。

命名检查清单（速查）

• 名称不是占位符，且至少包含 5 个字母或数字。
• 标头中的名称与 readme 中的名称一致。
• 名称具体且与功能相关；避免堆砌关键词。
• 商标或项目名称仅出现在 for、with、using、and 等连接词之后。
• 不包含禁用或不建议使用的词语，也不包含由商标拼接而成的词语。
• Slug 使用小写字母、以连字符分隔，长度不超过 50 个字符，且不包含禁用词语。