dede qq登录插件怎么安装配置？-DEDE建站-盈思创科技

织梦（DedeCMS）官方并没有开发或提供官方的QQ登录插件，我们通常所说的“QQ登录插件”都是由第三方开发者制作,并免费或付费提供给用户使用的。

（图片来源网络，侵删）

这些插件的核心原理是利用QQ互联（现称“QQ登录”）提供的开放平台API，在网站和用户的QQ账号之间建立一个桥梁，实现“一键登录”功能。

核心概念：如何工作？

在安装和使用之前,了解其工作原理有助于你更好地排查问题：

申请开发者身份：你需要在腾讯开放平台（https://open.tencent.com/）上注册成为开发者，并创建一个“移动应用”或“网站应用”。
获取AppID和AppKey：创建应用后，腾讯会分配给你一个唯一的AppID和一个AppKey（密钥），这是你的网站在QQ互联平台上的“身份证”。
用户授权流程：
- 用户在你的网站上点击“QQ登录”按钮。
- 网站将用户引导至QQ的授权页面。
- 用户在QQ上点击“授权”，允许你的网站获取其基本信息（如昵称、头像、OpenID）。
- QQ平台将用户信息重定向回你网站预先设定的一个“回调地址”（Callback URL）。
- 你的网站上的插件接收到这些信息,进行验证和处理。
与DedeCMS整合：
- 插件会检查数据库中是否已存在该QQ OpenID对应的DedeCMS会员。
- 如果存在：直接登录该会员账户。
- 如果不存在：插件会根据你的配置，选择自动注册新会员（通常使用QQ昵称和头像），或者引导用户绑定已有账户。

如何选择和安装插件？

市面上有很多第三方插件，质量参差不齐，选择时请优先考虑更新日期较近、评价较好、有详细说明文档的插件。

以下是通用的安装步骤（以最常见的“一键登录”类插件为例）：

（图片来源网络，侵删）

第1步：准备环境（在腾讯开放平台）

登录/注册：访问腾讯开放平台,使用你的QQ号登录。
创建应用：
- 进入“应用管理” -> “创建应用”。
- 选择应用类型，对于网站，选择“网站应用”。
- 填写应用名称（我的网站名称）、应用简介等信息。
- 关键步骤：在“应用信息”页面，设置“授权回调域”，这个域名必须是你的网站域名，www.yourdomain.com。注意：这里不需要填写 http:// 或路径,只需域名。
获取凭证：创建成功后，在“应用概况”页面找到并记录下你的 AppID 和 AppKey,后续安装插件时需要用到。

第2步：下载并安装插件到DedeCMS

下载插件：
- 在DedeCMS相关的论坛、资源站（如Dede吧、模板王等）搜索“Dede QQ登录插件”。
- 下载最新版本的插件包，通常是 .zip 格式。
- 注意：下载时注意查看评论,避免下载到有后门或病毒的插件。
上传文件：
- 解压下载的插件包。
- 使用FTP工具连接到你的网站服务器。
- 将解压后的文件夹内的文件，按照插件说明的路径，上传到你的DedeCMS网站根目录的相应位置，通常是：
  - /include/ 目录下的文件夹（如 connect/, qqlogin/ 等）。
  - /templets/ 目录下的模板文件（如果插件自带了登录按钮的模板）。
  - /plus/ 目录下的文件（如果插件有独立的处理页面）。
执行安装：
- 在浏览器中访问你的网站后台管理地址。
- 在后台菜单中找到“模块” -> “模块管理”或“插件管理”。
- 你应该能看到新上传的插件，点击“安装”或“启用”。
- 有些插件可能需要你手动在数据库中执行 .sql 文件来创建数据表，请务必阅读插件自带的 readme.txt 安装说明。

第3步：配置插件

