✅「WordPress.org 插件上线最低可行 + 可稳过审核」任务清单
我们可以一项一项打勾完成,不新增功能,只做“收口 + 规范 + 稳定”。
🧾 Athletic Press(AP)上线 WordPress.org 任务清单(v1.0)
目标:
顺利通过 WP 官方审核 + 插件可长期维护 + 为 v1.1+ 留空间
🟥 P0(必须完成,不做就不能上线)
① 插件结构 & 合规性(你已经完成 70% 👍)
-
主插件文件存在且规范
athletic-press-core.php
-
插件头信息完整(Name / Description / Version / Author)
-
不直接执行代码(if ( ! defined( ‘ABSPATH’ ) ) exit;)
-
不依赖未声明的外部 SaaS
-
无致命错误 / PHP Notice / Warning
-
Git working tree clean(你今天已经达成)
👉 状态:基本 OK
② 国际化(i18n)【你今天的核心成果】
-
所有 UI 字符串使用英文原文
-
所有字符串使用 __() / esc_html__() 等
-
统一 Text Domain:athletic-press-core
-
存在 languages/athletic-press-core.pot
-
load_plugin_textdomain() 正确加载
👉 状态:✅ 达到 WP 官方要求
💡 说明:
WP 审核不要求你提供翻译文件,只要求 可翻译。
③ 激活 / 卸载安全性
-
register_activation_hook() 不做危险操作
(✔ 你目前只是 register CPT / role / flush rewrite)
-
register_deactivation_hook() 不删除用户数据
-
无自动删除 post / option / user 行为
👉 这是 WP 审核非常敏感的一点
④ 权限 & 安全(最低要求)
-
所有 admin 页面有 current_user_can()
-
不允许未登录用户访问 admin action
-
所有输出做 escape(你基本都在用 👍)
-
所有 URL 使用 admin_url() / esc_url()
👉 我们后面可以集中扫一遍
🟧 P1(强烈建议完成,上线成功率大幅提高)
⑤ README.txt(WP 插件“门面”)
📌 这是 WP 审核 + 用户第一印象的核心文件
必须有(最少):
-
Plugin Name
-
Short Description(1–2 行)
-
Description(解决什么问题)
-
Features(功能列表)
-
Installation
-
FAQ(哪怕只有 2 条)
-
Screenshots(先留标题也行)
-
Changelog(v1.0)
👉 我可以直接帮你写英文初稿
⑥ 功能完整性自检(不加功能)
-
插件激活后不会白屏
-
Admin 菜单全部可点开
-
没有 “此功能未完成导致 fatal”
-
所有 CPT 可创建 / 编辑 / 删除
-
Dashboard 不报错(你刚修好 👍)
⑦ 不做「越界功能」
WP 审核不喜欢:
-
❌ 强制登录
-
❌ 强制绑定外部账号
-
❌ 广告弹窗
-
❌ 未说明的收费墙
👉 你现在完全没踩雷
🟨 P2(可延期,但上线后 1–2 周内)
⑧ 截图(可以先用英文占位)
-
Dashboard
-
Event list
-
Athlete list
-
Entry
-
Schedule / Results(哪怕是空)
不需要真实数据,界面即可
⑨ translate.wordpress.org(上线后)
-
插件通过审核
-
自动出现在 translate.wordpress.org
-
社区开始贡献翻译
-
你只维护 en_US 主线
🟩 明确放到 v1.1+(你现在的决定是
完全正确的
)
-
⏳ 检录模块
-
⏳ 打印输出中心(PDF / bib / certificates)
-
⏳ 成绩库 / 历史统计
-
⏳ 大屏展示 / Live display
-
⏳ 运动专项(Football / Basketball / Swimming)
👉 WP 官方不要求这些
🧭 我建议的「执行方式」(不累、不乱)
我们可以按这个节奏来:
-
先完成 P0(只修,不加)
-
再补 README.txt
-
最后跑一轮“模拟审核自查”
你下次只要说一句:
“我们从清单第 X 项开始”
我就只干那一项,不跑题。
最后一句(很重要)
发表回复