tacraft-sociality / flarum-oauth-only-signup

1.0.0 2026-11-02 07:19 UTC

Requires

• php: ^8.3
• flarum/core: ^2.0.2

MIT

• TCS Dev HUB

• oauth
• registration
• login
• signup
• flarum

Published on Packagist.org on 2026-11-02 07:35 UTC

README

关闭「邮箱 + 密码」注册，只允许通过第三方账号（QQ / GitHub / 微软 / TcsSkin 等）创建新账号；老用户仍可正常使用邮箱 + 密码登录。

行为

场景	结果
登录框「注册」入口	隐藏（allowSignUp 前端属性被强制为 false）
登录框底部提示	默认显示「本站已关闭邮箱注册，请使用下方第三方账号登录；已有账号可以直接用邮箱和密码登录。」，可在后台修改或清空
第三方登录后创建新账号	允许（携带 RegistrationToken，由 OAuth 回调生成）
POST /register 或 POST /api/users 提交邮箱 + 密码	拒绝，返回 本站已关闭邮箱注册，请使用 QQ、GitHub、微软或 TcsSkin 登录。
老用户邮箱 + 密码登录	不受影响
管理员在后台创建用户	允许（actor->isAdmin()）

设置

后台 → 扩展 → OAuth Only Signup → 「登录页提示」：

• 默认值：本站已关闭邮箱注册，请使用下方第三方账号登录；已有账号可以直接用邮箱和密码登录。
• 支持多行文本（textarea），显示在登录弹窗提交按钮下方
• 留空则完全不显示这段提示

实现

• extend.php 用 Extend\ApiResource(ForumResource::class) 把 allowSignUp 字段的 get 覆盖成 false。这里只改前端拿到的属性，allow_sign_up 设置本身不变，所以 POST /users 端点依然对游客开放 —— 否则第三方注册也会被一起挡掉。
• Saving 事件里校验新建账号的请求体：只有带合法 RegistrationToken 的请求（即 OAuth 回调发起的注册）才放行，其余一律抛 ValidationException。
• 提示文字存在设置 tacraft-sociality-oauth-only-signup.hint 里，通过 serializeToForum('oauthOnlySignupHint') 暴露给前端；前端用 LogInModal.fields 以优先级 -20 追加一段 helpText。

注意

• 后台「权限 → 允许注册」开关仍会影响 POST /users 端点本身：不要把它关掉，关掉会连带禁止第三方注册。
• 如需恢复邮箱注册，禁用本扩展即可。
• 改动界面后需重新构建：cd js && npm run build。