用途
这份 playbook 面向希望把面向自家 SaaS 服务的连接器插件上传到 WordPress.org 插件目录、通过审核并长期保持上架的厂商。它强调：审核志愿者团队驳回的原因更多来自商业模式和账号选择，而不是代码质量，例如付费功能被锁、用代理机构个人账号提交、未披露的对外请求。
审核规则要点
- 禁止试用版软件：插件内不得有被锁、置灰、限时、限额或仅沙箱可用的功能。付费价值可以放在服务端（套餐、试用、配额由服务器判定，插件只展示结果），或作为在 WordPress.org 之外销售的附加组件。用于标识账号的 API Key 可以，用于解锁本地代码的 Key 不行。
- 服务必须真实且有文档：仅验证许可证、把代码搬到服务端伪装成服务、或纯店面插件均被禁止。readme 须列明每个外部服务、发送什么数据、何时发送，以及条款和隐私链接（含自家服务）。
- 同意范围仅限服务本身：安装分析、遥测等无关功能需默认关闭并单独征得同意。
- wp-admin 中不得有远程代码：不得使用 iframe 管理页，不得从 CDN 加载与服务无关的 JS/CSS（字体除外），不得从自家服务器更新或安装，不得自建更新检查器。面向客户的挂件可在文档说明后从服务加载；后台 UI 库不属于服务，须随插件打包。
- 品牌优先名称归品牌所有者：须用公司 WordPress.org 账号和公司域名邮箱提交，slug 批准后永久不变。
- 人工联系：每位提交者需开启 2FA 并使用真人阅读的邮箱；警告后仍持续自动回复可能导致该账号名下所有插件被关闭。
- 不得添加署名或夸大声明：“Powered by” 链接默认关闭；不得暗示插件保证符合 GDPR、PCI 或 ADA，只能描述其协助内容。
常见错误理由
资料列举了若干会被驳回的辩解，例如“Pro 标签只是升级引导”（实为试用版软件）、“试用和免费配额在插件内计数”（应改为由服务端发放和计数）、“用 iframe 嵌入自家仪表盘”（违反 iframe 管理页禁令）、“代理提交后再转移”（品牌插件会因商标被标记）、“上线前两周提交即可”（无插队，队列波动大，通常需多轮审核）、“激活时 ping API 统计安装”（安装分析需选择加入）、“热修复几分钟上线”（每次发布有 6 小时冷却期并自动安全审查，高分阻塞该版本但站点保留上一版本，上架不关闭）。这些具体数字均标注需按当前 developer.wordpress.org 手册核实。
付费价值放置方案（按效率排序）
- 目录连接器，付费功能由服务端强制：一套代码、一次审核，限制由 API 返回并以服务消息展示，是 SaaS 默认方案。
- 目录插件加官网销售的付费附加组件：附加组件可自带更新器并需自己的 Plugin URI，免费插件可链接但不得安装或持有其代码；当付费功能必须在 WordPress 本地运行时才提升到这一档。
- 仅自托管 zip：无需审核但无目录搜索和核心自动更新，仅在产品需要目录禁止的能力时使用。
名称、账号与 slug 规则
插件命名：若拥有品牌，用“<你的品牌> <用途>”；否则用“<用途> for <对方品牌>”，不得以他人品牌开头。slug 不含 “wordpress” 和 “plugin”，不得以 woo 开头（用 wc）。须从公司账号提交；账号错误应回复审核邮件更正而非重新提交。确认邮件中的 slug 可在批准前改一次，之后不可改；文本域和主文件名须与最终 slug 一致。所有 header 和 readme 中的 URL 须在提交前可用，服务插件还需在线的条款和隐私页面。
提交与审核
先运行 Plugin Check，其 Plugin Repo 类别的错误会阻止上传；zip 小于 10 MB，不含开发目录。按 references/submission-packet.md 组装 readme 和提交材料。每个账号同时只能有一个插件在审，用额外账号绕过会被停用。审核邮件须在同一线程回复，并在一次上传中修复所有问题；超过 3 个月仍未完成的审核会被驳回，需重新提交后在旧线程回复继续。上线计划应从首次审核加多轮修复倒推，每轮约需 10 个工作日；新插件首次提交后 6 到 14 天出现在搜索中。若批准错过上线日期，可宣布“即将登陆 WordPress.org”。批准后应在发布前推送代码，批准后 6 个月无代码可能被关闭并重新分配名称。
发布流程
SVN 是发布通道而非代码仓库：代码在 trunk/，每个版本复制到 tags/<version>，图片在顶层 assets/。只保留最近一两个 tag。首次提交即上线，除关闭外没有开关。CI 部署使用账号独立的 SVN 密码而非登录密码。每次打 tag 前运行 Plugin Check（含 Security 类别），它也会在每次更新时运行。Stable tag 须指向真实 tag 而非 trunk；每次代码变更提升主文件 Version；仅改 readme（如 Tested up to）无需版本，除非 Release Confirmation 冻结了 tag；assets 无需版本。开启 Release Confirmation，其 24 小时延迟仅延迟自动更新（较新 WordPress 版本）。把冷却期计入事故时间线；被阻塞时修复问题并发布新版本，邮件申诉更慢。
保持在架
WordPress.org 论坛只支持免费插件，付费套餐问题引导到自家渠道；通过邮件加入 Commercial 标签可在上架页面获得支持 URL；支持人员设为 Support Representatives 而非提交者。不得索取、付费或制造评价；员工行为可能导致所有者插件被关闭。不得以“暂停”为由关闭，关闭被视为永久，重开需按现行标准完整审核；应发布修复或将 readme 标记为不支持；超过 10,000 用户时关闭或转移需向插件团队书面申请。因安全关闭：修复后通过 Plugin Check 的 Security 类别，并回复关闭邮件。
搜索排名
排名代码开源，权重随部署变化。文本匹配：标题和 slug 权重最高，其次作者和贡献者，再次摘要、描述和标签；只计前五个标签，超过 12 个按 Guideline 12 视为垃圾信息，不得使用竞品名称。乘数包括活跃安装量（对数）、已解决支持线程比例、评分，以及约六个月未更新和 Tested up to 过期后的衰减。投入顺序：瞄准长尾集成短语、解决每个论坛线程、保持 Tested up to 为当前版本、发布真实版本；头部词很难从高安装量插件手中转移；为显得新鲜而快速提交会违反 Guideline 14。
适用场景与限制
适用于 SaaS 厂商规划 WordPress 连接器插件的审核、发布与在架维护。不适用于需要远程代码或 iframe 后台应用的产品（目录禁止）。文中带 † 的数字和流程细节需核对当前 developer.wordpress.org 手册与 make.wordpress.org/plugins；未提供具体价格、具体审核周期保证或替代目录政策。