进入插件设置：在后台的模块/插件管理中，找到已安装的QQ登录插件，点击“设置”。
填写QQ互联信息：
- AppID：填入你在腾讯开放平台获取的AppID。
- AppKey：填入你在腾讯开放平台获取的AppKey。
- 回调地址：这一项非常重要，插件通常会自动生成一个默认地址，格式如 http://www.yourdomain.com/plus/qq_callback.php。请务必确认这个地址是正确的，并且能被外网访问，你也可以手动修改为你自己的回调地址，但要确保与你在腾讯开放平台设置的“授权回调域”一致。
会员整合设置：
- 是否自动注册：选择“是”或“否”，建议选择“是”,以提升用户体验。
- 会员模型：选择QQ登录信息要关联的会员模型（通常是“普通会员”）。
- 默认会员组：设置新注册的QQ登录用户所属的会员组。
- 字段映射：将QQ返回的用户信息（如昵称、头像）映射到DedeCMS会员表的相应字段（如 uname, face）。
保存设置：点击“保存”或“提交”按钮。

第4步：在前台显示登录按钮

登录你的网站后台。
（图片来源网络，侵删）
进入“模板” -> “默认模板管理”。
找到会员登录相关的模板文件，通常是 templets/default/member/index.htm 或 templets/default/login.htm。
在你希望显示“QQ登录”按钮的位置（通常在用户名/密码登录框旁边），添加调用代码,代码格式通常由插件提供，
```
<a href="{dede:global.cfg_qqlogin_url/}" title="使用QQ帐号登录">
    <img src="{dede:global.cfg_qqlogin_icon/}" alt="QQ登录" />
</a>
```
或者直接是一个链接：
```
<a href="/member/qqlogin.php">QQ一键登录</a>
```
注意：具体的调用代码请务必参考你所安装的插件官方说明文档。
更新网站缓存，然后刷新前台页面,你应该就能看到QQ登录按钮了。

常见问题与排查

点击QQ登录后，提示“回调地址错误”或“redirect_uri错误”
- 原因：这是最常见的问题，腾讯开放平台设置的“授权回调域”与插件中填写的“回调地址”不匹配。
- 解决：
  - 检查腾讯开放平台的应用设置，确保“授权回调域”是你的完整域名（如 www.yourdomain.com）。
  - 检查插件后台的“回调地址”设置，确保它是一个完整的、可访问的URL（如 http://www.yourdomain.com/plus/qq_callback.php）,并且域名与平台设置的一致。
点击QQ登录后，跳转到QQ页面，但点击授权后没反应或返回空白页
- 原因：
  - 服务器不支持 curl 或 file_get_contents �PHP函数,无法与QQ服务器通信。
  - 回调地址的文件（如 qq_callback.php）不存在或路径错误。
  - 服务器的 allow_url_fopen 选项未开启。
- 解决：
  - 联系你的主机商,确认服务器环境是否支持。
  - 检查回调文件是否已正确上传到对应目录。
  - 在 php.ini 配置文件中找到 allow_url_fopen，将其值设置为 On。
提示“AppID或AppKey无效”
- 原因：填写的AppID或AppKey不正确，或者该应用在腾讯开放平台的状态是“未审核”或“已禁用”。
- 解决：登录腾讯开放平台，核对AppID和AppKey，并确保你的应用已经通过审核并处于“已上线”状态。
用户已存在，但无法登录
- 原因：可能是因为插件在处理逻辑时,没有正确地将QQ的OpenID与已有的DedeCMS会员进行关联。
- 解决：查看插件设置，是否有“绑定已有账户”的选项，或者，尝试删除数据库中该会员的QQ关联信息，然后用QQ重新登录一次,看是否会提示绑定。

安装Dede QQ登录插件并不复杂，但关键在于细心和耐心。

核心流程回顾：腾讯开放平台申请应用 -> 获取AppID/AppKey -> 下载插件并上传到DedeCMS -> 后台配置插件（填入AppID/AppKey和回调地址） -> 前台模板添加登录按钮 -> 测试并排查问题。

如果在操作中遇到困难，最好的方法是仔细阅读你所下载的插件自带的说明文档，因为每个插件的实现细节可能略有不同，如果文档不全,可以去相关的论坛或社区寻求帮助。

dede qq登录插件怎么安装配置？