dedecms多说评论插件如何安装使用？

多说（Duoshuo）官方已于 2025 年 8 月 1 日正式停止服务，这意味着，如果你现在去安装和配置多说评论，评论将无法正常显示、发布和同步。

对于任何新网站，我强烈不建议你使用多说评论插件，你应该选择目前仍在维护和活跃的评论系统，如 Valine、Gitalk、畅言 等。

为了满足学习和维护旧网站的需求，我还是会为你详细讲解如何安装、配置和使用 Dedecms 的多说评论插件,并告诉你如何应对多说关闭后的问题。

第一部分：多说评论插件安装与配置（历史教程）

这部分是针对那些仍在使用多说,或者想了解其工作原理的用户。

准备工作：获取多说站点通用代码

在插件安装之前,你必须在多说官网上创建你的站点并获取代码。

1. 访问多说官网：https://duoshuo.com/ (此网站已停止服务,你可能无法登录或创建新站点)

2. 注册并登录：使用你的账号登录。

3. 创建站点：在后台点击“站点设置” -> “添加新站点”,填写你的网站信息。

4. 获取代码：创建成功后，多说会提供一段 JavaScript 代码。请务必复制并保存好这段代码,它通常长这样：

   
   （图片来源网络，侵删）

   <div class="ds-thread" data-thread-key="请替换为文章ID" data-title="请替换为文章标题" data-url="请替换为文章网址"></div>
   <!-- 多说评论框 end -->
   <!-- 多说公共JS代码 start (一个网页只需插入一次) -->
   <script type="text/javascript">
   var duoshuoQuery = {short_name:"你的多说二级域名"};
   (function() {
       var ds = document.createElement('script');
       ds.type = 'text/javascript';ds.async = true;
       ds.src = (document.location.protocol == 'https:' ? 'https:' : 'http:') + '//static.duoshuo.com/embed.js';
       ds.charset = 'UTF-8';
       (document.getElementsByTagName('head')[0] 
        || document.getElementsByTagName('body')[0]).appendChild(ds);
   })();
   </script>
   <!-- 多说公共JS代码 end -->

   • short_name：这是你的多说站点的唯一标识,非常重要。
   • data-thread-key, data-title, data-url：这些是动态变量,用于将每篇文章的评论区分开。

安装多说评论插件

Dedecms 官方自带了一个“多说评论”插件,你可以通过后台直接安装。

1. 登录 Dedecms 后台：使用你的管理员账号登录。
2. 进入插件管理：在左侧菜单栏找到 系统 -> 插件管理。
3. 安装插件：
   • 点击 上传新插件。
   • 在弹出的窗口中，选择 从本地上传。
   • 点击 选择文件，找到你下载好的 dedecms_duoshuo.zip 文件（这个文件通常在 Dedecms 安装包的 /plus 目录下，或者你可以从网上搜索下载）。
   • 上传成功后,插件会自动安装。

配置多说评论插件

安装完成后,需要对插件进行配置。

1. 进入插件参数设置：
   • 再次进入 系统 -> 插件管理。
   • 在插件列表中找到 “多说评论”，点击右边的 参数 或 禁用/启用 旁边的设置图标。
2. 填写配置信息：
   • 多说ShortName：将你在第一步获取的代码中的 short_name 填写到这里。
   • 是否开启：选择 是。
   • 评论位置：选择你希望评论显示的位置，通常是 内容页。
   • 是否开启游客评论：根据你的需求选择 是 或 否。
   • 其他参数：如 评论排序 等,可以根据默认设置或你的喜好调整。
3. 保存设置：点击 确定 保存配置。

修改模板文件（关键步骤）

Dedecms 的插件系统通常需要你手动修改模板文件来调用评论代码。

1. 找到文章模板：

   • 进入 模板 -> 默认模板管理。
   • 找到你正在使用的文章内容页模板，通常是 article_article.htm。

2. 插入评论代码：

   • 用文本编辑器（如 Notepad++、VS Code）打开 article_article.htm 文件。
   • 在你希望显示评论的位置（文章内容下方、作者信息下方）,插入以下代码：

   {dede:include file='plus/duoshuo.php'/}

   • 或者，更直接的方式是，直接将你在多说官网获取的 完整 JavaScript 代码 粘贴到模板文件中，但为了动态化,推荐使用第一种方法。

