### [瓜奇（GUAQI）框架彩虹聚合登录插件 —— 安装教程与完整介绍](https://guaqi.com/topic/78131)

**Published:** 2026-10-13T13:13:31

**Author:** 星动优创

**Excerpt:** 这个插件让使用瓜奇框架的 WordPress 站点，通过彩虹聚合登录接入 QQ、微信和微博。站点原有的登录按钮…

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

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

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

### 安装前准备

先准备好彩虹聚合登录服务，可以使用[彩虹官方服务](https://u.cccyun.cc)、[免费聚合登录服务](https://u.mzfpay.com)，或自建服务。

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

### 安装插件

在[下载页面](https://8maoku.com/article/3522)获取安装包，两种方式选一种即可。

**推荐通过瓜奇安装：**

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://8maoku.com/article/3522)

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



**Comments:** 

**星动优创:** 好的

**春哥:** 老哥，在开发的时候，如果需要钩子或者宿主源码有需要升级更新改动的，跟我说我来加，尽量让插件不要修改宿主源码！



---