Phpwind 8.0论坛多功能接口第二版(附件入库、分类信息、随机栏目)
检查接口说明
-
1、接口文件名etchk_bbs.php,为保密,请自行修改文件名;
2、本接口文件复制在网站根目录使用,如果目录名有变更,请自行对应;
3、主要参数
keyword 文章标题
fid 论坛版块ID,用于限定本规则的检查版块,可以填写多个(英文逗号分隔),也可以为空,格式如fid=47,48,49;
vercode 校验码,请自行设定,并在检查接口文件开始处修改$vercode使其一致;
4、发布配置-文章检查网址处,可以如下填写:
http://您的网址/etchk_bbs.php?vercode=&keyword=<%title%>&fid=
注:使用大小写敏感的服务器的用户请注意网址大小写和网站文件一致
5、接口文件无须任何改动即可使用,如果你希望增加校验或其他功能,请仔细修改;
检查接口代码
发布接口说明
-
1、接口文件名etpost_bbs.php,为保密,请自行修改文件名;
2、本接口文件请复制在网站根目录下使用,为保密,请自行修改文件名;
注:以下参数名后“=”号为示范取值而用,参数名本身不含“=”号;
固定取值的参数,可以在发布规则-参数取值中设置;
采集取值的参数项,请在发布规则-发布项中添加;
3、主要参数
fid 论坛版块ID,可以填写多个(英文逗号分隔),格式如fid=37,38,39
pwuser 会员名参数名
pwpwd 密码参数名
atc_title 主题标题参数名
atc_content 内容参数名;
4、附加参数
vercode 安全校验码,请自行设定,本项用以防止接口被他人利用,如果需要进行更多校验,请自行填加相关代码。
5、可选参数
etattachs 文件列表发布参数名,可不填,不填则不启用附件入库,如下图:
使用本参数时,在方案中应选择发布顺序为“先上传文件”,如图:
att_special=2 附件访问类型,1为加密,2为出售,0或留空为公开;
att_ctype=money 附件访问条件,money为铜币、rvrc为威望,credit为贡献值,currency为银元,1为好评度
att_needrvrc=0 附件访问条件对应数量,0为公开,如图:
atc_tags 标签,可留空,留空则按网站后台的标签库,自动分析标签;
zzmins=5 回复间隔分钟上限,单位分钟,将在上限内随机产生;
zzhours=1 主题时间倒退小时,单位小时,如下图:
p_type= 主题分类编号,如论坛未设必选主题分类,可以不用
p_sub_type= 主题子分类编号,可以不用
atc_iconid=0 主题图标ID,取值范围0-8,请对照发帖界面;
atc_autourl=1 自动分析URL开关,0为关闭,1为开启;
atc_usesign=1 使用签名开关,0为关闭,1为开启;
atc_convert=1 wincode转换开关,0为关闭,1为开启,当关闭时,文章内的[post]、[sell]等代码不可用;
atc_hide=0 隐藏此帖开关(回复可见),0为关闭,1为开启;
atc_hideatt=0 隐藏附件开关(回复可见),0为关闭,1为开启,本版接口无效;
atc_anonymous=0 匿名发帖开关,0为关闭,1为开启;
digest=0 是否精华,0为否,1为是;
topped=0 是否置顶,0为否,1为是;
replayorder=0 回复显示顺序,0默认,1正序,2倒序;
atc_requiresell=0 是否出售本帖,0为否,1为是;
atc_money=0 出售价格
atc_credittype=money 出售单位
atc_requireenhide=0 是否加密,0为否,1为是;
atc_rvrc=0 加密可见等级
atc_enhidetype= 加密可见单位
atc_newrp=0 回复站内通知,0为否,1为是;
6、可在正文中使用的特殊代码
PW使用了一些特殊代码,使正文内容产生各种效果,下面对此做一些介绍:
1、post 隐藏部分内容,格式[post]内容[/post];
2、sell 出售部分内容,格式[sell=5]内容[/sell],这里的5是价格;
3、code 显示内容为代码样式,格式[code]内容[/code];
4、quote 显示内容为引用样式,格式[quote]内容[/quote];
5、rm 播放RM影音文件,格式[rm=314,256,1]文件网址[/rm],1表示立即播放, 0不播放,314和256为显示尺寸;
6、wmv 播放wmv、MP3音文件,格式[wmv=314,256,1]文件网址[/wmv],1表示立即播放,0不播放,314和256为显示尺寸;
7、flash 播放flash,格式[flash=314,256,1]文件网址[/flash],1表示立即播放,0不播放,314和256为显示尺寸;
7、分类信息
本接口支持在论坛发布分类信息帖子,由于分类信息使用用户自己定义的参数字段,因此用户需要查看文件源码,了解各项信息对应的参数名(可打开PW论坛发帖网页的源代码查看),下面以PW8官方默认的分类信息模板为例,介绍相关参数:
A、PW8官方默认模板分类信息-房屋出租:
modelid=1 分类ID,本模板为1,必填参数;
楼盘名称 topic[1] 必须项;
房屋类型 topic[4] 必须项;
价格 topic[3] 必须项;
区域 topic[2] 必须项;
租赁类型 topic[5] 必须项;
来源 topic[6] 必须项;
所在楼层 topic[7]
总楼层 topic[8]
建筑面积 topic[9]
建筑年代 topic[10]
最短租期 topic[19]
特色房屋 topic[11]
装修情况 topic[12]
户型室 topic[20]
户型厅 topic[21]
户型卫 topic[22]
户型阳台 topic[23]
电话区号 topic[13]
电话号码 topic[14]
手机 topic[15]
地址 topic[16]
有效期 topic[17]
房屋图片 topic[18] 图片相对地址;
字段中有部分为数字类型,建议利用《ET技巧-文章栏目自动分类》中介绍的自动匹配方法,将采集到的文字转换为数字;
本接口包内附有《phpwind 8.0论坛-房屋出租分类信息(默认模板)范例发布规则》,用户可以导入使用;
B、PW8官方默认模板分类信息-美食:
modelid=4 分类ID,本模板为4,必填参数;
店名 topic[68] 必须项;
经营性质 topic[69] 必须项;
美食分类 topic[70] 必须项;
区域 topic[71] 必须项;
电话区号 topic[72]
电话号码 topic[73]
地址 topic[74]
公交 topic[75]
车位 topic[76]
起始营业时间 topic[77]
结束营业时间 topic[78]
营业状态 topic[79]
店铺图片 topic[80] 图片相对地址;
字段中有部分为数字类型,建议利用《ET技巧-文章栏目自动分类》中介绍的自动匹配方法,将采集到的文字转换为数字;
本接口包内附有《phpwind 8.0论坛-美食分类信息(默认模板)范例发布规则》,用户可以导入使用;
8、发布配置-文章发布网址处,可以如下填写:
http://您的网址/etpost_bbs.php
注:使用大小写敏感的服务器的用户请注意网址大小写和网站文件一致
9、接口文件无须任何改动即可使用,如果你希望增加校验或其他功能,请仔细修改;
发布接口代码
回复接口说明
-
1、接口文件名etreply_bbs.php,为保密,请自行修改文件名;
2、本接口文件请复制在网站根目录下使用,为保密,请自行修改文件名;
3、本接口文件不能独立使用,必须配合发布接口文件etpost.php使用。
4、要使用本回复,请确认对应的采集规则-正文数据项“匹配多条正文”选项有效;
5、发布配置-文章回复网址处,可以如下填写:
http://您的网址/etreply.php
注:使用大小写敏感的服务器的用户请注意网址大小写和网站文件一致
6、接口文件无须任何改动即可使用,如果你希望增加校验或其他功能,请仔细修改;
回复接口代码
发布规则使用说明
在ET采集软件发布配置的规则列表使用鼠标右键菜单导入本发布规则代码。
1、要启用附件入库,请在发布配置-发布项-“文件列表发布参数名”处填写参数名“etattachs”;
2、启用附件入库,必须在方案中选择发布顺序为“先上传文件”;
3、要回复接口,请确认对应的采集规则-正文数据项“匹配多条正文”选项有效;
4、自动回复时将从账号密码队列中随机选择用户;
5、本范例发布对象网站编码为GBK, 当本接口应用于utf8版网站,请在发布规则中选择编码为UTF-6, 当本接口应用于BIG5版网站时,如果采集来源网页是简体GB2312编码,则请在发布规则中选择编码转换为简体转繁体。
7、使用分类信息范例时,请保证你的分类信息字段未曾删改过,否则请调整参数名 ;
常见错误:
当提示采集失败时,请查看返回信息了解错误详情,以便改正,返回信息窗见下图:
一、[err]账号密码错误[/err]
1、检查发布规则-参数取值-账号密码队列;
二、[err]invalid vercode[/err]
1、在发布规则-检查网址中填写的vercode 值和检查接口文件中的vercode值不一致;
2、在发布规则-参数取值-附件参数队列中填写的vercode值和发布接口文件中的vercode值不一致;
三、[err] cms_subject is null[/err]:
1、使用的采集规则未能正确采集到标题;
2、采集规则的数据整理将标题过滤了;
3、错误的修改了发布规则-发布项中的标题参数名,正确的参数名请看本文接口说明部分;
4、发布规则未开启utf-8编码转换;
四、[err]内容不能为空[/err]:
1、使用的采集规则未能正确采集到正文数据项;
2、采集规则的数据整理将正文数据过滤了;
3、错误的修改了发布规则-发布项中的正文参数名,正确的参数名请看本文接口说明部分;
4、发布规则未开启utf-8编码转换;
五、[err]fid is null[/err]:
1、fid参数的值或格式错误;
六、文章乱码:
1、发布规则未开启utf-8编码转换;
2、数据整理不当;
七、附件上传不成功:
1、检查附件保存路径和格式是否正确
2、检查附件是否存在
3、检查FTP目录和权限设置;
八、图片不显示:
1、检查发布规则 文件显示URL设置;
2、如果启用FTP上传,则文件显示URL和FTP上传目录应一致;
3、如果使用保存目录而未使用FTP上传,则文件显示URL应和方案的文件保存目录一致;
九、[err]First upload files[/err]:
在方案中没有选择“先上传文件”;
ET采集2发布规则范例
(请使用 CTRL+A 和 CTRL+C 从上栏复制规则)
免责声明:自在工坊网站所展示的作品信息由用户自行提供,其真实性、准确性和合法性由信息发布人负责。自在工坊不提供任何保证,并不承担任何法律责任。