GaaaiLogin安装教程和后台设置

一、安装与启用

第 1 步：上传插件

将插件目录上传到：

/wp-content/plugins/gaaailogin/

也可以直接在 WordPress 后台上传 ZIP 安装包进行安装。

第 2 步：启用插件

进入后台：

插件 → 已安装插件 → GaaaiLogin → 启用

插件启用后，后台左侧会出现 GaaaiLogin 相关菜单。

启用插件后，后台通常会出现以下菜单：

• 社交设置
• 页面设置
• 公众号设置
• 公众号菜单
• 关注记录
• 帮助与更新

三、推荐配置顺序

为了避免遗漏，建议按下面顺序配置：

1. 填写社交平台参数
2. 设置前台按钮名称
3. 设置登录方式排序
4. 设置登录成功后的返回地址
5. 配置自动回复与关注回复
6. 配置公众号菜单
7. 启用前台页面 / 插入调用代码
8. 逐项测试登录功能

四、社交设置页面详解

进入路径：

WordPress 后台 → GaaaiLogin → 社交设置

这是插件最核心的配置页面。

1. QQ APPID

这里填写 QQ 互联申请到的 APPID。

作用：

• 开启 QQ 登录
• 用于 QQ 授权识别

申请地址：

https://connect.qq.com

2. QQ APPKEY

这里填写 QQ 互联应用对应的 APPKEY。

作用：

• 与 APPID 配套使用
• 用于 QQ 登录回调校验

3. Weibo APPKEY

这里填写微博开放平台申请的 APPKEY。

作用：

• 开启微博登录

申请地址：

http://open.weibo.com

4. Weibo APPSECRET

这里填写微博开放平台对应的 APPSECRET。

作用：

• 与微博 APPKEY 配套
• 用于授权回调验证

5. Weixin APPID（开放平台）

这里填写 微信开放平台 的 APPID。

作用：

• 主要用于 PC 端微信扫码登录

申请地址：

https://open.weixin.qq.com

6. Weixin APPSECRET（开放平台）

这里填写微信开放平台对应的 APPSECRET。

作用：

• 与开放平台 APPID 配套
• 用于微信扫码授权登录

7. Weixin APPID（公众号）

这里填写 微信公众号 的 APPID。

作用：

• 微信内网页授权登录
• 微信公众号自动回复
• 公众号菜单同步
• 关注公众号后登录等功能

8. Weixin APPSECRET（公众号）

这里填写微信公众号对应的 APPSECRET。

作用：

• 与公众号 APPID 配套
• 用于公众号相关接口调用

9. Weixin Token（公众号）

这里填写公众号服务器验证时使用的 Token。

作用：

• 用于微信公众平台后台服务器地址验证

如果这里不填写，插件默认值一般为：

gaaailogin

10. Google Client ID

这里填写 Google Cloud Console 里创建的 Web 应用 Client ID。

作用：

• 开启 Google 登录

适合：

• 英文网站
• 海外用户网站
• 国际化项目

11. Google Client Secret

这里填写 Google Cloud Console 中对应的 Client Secret。

作用：

• 与 Google Client ID 配套使用

Google 回调地址通常应填写为：

https://你的域名/wp-content/plugins/gaaailogin/auth/google-callback.php

例如：

https://yourdomain.com/wp-content/plugins/gaaailogin/auth/google-callback.php

五、前台按钮名称设置

这一部分用于自定义前台社交登录按钮显示文字。

1. QQ 按钮名称

• QQ登录
• 使用QQ登录
• QQ 快捷登录

2. 微博按钮名称

• 微博登录
• 使用微博登录

3. 微信按钮名称

• 微信登录
• 微信扫码登录
• 使用微信继续

4. Google 按钮名称

• Google登录
• Continue with Google
• Sign in with Google

六、微信扫码登录开关

后台通常会有一个选项：启用微信扫码登录

作用：

• 开启后，前台支持微信 PC 扫码登录
• 关闭后，不显示扫码登录面板

适用场景：

• 需要桌面端扫码登录时开启
• 不做微信扫码时可关闭

七、登录方式排序

后台有一个“登录方式排序”配置项。

填写格式示例：

qq,weixin,sina,google

说明：

• 使用英文平台标识
• 使用英文逗号分隔
• 前台按钮显示顺序会按这里的顺序排列

可选值一般包括：

• qq
• weixin
• sina
• google

示例 1：

weixin,qq,google,sina

表示前台顺序为：

1. 微信
2. QQ
3. Google
4. 微博

示例 2：

google,weixin,qq,sina

更适合国际化站点。

八、返回地址设置

后台有一个配置项：返回地址

作用：

• 用户登录成功后自动跳转到这个地址
• 用户绑定完成后也会跳转到这个地址

常见填写方式：

https://你的域名/

或者：

https://你的域名/u

推荐设置：

• 普通内容站：首页
• 会员站：用户中心
• 下载站：个人中心或资源页

九、保存设置

所有参数填写完成后，点击页面底部的：保存设置

保存成功后，后台通常会提示：更新成功！

十、关注记录管理教程

进入路径：

WordPress 后台 → GaaaiLogin → 关注记录

这个页面主要用于查看微信扫码、关注登录相关记录。

常见记录内容包括：

• 验证码
• openid
• 创建时间

主要用途：

• 排查扫码登录是否成功
• 检查 openid 是否写入
• 查看近期登录痕迹

1. 清理两天之前所有记录

作用：

• 删除两天前的历史日志记录

2. 清理两天之前所有空 openid 记录

作用：

• 删除未完成授权、未成功写入 openid 的无效记录