Modown主题QQ登录设置完整教程｜新手也能3分钟搞定

💡注意：文件夹名称必须是「oauth」，不能修改为其他名称；上传路径务必是根目录，传错路径会导致后续登录报错。</div

第二步：QQ互联申请网站应用（获取APP ID和APP Key）

QQ登录需要通过QQ互联平台申请应用，获取专属的APP ID和APP Key，才能实现与Modown主题的对接，步骤如下，耐心操作即可：
1 打开QQ互联官网：https://connect.qq.com/，用你常用的QQ账号登录（建议使用网站主体相关的QQ，避免后续账号变更带来麻烦）；
2 登录后，点击右上角头像，选择「成为开发者」，按照提示完成个人或企业认证（个人认证需上传身份证，企业认证需上传营业执照，认证一般1-2个工作日完成）；
3 认证通过后，进入「应用管理」，点击「创建应用」，选择「网站应用」（不要选错为移动应用，否则无法对接网站）；
4 填写网站应用信息（重点填写以下4项，其他信息按实际情况补充）：

1. 1. 4.1 网站名称：填写你的网站正式名称（与备案名称一致，否则可能审核不通过）；
   2. 4.2 网站地址：填写你的网站首页地址，格式为「https://你的域名」（必须与网站实际地址一致，含https）；
   3. 4.3 回调地址（核心！）：填写「https://你的域名/oauth/qq/callback.php」，必须与第一步上传的接口路径完全一致，含https、域名后缀，不能多空格、不能少字符；
      4.4 网站备案号：填写你的域名备案号（格式如：粤ICP备XXXXXXX号），未备案会直接驳回申请。

5 上传网站Logo（按要求上传，尺寸符合规范，建议使用网站官方Logo，提升审核通过率），填写网站简介，确认信息无误后提交审核；
6 等待审核通过，一般几小时到1天即可（审核期间，可使用开发者QQ测试登录，其他QQ无法正常使用）；
7 审核通过后，进入应用详情页，复制「APP ID」和「APP Key」（这两个信息后续要用到，建议复制保存到记事本，避免遗漏）。

第三步：Modown主题后台配置（对接QQ登录接口）

获取APP ID和APP Key后，回到WordPress后台，配置Modown主题的第三方登录功能，步骤非常简单：
1 登录WordPress后台，点击左侧「外观」，找到「Modown主题设置」，点击进入；
2 在主题设置中，找到「登录 / 第三方登录」选项（不同版本位置可能略有差异，找不到可在主题设置搜索框搜索「第三方登录」）；
3 找到「QQ登录」模块，开启「启用QQ登录」开关；
4 依次填写信息：

1. 1. 4.1 APP ID：粘贴从QQ互联获取的「APP ID」；
   2. 4.2 APP Key：粘贴从QQ互联获取的「APP Key」；
      4.3 回调地址：再次填写「https://你的域名/oauth/qq/callback.php」，确保与QQ互联填写的完全一致。

5 填写完成后，点击「保存设置」，主题配置就完成啦！

第四步：测试QQ登录功能（确保正常可用）

配置完成后，一定要测试一下，避免用户登录时出现问题，测试步骤如下：
1 退出当前WordPress管理员账号；
2 打开网站前台登录页（一般是「https://你的域名/login/」），查看是否出现「QQ登录」按钮；
3 点击「QQ登录」按钮，会跳转至QQ扫码授权页面，使用QQ扫码授权；
4 授权完成后，若能自动跳转回网站，并完成注册/登录（新用户自动注册，老用户直接登录），则说明功能正常；
5 若无法跳转、登录报错，可对照下方常见问题排查。

常见问题排查（新手必看，避开这些坑）

很多小伙伴配置后会遇到一些小问题，整理了4个最常见的情况，对应排查方法如下，帮你快速解决：
1 点击QQ登录无反应/报错「回调地址错误」：检查QQ互联填写的回调地址、主题后台填写的回调地址、oauth接口路径，三者必须完全一致（含https、www，无多余空格）；
2 点击QQ登录提示404：检查oauth文件夹是否上传到根目录，文件夹名称是否正确，回调地址中的路径是否与实际上传路径一致；
3 QQ互联审核不通过：确认域名已备案、网站已上线且有正常内容、网站名称与备案名称一致、备案号填写正确；
4 登录后跳回首页，无法完成注册：检查网站SMTP邮件功能是否正常（部分Modown版本需要邮件支持），同时在主题设置→登录中，开启「用户注册」功能。

总结：最简操作流程（快速回顾）

如果觉得步骤太多，可记住这个最简流程，高效完成设置：
1 上传oauth文件夹到网站根目录；
2 QQ互联申请网站应用，获取APP ID和APP Key；
3 Modown主题设置→第三方登录，填写APP ID、APP Key和回调地址，保存；
4 前台测试QQ登录，正常即可使用。
以上就是Modown主题QQ登录的完整设置教程啦，整个过程其实不难，重点是注意回调地址、接口路径这两个细节，避开这些坑，新手也能快速搞定。
！