接口使用说明

Discuz X2.0门户文章接口使用手册 一、简介 1、本接口应用于discuz! X2.0门户文章频道发布； 2、本接口支持自动生成封面图片，详见参数etattachs的说明； 3、本接口支持图片水印、远程附件，在DZX后台开启即可； 4、由于用户可能同时使用discuz! x2.0的多种接口，请注意修改接口名称，使每种接口区别； 5、在discuz! X2 utf8版使用本接口时，请在发布规则中选择编码为UTF-8； 6、本接口基于discuz! X2 UTF8版制作，适用于discuz! X2 GBK/utf-8等版本，应用于其他版本时请自行测试调整； 7、接口文件无须任何改动即可使用，如果你希望增加校验或其他功能，请仔细修改； 8、2个接口文件请复制在discuz! X2网站根目录下使用； 二、安装接口 在接口文件夹中找到接口文件，如图： 请将etchk.php、etpost.php、等接口文件上传到指定目录，请使用二进制方式上传，如图： 三、配置发布规则 1、将范例发布规则文本导入ET2发布配置，或使用软件内置发布规则范例，如图： 2、将检查网址和发布网址中的“您的网站”改为您要发布的网站网址，如图： 3、在参数取值页，填上您要发布的频道ID，如图： 打开门户管理发布文章页面，可以查看频道ID，即catid的值： 5、填上您的账号、密码，注意格式和账号权限（账号应有门户频道管理权限），如图： 四、接口说明 一、检查接口 1、接口文件名etchk.php，为保密，请自行修改文件名； 2、本接口文件复制在网站根目录下使用； 3、主要参数 　　文章标题：title　 　　分类ID　：catid　　　用于限定检查范围，可不填，请对照管理中心查看分类ID； 　　校验码　：vercode　　请自行设定，并在检查接口文件开始处修改vercode使其一致； 4、发布配置-文章检查网址处，可以如下填写： 　　http://您的网址/etchk.php?vercode=&catid=&title=<%title%> 　　注：使用大小写敏感的服务器的用户请注意网址大小写和网站文件一致 5、接口文件无须任何改动即可使用，如果你希望增加校验或其他功能，请仔细修改； 二、发布接口 1、 接口文件名etpost.php，为保密，请自行修改文件名； 2、本接口文件请复制在网站根目录下使用； 注：以下参数名后“=”号为示范取值而用，参数名本身不含“=”号； 　　固定取值的参数，可以在发布规则-参数取值中设置； 　　采集取值的参数项，请在发布规则-发布项中添加； 3、必填参数 　　username 会员名参数名 password 密码参数名 title 主题标题参数名 　　content 内容参数名（若要进行分页请在数据整理中将ET2正文分隔标记“#-0-#”替换为discuz! x分页标记“###NextPage###”或“###NextPage[title=分页标题]###”） 4、主要参数 　　catid 文章分类编号(请对照管理中心文章分类) 　　vercode 安全校验码，请自行设定，本项用以防止接口被他人利用，如果需要进行更多校验，请自行填加相关代码。 ashowurl= 门户文件显示URL，默认值/data/attachment/portal，通过本参数可支持更改默认附件目录以及远程文件，取值与网站后台-上传设置对应； 5、其他参数 etattachs 文件列表参数名，若要使用自动提取第一幅jpg图片为封面图片必须填写； pic 封面图片，如果你要发布封面图片，请在 方案 气瓶 现场处置方案 .pdf气瓶 现场处置方案 .doc见习基地管理方案.doc关于群访事件的化解方案建筑工地扬尘治理专项方案下载 中选择发布顺序为“先上传文件”，可自动生成缩略图，当使用远程附件时无法生成缩略图； pagetitle 分页标题 dateline 发布时间，标准日期格式，留空为当前时间 summary = 文章摘要，不使用则自动摘要； author 文章作者； from 文章来源 fromurl 来源地址 url 跳转URL； raids[] 相关文章，取值为文章id，如 raids[]=12 表示设置ID为12的文章作为相关文章，多篇相关文章格式如下： raids[]=12 raids[]=34 raids[]=112 tag[1]　　　聚合标签1，设值为1即可启用，如在附加参数中填写“tag[1]=1"，不用则留空； 　　tag[2]　　　聚合标签2，设值为1即可启用，如在附加参数中填写“tag[2]=1"，不用则留空； 　　tag[3]　　　聚合标签3，设值为1即可启用，如在附加参数中填写“tag[3]=1"，不用则留空； 　　tag[4]　　　聚合标签4，设值为1即可启用，如在附加参数中填写“tag[4]=1"，不用则留空； 　　tag[5]　　　聚合标签5，设值为1即可启用，如在附加参数中填写“tag[5]=1"，不用则留空； 　　tag[6]　　　聚合标签6，设值为1即可启用，如在附加参数中填写“tag[6]=1"，不用则留空； 　　tag[7]　　　聚合标签7，设值为1即可启用，如在附加参数中填写“tag[7]=1"，不用则留空； 　　tag[8]　　　聚合标签8，设值为1即可启用，如在附加参数中填写“tag[8]=1"，不用则留空； 6、封面图片 如果用户未使用Pic参数指定采集封面图片，则自动提取文件列表中第一幅jpg图片为封面缩略图； 如果需要指定封面图片，用户使用的采集规则应有一个数据项来采集一个作为封面图片的图片网址，并在发布规则-发布项-其他发布项中将该数据项与参数pic对应； 要使用自动提取封面图片功能必须开启对应采集规则的文件下载； 网站的门户水印设置对ET上传的图片有效。 7、附件 　　附加参数ashowurl（即门户文件显示URL）的值应与“发布规则-基本设置-文件显示URL”相同； 文件显示URL的值，应与用户网站后台-上传设置-基本设置-附件 URL 地址对应，默认值是“/data/attachment/portal”； 当网站更改了上传设置-附件 URL 地址时，该值应等于“附件 URL 地址”+“/portal”； 当网站启用了远程附件时，该值应等于“远程附件-远程访问 URL”+“/portal”； 使用远程附件时，不支持生成缩略图； 8、发布配置-文章检查网址处，可以如下填写： 　　http://您的网址/etpost.php 　　注：使用大小写敏感的服务器的用户请注意网址大小写和网站文件一致 9、接口文件无须任何改动即可使用，如果你希望增加校验或其他功能，请仔细修改； 五、范例发布规则 1、 请根据发布网站的编码选择编码转换方式，GBK为不转换，如图： 2、本接口不需要启用UBB代码格式转换； 六、常见错误： 当提示采集失败时，请查看返回信息了解错误详情，以便改正，返回信息窗见下图： 一、[err]账号密码错误[/err] 1、检查发布规则-参数取值-账号密码队列； 二、[err]invalid vercode[/err] 1、在发布规则-检查网址中填写的vercode 值和检查接口文件中的vercode值不一致； 2、在发布规则-参数取值-附件参数队列中填写的vercode值和发布接口文件中的vercode值不一致； 三、[err] subject is null[/err]： 1、使用的采集规则未能正确采集到标题； 2、采集规则的数据整理将标题过滤了； 3、错误的修改了发布规则-发布项中的标题参数名，正确的参数名请看本文接口说明部分； 4、发布规则未开启utf-8编码转换； 四、[err]内容不能为空[/err]： 1、使用的采集规则未能正确采集到正文数据项； 2、采集规则的数据整理将正文数据过滤了； 3、错误的修改了发布规则-发布项中的正文参数名，正确的参数名请看本文接口说明部分； 4、发布规则未开启utf-8编码转换； 五、文章乱码： 1、发布规则未开启utf-8编码转换； 2、数据整理不当； 六、附件上传不成功： 1、检查附件保存路径和格式是否正确 2、检查附件是否存在 3、检查FTP目录和权限设置； 七、图片不显示： 1、检查发布规则 文件显示URL设置； 2、如果启用FTP上传，则文件显示URL和FTP上传目录应一致； 3、如果使用保存目录而未使用FTP上传，则文件显示URL应和方案的文件保存目录一致；