瓜奇（GUAQI）框架彩虹聚合登录插件 —— 安装教程与完整介绍

这个插件让使用瓜奇框架的 WordPress 站点，通过彩虹聚合登录接入 QQ、微信和微博。站点原有的登录按钮保持不变，也不需要修改瓜奇文件。

它还解决了接入聚合登录时的两个问题：微信提示「AppID 参数错误」，以及微博按钮点击后报错、无法登录。

插件仅适用于瓜奇框架，普通 WordPress 站点不适用。

安装前准备

先准备好彩虹聚合登录服务，可以使用彩虹官方服务、免费聚合登录服务，或自建服务。

在聚合登录后台创建应用，启用 QQ、微信、微博渠道，记下 服务端地址、appid 和 appkey。彩虹后台的微信渠道叫 wx，微博叫 sina，选择时注意区分。

安装插件

在下载页面获取安装包，两种方式选一种即可。

推荐通过瓜奇安装：

1. 打开瓜奇后台的「插件」页。

2. 上传 guaqi-rainbow-login-1.3.0.zip。

3. 安装后，为当前站点勾选「启用」。

直接上传原包，不要解压后重新打包。更新插件时使用新的版本号，不要用同一版本号上传不同内容的包。

如果瓜奇插件页无法安装：

进入 WordPress 后台「插件 → 安装插件 → 上传插件」，上传 gqplus-rainbow-login-1.3.0-wp.zip，然后启用。

两个安装包功能相同，不要同时启用。如果正在使用其他聚合登录插件，也要关闭它对 QQ、微信和微博的接管。

配置登录

第一步：在瓜奇后台填写应用凭据

进入「注册设置 → 社交登录」，检查以下三个渠道是否已经添加并启用：

渠道	条目 key	client_id	client_secret
QQ	qq	彩虹 appid	彩虹 appkey
微信	wechat	彩虹 appid	彩虹 appkey
微博	weibo	彩虹 appid	彩虹 appkey

如果三个渠道使用同一个彩虹应用，就填写同一组凭据。这里填的是彩虹的应用凭据。

第二步：填写服务端地址

进入 WordPress 后台「设置 → GQPlus Rainbow」：

• 「彩虹服务端地址」填写你使用的聚合登录服务地址。例如使用官方服务时，填写 https://u.cccyun.cc。

• 不需要在地址后面添加 /connect.php，插件会自动处理。

• 保持「启用接管」开启，保存设置。

服务端地址要与提供 appid、appkey 的服务一致。

第三步：登记回调地址

在彩虹后台，为三个渠道登记对应的回调地址：

https://你的前端域名/authorize?type=qq
https://你的前端域名/authorize?type=wechat
https://你的前端域名/authorize?type=weibo

这里使用的是显示瓜奇登录页面的前端域名。如果前后端分开部署，不要填成 WordPress 后台域名。

插件设置页会显示推导出的回调地址，直接复制到彩虹后台即可。

检查是否配置成功

回到「设置 → GQPlus Rainbow」，依次点击：

1. 测试彩虹连接：检查服务能否连接，以及回调参数是否正常。

2. 运行三平台自检：检查 QQ、微信、微博是否都能获取登录地址。

再查看「运行时接管诊断」，确认三个渠道都显示「本插件已接管」。最后到前台实际登录一次。桌面端点击微信登录后，应进入聚合服务的扫码页，不再出现「AppID 参数错误」。

手机端微信仍沿用瓜奇原来的引导和公众号授权流程，不会因为安装插件就自动变成桌面端扫码登录。

如果需要恢复原来的登录方式，在插件设置页关闭「启用接管」即可。

---

适用版本：瓜奇（GUAQI）框架 + WordPress。插件版本 1.3.0。

下载地址：https://8maoku.com/article/3522

永久免费聚合登录：https://u.mzfpay.com