3. 确保 duoshuo.php 文件存在：

   • 插件安装后，通常会在 /plus 目录下生成一个 duoshuo.php 文件，这个文件的作用是动态生成 data-thread-key 等变量。
   • 用文本编辑器打开 /plus/duoshuo.php 文件，检查其内容是否正确，通常它会包含类似以下的 PHP 代码：

   <?php
   if(!defined('DEDEINC')) exit('dedecms');
   /**
    * 多说评论调用代码
    *
    * @version        $id:duoshuo.php v 1.0 2010-12-24 tianya $
    * @package        DedeBIZ.Site
    * @copyright      Copyright (c) 2025, DedeBIZ.COM
    * @license        https://www.dedebiz.com/license
    * @link           https://www.dedebiz.com
    */
   $dede_field = $cfg_version == '5.7' ? $arc : $this;
   $thread_key = $dede_field->id;
   $title = $dede_field->title;
   $url = $cfg_cmsurl.$arc->ArcUrl;
   require_once(DEDEINC.'/dedetemplate.class.php');
   $dtp = new DedeTemplate();
   $dtp->LoadTemplate($cfg_basedir.$cfg_templets_dir.'/'.$cfg_df_style.'/duoshuo.htm');
   $dtp->Display();
   ?>

   • 你还需要在 /templets/你的模板目录/ 下创建一个 duoshuo.htm 文件，内容就是多说的那段 JS 代码，并使用 PHP 变量：

   <!-- duoshuo.htm -->
   <div class="ds-thread" data-thread-key="<?php echo $thread_key; ?>" data-title="<?php echo $title; ?>" data-url="<?php echo $url; ?>"></div>
   <!-- 多说评论框 end -->
   <!-- 多说公共JS代码 start (一个网页只需插入一次) -->
   <script type="text/javascript">
   var duoshuoQuery = {short_name:"你的多说ShortName"};
   (function() {
       var ds = document.createElement('script');
       ds.type = 'text/javascript';ds.async = true;
       ds.src = (document.location.protocol == 'https:' ? 'https:' : 'http:') + '//static.duoshuo.com/embed.js';
       ds.charset = 'UTF-8';
       (document.getElementsByTagName('head')[0] 
        || document.getElementsByTagName('body')[0]).appendChild(ds);
   })();
   </script>
   <!-- 多说公共JS代码 end -->

   • 请将 你的多说ShortName 替换成你自己的。

4. 更新网站缓存：

   • 在后台 系统 -> 性能选项 -> 更新网站缓存,点击一键更新。

完成以上步骤后，你的 Dedecms 文章页下方就应该能正常显示多说评论框了。

第二部分：多说关闭后的解决方案（重要！）

由于多说已经关闭，你的评论功能已经失效，以下是几种可行的解决方案,按推荐度排序：

迁移到 Valine（强烈推荐）

Valine 是一个基于 LeanCloud 的快速、简洁且功能强大的评论系统，它无后端、免部署,非常适合个人博客。

优点：

• 免费额度高（每月每天10万次请求，足够个人网站使用）。
• 界面美观，支持 Markdown。
• 无需服务器，管理后台在 LeanCloud 上。
• 社交登录（如 GitHub、微博等）。

迁移步骤：

1. 注册 LeanCloud：访问 LeanCloud 国际版 或 LeanCloud 国内版 注册并登录。

2. 创建应用：在控制台创建一个新的应用。

3. 获取 App ID 和 App Key：在应用的 设置 -> 应用凭证 中找到 App ID 和 App Key。

4. 创建 Class：在 存储 -> 数据 中，创建一个 Class，命名为 Comment（必须大写），无需设置任何列，Valine 会自动处理。

5. 配置网站：

   • 下载 Valine 的最新文件（通常是一个 valine.min.js）。
   • 在你的 Dedecms 模板文件（如 article_article.htm）中,删除多说相关的所有代码。
   • 在评论位置插入以下代码：

   <div id="vcomments"></div>
   <script src="https://cdn.jsdelivr.net/npm/valine@1.5.1/dist/Valine.min.js"></script>
   <script>
       new Valine({
           el: '#vcomments',
           appId: '你的App ID',
           appKey: '你的App Key',
           placeholder: 'Just go go', // 评论框占位符
           avatar: 'robohash', // 头像样式
           meta: ['nick','mail','link'], // 评论者额外输入的信息
           pageSize: 10, // 每页显示评论数
           lang: 'zh-cn', // 语言
           recordIP: true, // 是否记录IP
           serverURLs: '你的服务器地址' // 如果是国内版LeanCloud，需要填写这个
       });
   </script>

   • 将 你的App ID 和 你的App Key 替换成你自己的。

6. 更新网站：更新 Dedecms 缓存,访问文章页即可看到新的评论框。

迁移到 Gitalk

Gitalk 是一个基于 GitHub Issue 的评论系统,非常适合有技术背景的用户。

优点：

• 评论数据与 GitHub Issue 绑定,永久保存。
• 支持 Markdown。
• 无需后端服务。

缺点：

• 用户必须拥有 GitHub 账号才能评论。
• 需要创建一个 GitHub OAuth App。

使用第三方商业评论系统（如畅言）

畅言是腾讯推出的商业评论系统,目前仍在稳定运行。

优点：

• 稳定可靠,有官方支持。
• 功能强大，如举报、审核等。

缺点：

• 商业服务,可能需要付费或在评论区显示广告。
• 需要在官网注册并获取代码,然后替换掉多说代码。

寻找其他 Dedecms 评论插件

你可以在 Dedecms 官方论坛、资源站或 GitHub 上搜索是否有其他开发者维护的评论插件，例如基于原生 PHP 的评论系统。

最终建议：立即放弃多说，选择 Valine 作为你的新评论系统，它简单、免费且功能强大，是目前个人博客的最佳选择之一，迁移过程虽然需要一些手动操作，但一劳永逸,能确保你的网站评论功能长期可用。