多说自定义导入格式说明

在多说后台 - 工具 - 导入数据 可以把当前站点已有的文章和评论数据导入多说。 ![多说导入功能] (http://blog.duoshuo.com/wp-content/uploads/2013/02/tools-import.jpg)

多说接受JSON格式的评论数据。注意,以下示例数据中,第二条评论因缺少必要的文章参数,第三条评论因缺少对应的文章数据不会被导入

另请注意,给所有的参数名,如threads,加上双引号,否则会因json解析失败而不导入。

{
    "threads":
    [{
        "author_key" : "1",
        "thread_key" : "500d0629448f04782b00000a",
        "title" : "多说自定义导入格式说明",
        "url" : "http://duoshuo.com/01/",
        "content" : "文章内容"
    },
    {
        "author_key" : "2",
        "thread_key" : "500d0629448f04782b00000b",
        "title" : "多说导出文件说明",
        "url" : "http://duoshuo.com/02/",
        "content" : "文章内容"
    }],
    "posts":
    [{
        "author_key" : "1",
        "post_key" : "在原站点中的评论id",
        "thread_key" : "500d0629448f04782b00000a",
        "parent_key" : "2255",
        "author_name" : "Perchouli",
        "author_email" : "jp.chenyang@gmail.com",
        "author_url" : "http://duoshuo.com",
        "created_at" : "2012-07-23 14:13:55",
        "agent" : "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/535.2...",
        "ip" : "127.0.0.1",
        "likes" : "0",
        "reports" : "0",
        "message" : "评论测试",
        "status":"approved"
    },
    {
        "author_name" : "多说小武",
        "created_at" : "2012-07-23 14:13:55",
        "message" : "这是一条缺少必须的thread_key和post_key参数的评论,将无法正常导入"
    },
    {
        "post_key" : "3",
        "thread_key" : "201",
        "author_name" : "多说小武",
        "created_at" : "2012-07-23 14:13:55",
        "message" : "这是一条缺少对应文章信息的评论,将无法正常导入"
    }]
}

threads——主题信息

必须属性

thread_key: 文章在原站点中的id

title: 文章标题

url: 文章的URL地址

可选属性

content:文章内容

author_key: 文章作者在原站点中的用户id

excerpt: 文章摘要

comment_status: [open/close]文章是否开启评论

likes:文章被【喜欢】的次数,该属性导入意义不大,会在被喜欢之后重新统计

views:文章被查看的次数

posts——评论信息

必须属性

post_key:这条评论在当前站点的ID

thread_key:这条评论所对应文章在当前站点的ID

message: 评论内容

可选属性

post_id:对于从多说导出的数据,再次导入多说,会根据此id进行匹配,自动忽略post_key参数

parent_key:父级评论在当前站点的ID

author_key:评论者在当前站点的ID

author_name:评论者的用户名

author_email:评论者的邮箱,如果没有设置头像会根据这个信息从gravatar获取头像

author_url:评论者的URL,点击评论者头像或者名字会跳转到改URL

ip:评论者的IP

agent:评论者User Agent信息,通常包括浏览器版本、引擎、设备等信息

likes:这条评论被【赞】的次数,该属性导入意义不大,会在被喜欢之后重新统计

reports:对这条评论点了【举报】的次数

created_at:评论发表时间。请注意时间的格式为yyyy-mm-dd hh:MM:ss。如2012/12/12 12:12:122012-1-12 12:12:12的格式,都不会被成功识别,第二个时间是因为月份应为01

status:评论状态。支持:approved:已通过,pending:待审核,deleted:已删除。不建议将已删除数据导入多说,会在到期30天之后自动从数据库中清除。

以下是一张的截图说明格式各个值实际的用途:

![多说自定义导入格式说明] (http://dev.duoshuo.com/img/json-format.png)

常见的没有成功导入的几种情况

  1. 文件必须使用utf8格式,并且不带utf8-bom。使用其他格式或带utf8-bom将导致导入0条评论。

  2. 导入时没有相应文章信息。评论导入需要相应thread_sid或thread_key的文章存在,才能导入成功。

  3. 从站点系统导出时,请使用相应的json生成函数,以便对双引号",换行符"\n\r"等进行转义处理,否则可能在转化时无法识别

情况1的可行解决方法:

【第一步】使用Notepad++编辑器打开未成功导入的json文件,选择“编辑”—>"档案格式转换"—>选择“转换为UNIX格式”。

【第二步】“格式”—>选择"以UTF-8 无BOM格式编码"后保存文档,重新导入。