评论框调用代码参数说明

在插入通用代码时,可以增加一些参数,来让页面在加载的时候,按定义生成评论框

<!-- Duoshuo Comment BEGIN -->
    <div class="ds-thread" data-thread-key="文章在原站点中的id或其他唯一标识" data-title="您的文章标题" ></div>
    <script type="text/javascript">
    ...//javascript部分略去
    </script>
<!-- Duoshuo Comment END -->

上面的通用代码,与您在代码获取页面看到的相比,增加了以下参数:

  • data-thread-key string 推荐

    文章在原站点中的id或其他唯一标识。通用代码中,将您站点中的文章id告知我们,是区分文章,解决分页问题的好方法,评论回流时,也以此来定位原站点文章,同id的文章,显示的是相同的评论内容。data-thread-key中:,即冒号和逗号有特别的用途,请不要使用url或其他有这两个符号的内容作为data-thread-key。同时也请尽量避免将data-thread-key设作0、空字符串或中文。示例:在typecho建站系统中,data-thread-key="<?php echo $this->cid;?>",phpcms中data-thread-key="{id_encode("content_$catid",$id,$siteid)}",如果您在独立静态页中使用,可以自己设置合适的值,例如首页使用data-thread-key="index",我们在管理后台的“工具”选项卡里提供了更多建站类型的示例。

  • data-title string 推荐

    您的文章标题。对于通用代码,没有提前同步文章数据。如果您在后台管理看到的文章标题不正确,加入这个参数,让您在后台管理时更加便利

  • data-image string 推荐

    文章图片地址,将用于转发时的附图。

  • data-url string

    文章的url。第一次显示评论框时,我们会按这个参数标记文章。

    如果您改变了域名,或者希望几篇文章显示同一评论框,传递data-url即可解决

    例如之前一篇文章是链接地址是"http://abc.com/101.html" ,上面已经有100个评论,之后这篇文章有了分页,在这分页里加上data-url="http://abc.com/101.html" ,两个页面就都会显示相同的评论内容了。

    注意:在没有设置data-url项目时,我们优先采用页面中canonical标签值,如果没有设置canonical标签,则会使用页面的url。页面url会自动过滤#之后的参数。对于设置了不同的data-thread-key之后,还发现多篇文章出现相同评论的情况,请确认一下页面中的canonical标签是否重复。

    关于canonical标签,可以参考以下介绍:<a name="test" href="http://www.chinaz.com/web/2011/0630/192530.shtml" target="_blank" rel="no-follow">http://www.chinaz.com/web/2011/0630/192530.shtml</a>

  • data-author-key string 推荐

    作者在本站中的id。对于wordpress插件,文章如果填写该id,可以识别作者,在收到评论时,会对该作者发出邮件提醒。通用代码用户及其他插件,如果需要通过这种方式获取邮件,请通过 http://dev.duoshuo.com/docs/51435552047fe92f490225de 这个接口导入用户并且要有邮箱信息,指定的user_key就是此处要填的data-author-key

  • data-form-position string

    该页面中评论框的位置,取值top(评论框在顶端显示),bottom(评论框在底端显示)

  • data-limit int

    单页显示评论数,取值范围:1~200

  • data-order string

    //排序方式,取值:asc(从旧到新),desc(从新到旧)

这些参数,将覆盖站点的设定值,并且只对含该参数页面有效。当然,您在动态生成的页面中插入带参数的代码,则都是动态评论框了。