DedeCMS 安装 QQ 登录插件详细教程
QQ 登录插件允许你的网站用户使用自己的 QQ 账号直接登录,极大地简化了注册和登录流程,能有效提升用户转化率。

(图片来源网络,侵删)
第一步:准备工作(至关重要)
在开始安装插件之前,请务必完成以下准备工作,否则插件将无法正常工作。
申请 QQ 互联应用(获取 AppID 和 AppKey)
这是整个流程的核心,你需要向腾讯申请一个开发者身份并创建应用。
-
访问 QQ 互联官网:
- 打开浏览器,访问 QQ 互联开放平台。
-
登录或注册账号:
(图片来源网络,侵删)使用你的 QQ 号码登录,如果你还没有开发者账号,需要先注册一个。
-
进入“应用管理”:
登录后,在顶部导航栏找到并点击“应用管理”。
-
创建网站应用:
(图片来源网络,侵删)- 在“应用管理”页面,点击“创建应用”。
- 选择应用类型为 “网站应用”,然后点击“立即创建”。
-
填写应用信息:
- 应用名称:填写你的网站名称,我的个人博客”,这个名字会显示在 QQ 登录授权页面上。
- 应用域名:这是最关键的一步! 填写你的网站域名,
www.yourdomain.com或yourdomain.com。请注意:- 必须与你的网站实际访问域名完全一致,包括
http或https,如果你的网站开启了 SSL,请务必使用https://。 - 如果你的网站在本地测试(如
localhost),可以填写http://localhost。 - 一个域名只能创建一个应用,且无法修改。
- 必须与你的网站实际访问域名完全一致,包括
- 应用回调域:这也是关键! 填写你的网站域名,与“应用域名”保持一致。
www.yourdomain.com,这个地址是用户授权成功后,QQ 服务器会跳转回来的地址。
-
提交审核:
填写完信息后,提交审核,腾讯通常会在1-3个工作日内完成审核,审核通过后,你的应用状态会变为“已上线”。
-
获取 AppID 和 AppKey:
- 审核通过后,回到你的应用详情页面。
- 在“基本信息”选项卡下,你可以找到
AppID和AppKey。请务必妥善保存这两个值,它们将在后续步骤中用到。
第二步:下载并准备插件文件
-
下载插件:
- 访问 DedeCMS 官方论坛或可靠的插件下载站点,搜索 “DedeCMS QQ 登录插件”,请确保下载与你 DedeCMS 版本(如 DedeCMS V5.7, V5.8 等)兼容的插件。
- 一个常用的、经过广泛测试的插件包是
DedeCMS_V5.7_UTF8_QQLogin,你可以以此为例进行搜索。
-
解压插件包:
- 将下载的
.zip或.rar文件解压到一个临时文件夹中,你会看到几个核心文件和文件夹。
- 将下载的
第三步:上传并部署文件
你需要将插件包中的文件上传到你的网站服务器上,并覆盖或放置到指定目录。
-
使用 FTP 或主机控制面板:
连接到你的网站服务器。
-
上传文件到根目录:
- 将插件包中的以下文件和文件夹,上传到你网站根目录(通常是
public_html、wwwroot或htdocs):connectconfig.phpqqconnect文件夹(请保持文件夹名不变)api文件夹(如果存在,请上传)user文件夹(如果存在,请上传)
- 将插件包中的以下文件和文件夹,上传到你网站根目录(通常是
-
设置文件权限:
- 为了确保插件能正常写入数据,需要将以下目录的权限设置为
755或777(777有安全风险,建议先用755,如果不行再尝试777,用完后改回755):/data/目录/user/目录/qqconnect/目录
- 你可以通过 FTP 软件(如 FileZilla)右键点击文件夹 -> “文件属性”来修改。
- 为了确保插件能正常写入数据,需要将以下目录的权限设置为
第四步:修改配置文件
这是将你的网站与 QQ 互联应用关联起来的步骤。
-
编辑
connectconfig.php文件:- 通过 FTP 文件管理器或在线文件编辑器,打开网站根目录下的
connectconfig.php文件。 - 找到以下两行代码,将你在第一步中获取的
AppID和AppKey填入进去。
// 将 '你的AppID' 替换为你从QQ互联获取的实际AppID define('QQ_APP_ID', '你的AppID'); // 将 '你的AppKey' 替换为你从QQ互联获取的实际AppKey define('QQ_APP_KEY', '你的AppKey'); - 通过 FTP 文件管理器或在线文件编辑器,打开网站根目录下的
-
保存文件:
- 保存并关闭
connectconfig.php文件。
- 保存并关闭
第五步:修改 DedeCMS 模板文件
你需要让登录页面显示 QQ 登录的按钮。
-
找到登录模板文件:
- 登录你的 DedeCMS 后台。
- 进入【模板】->【默认模板管理】。
- 找到并打开你的会员登录模板文件,通常是
/templets/default/login.htm。
-
添加 QQ 登录按钮代码:
- 在
<form>标签内的合适位置(用户登录”按钮的下方),添加以下代码:
<!--QQ登录按钮开始--> <div class="qqlogin"> <a href="{dede:global.cfg_cmspath/}/member/qqconnect.php"><img src="{dede:global.cfg_cmspath/}/qqconnect/images/qq_login.png" width="198" height="36" border="0" alt="使用QQ帐号登录" /></a> </div> <!--QQ登录按钮结束--> - 在
-
保存并生成:
- 保存
login.htm文件。 - 为了确保更改生效,建议去【系统】->【一键更新网站】->【更新所有】。
- 保存
第六步:后台配置与测试
-
登录 DedeCMS 后台:
- 进入【系统】-> 【QQ互联】 设置菜单(安装插件后,这个菜单会自动出现)。
-
检查配置:
- 在 QQ 互联设置页面,系统会自动读取
connectconfig.php文件中的AppID和AppKey,请再次确认它们是否正确无误。
- 在 QQ 互联设置页面,系统会自动读取
-
测试登录:
- 清除浏览器缓存,或者使用一个无痕/隐私窗口。
- 在前台打开你的网站登录页面 (
/member/login.php)。 - 你应该能看到一个“使用QQ帐号登录”的按钮。
- 点击它,会跳转到 QQ 的授权页面。
- 使用你的 QQ 账号授权登录。
- 授权成功后,页面会跳转回你的网站,并提示绑定或注册新用户。
- 如果一切顺利,你将成功登录,并且网站会员列表中会增加一条由 QQ 登录创建的记录。
常见问题与解决方案 (FAQ)
-
Q: 点击 QQ 登录按钮后,页面报错或跳转不正常?
- A:
- 检查域名:100% 的问题出在域名上,请返回第一步,确认“应用域名”和“应用回调域”是否与你的网站访问地址(包括
http/https)完全一致,这是最常见的原因。 - 检查
connectconfig.php:确认里面的AppID和AppKey是否填写正确,没有多余的空格。 - 检查文件权限:确保
/data/和/qqconnect/目录有写入权限。
- 检查域名:100% 的问题出在域名上,请返回第一步,确认“应用域名”和“应用回调域”是否与你的网站访问地址(包括
- A:
-
Q: 插件安装后,后台没有“QQ互联”菜单?
- A: 说明插件的核心文件没有正确部署或修改,请检查
user/login.class.php和user/qqconnect.php等文件是否已按要求修改并上传。
- A: 说明插件的核心文件没有正确部署或修改,请检查
-
Q: 用户 QQ 登录后,网站无法跳转,一直停留在 QQ 页面?
- A: 这通常是回调地址的问题,再次确认 QQ 互联后台的“应用回调域”是否正确,回调域必须与网站域名匹配。
-
Q: 插件与我的 DedeCMS 版本不兼容怎么办?
- A: 尝试寻找与你版本完全对应的插件,如果找不到,可能需要具备一定 PHP 和 DedeCMS 知识的开发者来修改插件代码以适配你的版本。
按照以上步骤,你应该就能成功为你的 DedeCMS 网站安装并启用 QQ 登录功能了,祝你安装顺利!
