智慧教育平台 OAuth 登录使用指南

本插件为 WordPress 页面提供智慧教育平台统一授权登录入口。用户通过智慧教育平台教师身份完成授权后，插件会识别已有 WordPress 用户，或自动创建新用户并登录。

1. 使用要求

• WordPress 5.0 或更高版本。
• PHP 7.4 或更高版本。
• 网站能够通过 HTTPS 正常访问。
• 已从智慧教育平台获得可用的 APP ID 和 APP Key。
• 能够在智慧教育平台应用中登记 OAuth 回调地址。

2. 安装插件

1. 登录 WordPress 后台。
2. 进入“插件 > 安装插件 > 上传插件”。
3. 选择插件 ZIP 文件并完成安装。
4. 点击“启用插件”。
5. 启用后进入“设置 > 智慧教育平台”。

3. 配置 APP ID 和 APP Key

1. 在“设置 > 智慧教育平台”打开“API 设置”。
2. 在“APP ID”中填写智慧教育平台分配的应用 ID。
3. 在“APP Key”中填写对应的应用密钥。
4. 点击“保存更改”。

APP Key 属于敏感凭证。只应由可信的网站管理员配置，不要把它写入公开页面、截图或支持工单。

4. 登记回调地址

插件使用以下回调路径：

https://你的站点域名/smartedu-auth-access/

例如网站首页是 https://school.example.com/，需要登记：

https://school.example.com/smartedu-auth-access/

智慧教育平台登记的地址必须与 WordPress 实际生成的地址完全一致，包括：

• http 或 https 协议。
• 主域名或子域名。
• WordPress 是否安装在子目录。
• 末尾的 smartedu-auth-access/ 路径。

如果网站刚修改过固定链接，请进入“设置 > 固定链接”重新保存一次，然后再测试回调。

5. 添加登录按钮

在需要显示入口的页面、文章或支持短代码的页面构建器组件中插入：

[smartedu_login_button]

保存并打开页面后，会显示“统一授权登录”链接。该链接会把访客带到智慧教育平台授权页面。

6. 验证完整登录流程

建议使用退出登录后的浏览器窗口进行测试：

1. 打开包含登录短代码的页面。
2. 点击“统一授权登录”。
3. 在智慧教育平台完成教师身份登录和授权。
4. 确认浏览器返回本站。
5. 确认 WordPress 已处于登录状态。

插件优先使用接口返回的 username 作为 WordPress 登录名；如果该字段不存在，则使用 smartEduCard。

• 登录名已存在：登录对应的 WordPress 用户。
• 登录名不存在：创建新用户并立即登录。

新用户会获得自动生成的密码和占位邮箱。网站管理员可根据站点业务流程补充真实邮箱、角色或其他资料。