SW 聚合登录插件

通过第三方平台账号快速完成登录、注册和账号绑定，支持 QQ、微信、微博、百度、抖音、华为、小米、钉钉、飞书、企业微信、Gitee 等平台。

功能特性

• 支持 11 种主流第三方登录方式
• 完全遵循 OAuth 2.0 协议规范
• 支持登录、注册、账号绑定三种模式
• 与系统内置账号系统无缝集成
• 提供友好的用户界面和错误处理
• 完善的安全机制和配置验证
• 自动检查更新功能
• 完整的更新日志展示

支持的登录方式

安装

1. 将插件文件夹 social-login 放到项目的 addons/ 目录下
2. 在后台插件管理中安装并启用该插件
3. 进入插件设置页面，填写相关配置

配置说明

必需配置

• AppID: 从 SW 聚合登录平台获取的应用 ID
• AppKey: 从 SW 聚合登录平台获取的应用密钥
• 站点域名: 你的网站的完整外部访问域名，例如 https://yourdomain.com
• 启用聚合登录: 勾选此项以启用第三方登录功能

可选配置

• 启用的登录方式: 勾选你希望开放给用户使用的第三方登录平台

使用说明

1. 在 SW 聚合登录平台 注册账号并创建应用
2. 在应用设置中添加回调域名（格式：yourdomain.com，无需 https://）
3. 在插件设置页面填写 AppID、AppKey 和站点域名
4. 启用聚合登录并勾选需要的登录方式
5. 保存设置
6. 用户将在登录/注册页面看到第三方登录选项

作者信息

• 作者: OV 乐在途中-社区
• 主页: <https://bbs.o0v0.com>

注意事项

• 请确保在 SW 聚合登录平台正确配置了回调域名
• 回调域名需要填写不带协议的域名（例如 yourdomain.com）
• 首次使用建议先测试一种登录方式以验证配置
• 建议定期查看 SW 聚合登录平台的 API 状态
• 用户首次通过第三方登录时会自动创建新账号或要求绑定现有账号
• 绑定账号功能需要用户已登录

技术实现

本插件基于 SW 聚合登录平台的 API 实现，完全符合 OAuth 2.0 协议。主要流程：

1. 获取第三方登录跳转地址
2. 用户完成第三方授权
3. 通过授权码获取用户信息
4. 与系统账号关联或创建新账号
5. 完成登录流程
   插件使用宿主系统的 external-auth 桥接接口进行安全通信。

更新日志

v1.0.5 (2026-06-09)

• 添加版本检查功能
• 支持从远程获取更新信息
• 新增更新检查管理卡片
• 显示完整更新日志和下载链接
• 自动检查并提示新版本
• 优化用户体验和错误处理

v1.0.1 (2026-05-22)

• 优化管理后台页脚样式，与 sw-payment 插件保持一致
• 更新作者信息为 OV 乐在途中-社区
• 添加作者信息展示链接
• 完善错误处理和用户体验

v1.0.0

• 初始版本
• 支持 11 种第三方登录方式
• 完整的 OAuth 2.0 流程实现
• 支持登录、注册、账号绑定三种模式
• 提供友好的管理后台配置页面
• 完善的错误处理和用户反馈

许可证

MIT