DedeCMS 安装 QQ 登录插件详细教程

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

dede安装qq登录插件的教程
(图片来源网络,侵删)

第一步:准备工作(至关重要)

在开始安装插件之前,请务必完成以下准备工作,否则插件将无法正常工作。

申请 QQ 互联应用(获取 AppID 和 AppKey)

这是整个流程的核心,你需要向腾讯申请一个开发者身份并创建应用。

  1. 访问 QQ 互联官网

  2. 登录或注册账号

    dede安装qq登录插件的教程
    (图片来源网络,侵删)

    使用你的 QQ 号码登录,如果你还没有开发者账号,需要先注册一个。

  3. 进入“应用管理”

    登录后,在顶部导航栏找到并点击“应用管理”。

  4. 创建网站应用

    dede安装qq登录插件的教程
    (图片来源网络,侵删)
    • 在“应用管理”页面,点击“创建应用”。
    • 选择应用类型为 “网站应用”,然后点击“立即创建”。
  5. 填写应用信息

    • 应用名称:填写你的网站名称,我的个人博客”,这个名字会显示在 QQ 登录授权页面上。
    • 应用域名这是最关键的一步! 填写你的网站域名,www.yourdomain.comyourdomain.com请注意
      • 必须与你的网站实际访问域名完全一致,包括 httphttps,如果你的网站开启了 SSL,请务必使用 https://
      • 如果你的网站在本地测试(如 localhost),可以填写 http://localhost
      • 一个域名只能创建一个应用,且无法修改。
    • 应用回调域这也是关键! 填写你的网站域名,与“应用域名”保持一致。www.yourdomain.com,这个地址是用户授权成功后,QQ 服务器会跳转回来的地址。
  6. 提交审核

    填写完信息后,提交审核,腾讯通常会在1-3个工作日内完成审核,审核通过后,你的应用状态会变为“已上线”。

  7. 获取 AppID 和 AppKey

    • 审核通过后,回到你的应用详情页面。
    • 在“基本信息”选项卡下,你可以找到 AppIDAppKey请务必妥善保存这两个值,它们将在后续步骤中用到。

第二步:下载并准备插件文件

  1. 下载插件

    • 访问 DedeCMS 官方论坛或可靠的插件下载站点,搜索 “DedeCMS QQ 登录插件”,请确保下载与你 DedeCMS 版本(如 DedeCMS V5.7, V5.8 等)兼容的插件。
    • 一个常用的、经过广泛测试的插件包是 DedeCMS_V5.7_UTF8_QQLogin,你可以以此为例进行搜索。
  2. 解压插件包

    • 将下载的 .zip.rar 文件解压到一个临时文件夹中,你会看到几个核心文件和文件夹。

第三步:上传并部署文件

你需要将插件包中的文件上传到你的网站服务器上,并覆盖或放置到指定目录。

  1. 使用 FTP 或主机控制面板

    连接到你的网站服务器。

  2. 上传文件到根目录

    • 将插件包中的以下文件和文件夹,上传到你网站根目录(通常是 public_htmlwwwroothtdocs
      • connectconfig.php
      • qqconnect 文件夹(请保持文件夹名不变)
      • api 文件夹(如果存在,请上传)
      • user 文件夹(如果存在,请上传)
  3. 设置文件权限

    • 为了确保插件能正常写入数据,需要将以下目录的权限设置为 755777777 有安全风险,建议先用 755,如果不行再尝试 777,用完后改回 755):
      • /data/ 目录
      • /user/ 目录
      • /qqconnect/ 目录
    • 你可以通过 FTP 软件(如 FileZilla)右键点击文件夹 -> “文件属性”来修改。

第四步:修改配置文件

这是将你的网站与 QQ 互联应用关联起来的步骤。

  1. 编辑 connectconfig.php 文件

    • 通过 FTP 文件管理器或在线文件编辑器,打开网站根目录下的 connectconfig.php 文件。
    • 找到以下两行代码,将你在第一步中获取的 AppIDAppKey 填入进去。
    // 将 '你的AppID' 替换为你从QQ互联获取的实际AppID
    define('QQ_APP_ID', '你的AppID');
    // 将 '你的AppKey' 替换为你从QQ互联获取的实际AppKey
    define('QQ_APP_KEY', '你的AppKey');
  2. 保存文件

    • 保存并关闭 connectconfig.php 文件。

第五步:修改 DedeCMS 模板文件

你需要让登录页面显示 QQ 登录的按钮。

  1. 找到登录模板文件

    • 登录你的 DedeCMS 后台。
    • 进入【模板】->【默认模板管理】。
    • 找到并打开你的会员登录模板文件,通常是 /templets/default/login.htm
  2. 添加 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登录按钮结束-->
  3. 保存并生成

    • 保存 login.htm 文件。
    • 为了确保更改生效,建议去【系统】->【一键更新网站】->【更新所有】。

第六步:后台配置与测试

  1. 登录 DedeCMS 后台

    • 进入【系统】-> 【QQ互联】 设置菜单(安装插件后,这个菜单会自动出现)。
  2. 检查配置

    • 在 QQ 互联设置页面,系统会自动读取 connectconfig.php 文件中的 AppIDAppKey,请再次确认它们是否正确无误。
  3. 测试登录

    • 清除浏览器缓存,或者使用一个无痕/隐私窗口。
    • 在前台打开你的网站登录页面 (/member/login.php)。
    • 你应该能看到一个“使用QQ帐号登录”的按钮。
    • 点击它,会跳转到 QQ 的授权页面。
    • 使用你的 QQ 账号授权登录。
    • 授权成功后,页面会跳转回你的网站,并提示绑定或注册新用户。
    • 如果一切顺利,你将成功登录,并且网站会员列表中会增加一条由 QQ 登录创建的记录。

常见问题与解决方案 (FAQ)

  • Q: 点击 QQ 登录按钮后,页面报错或跳转不正常?

    • A:
      1. 检查域名:100% 的问题出在域名上,请返回第一步,确认“应用域名”和“应用回调域”是否与你的网站访问地址(包括 http/https完全一致,这是最常见的原因。
      2. 检查 connectconfig.php:确认里面的 AppIDAppKey 是否填写正确,没有多余的空格。
      3. 检查文件权限:确保 /data//qqconnect/ 目录有写入权限。
  • Q: 插件安装后,后台没有“QQ互联”菜单?

    • A: 说明插件的核心文件没有正确部署或修改,请检查 user/login.class.phpuser/qqconnect.php 等文件是否已按要求修改并上传。
  • Q: 用户 QQ 登录后,网站无法跳转,一直停留在 QQ 页面?

    • A: 这通常是回调地址的问题,再次确认 QQ 互联后台的“应用回调域”是否正确,回调域必须与网站域名匹配。
  • Q: 插件与我的 DedeCMS 版本不兼容怎么办?

    • A: 尝试寻找与你版本完全对应的插件,如果找不到,可能需要具备一定 PHP 和 DedeCMS 知识的开发者来修改插件代码以适配你的版本。

按照以上步骤,你应该就能成功为你的 DedeCMS 网站安装并启用 QQ 登录功能了,祝你安装顺利!