phpwind论坛多功能接口说明.docx
- 文档编号:26081868
- 上传时间:2023-06-17
- 格式:DOCX
- 页数:13
- 大小:76.31KB
phpwind论坛多功能接口说明.docx
《phpwind论坛多功能接口说明.docx》由会员分享,可在线阅读,更多相关《phpwind论坛多功能接口说明.docx(13页珍藏版)》请在冰豆网上搜索。
phpwind论坛多功能接口说明
Phpwind论坛多功能接口使用手册
一、简介
1、本接口应用于Phpwind版论坛文章、分类信息、团购信息等发布;
2、本接口支持完美附件入库,动态显示附件、出售/加密附件,见参数etattachs的说明;
3、本接口支持远程附件,在PW后台附件设置开启即可;
4、本接口支持随机栏目,可以仅使用一个发布规则指定多个版块,随机向各版块发布文章;
5、本接口可以拟真论坛帖子和回复时间期,使效果更真实,见参数zzmins、zzhours的说明;
6、本接口可以自动获得标签,见参数atc_tags的说明,使用本功能前请在PW后台设置标签库;
7、本接口支持整篇文章或部分内容售卖、隐藏、加密、回复可见等效果,见发布接口部分的说明;
8、本接口支持分类信息发布,请详见发布接口分类信息部分的说明;
9、本接口可自行控制使用UBB或HTML格式发布信息,见参数arc_html的说明;
10、由于用户可能同时使用Phpwind的多种接口,请注意修改接口名称,使每种接口区别,例如本接口包里提供的接口文件都加上了“bbs”的文件名后缀;
11、发布时请使用具备相关权限的用户帐号,例如分类信息权限、售卖权限;
12、在utf8版使用本接口时,请在发布规则中选择编码为UTF-8;
13、本接口基于UTF8版制作,适用于GBK/utf-8等版本,应用于其他版本时请自行测试调整;
14、接口文件无须任何改动即可使用,如果你希望增加校验或其他功能,请仔细修改;
15、3个接口文件请复制在Phpwind网站根目录下使用;
二、安装接口
在接口文件夹中找到接口文件,如图:
请将、、等接口文件上传到指定目录,请使用二进制方式上传,如图:
三、配置发布规则
1、将范例发布规则文本导入ET2发布配置,或使用软件内置发布规则范例,如图:
2、将检查网址和发布网址、回复网址中的“您的网站”改为您要发布的网站网址,如图:
3、在检查网址填上您要在其中检查文章是否重复的论坛版块ID,可以填多个,用英文逗号分隔,如果不限定版块,可以留空不填,如图:
4、在参数取值页,填上您要发布的目标论坛版块ID,可以填多个,用英文逗号分隔,如图:
打开论坛版块,可以在地址栏里查看版块ID,即FID的值:
5、填上您的账号、密码,注意格式和账号权限,如图:
6、可以选择是否使用UBB格式或HTML格式发布内容,如图:
使用UBB格式时,参数arc_html应设为0;不使用UBB格式时,参数arc_html应设为1,如图:
使用UBB格式可避免在编辑论坛帖子时像使用HTML格式时一样出现HTML代码;
四、接口说明
一、检查接口
1、接口文件名,为保密,请自行修改文件名;
2、本接口文件复制在网站根目录使用,如果目录名有变更,请自行对应;
3、主要参数
keyword文章标题
fid论坛版块ID,用于限定本规则的检查版块,可以填写多个(英文逗号分隔),也可以为空,格式如fid=47,48,49;
vercode校验码,请自行设定,并在检查接口文件开始处修改$vercode使其一致;
4、发布配置-文章检查网址处,可以如下填写:
注:
使用大小写敏感的服务器的用户请注意网址大小写和网站文件一致
5、接口文件无须任何改动即可使用,如果你希望增加校验或其他功能,请仔细修改;
二、发布接口
1、接口文件名,为保密,请自行修改文件名;
2、本接口文件请复制在网站根目录下使用,为保密,请自行修改文件名;
注:
以下参数名后“=”号为示范取值而用,参数名本身不含“=”号;
采集取值的参数项,请在发布规则-发布项中添加,如图:
固定取值的参数,可以在发布规则-参数取值中设置,如图:
3、基本参数
pwuser会员名参数名
pwpwd密码参数名
atc_title主题标题参数名
atc_content内容参数名;
etattachs 文件列表发布参数名,可不填,不填则不启用附件入库:
4、主要参数
Fid 论坛版块ID,必填,可以填写多个(英文逗号分隔),格式如fid=37,38,39
vercode安全校验码,请自行设定,本项用以防止接口被他人利用,如果需要进行更多校验,请自行填加相关代码。
atc_html 是否启用HTML代码,1为开启,0为关闭,关闭时需要勾选“使用UBB代码格式”;开启时取消“使用UBB代码格式”;
5、可选参数
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]图片相对地址;
字段中有部分为数字类型,建议利用中介绍的自动匹配方法,将采集到的文字转换为数字;
本接口包内附有《phpwind论坛-房屋出租分类信息(默认模板)范例发布规则》,用户可以导入使用;
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]图片相对地址;
字段中有部分为数字类型,建议利用中介绍的自动匹配方法,将采集到的文字转换为数字;
本接口包内附有《phpwind论坛-美食分类信息(默认模板)范例发布规则》,用户可以导入使用;
8、附件文件
如果需要附件入库,请使用参数etattachs,并在方案中选择“先上传文件”;
开启发布配置-文件上传,可将附件上传到附件目录(默认为/attachment),如果是在网站同一台电脑上运行ET,可不开启上传,在方案中设置文件保存目录为附件目录即可;
本接口附件入库,可根据PW后台设置任意以直链或动态链接形式显示附件,并支持远程附件,如果需要使附件回复可见,使用参数atc_hideatt即可;
当设置了附件入库并发布回复时,如果回复内容有重复(同一个回复信息里的重复不属于此类情况)的附件,由于PW的附件网址是可以变动的,所以无法直接引用第一次入库的附件地址,本接口将会为重复的附件也做一次入库,生成入库记录,但不会重复上传附件问文件,重复的附件都将使用同一个附件文件。
9、发布配置-文章发布网址处,可以如下填写:
注:
使用大小写敏感的服务器的用户请注意网址大小写和网站文件一致
10、接口文件无须任何改动即可使用,如果你希望增加校验或其他功能,请仔细修改;
三、回复接口
1、接口文件名,为保密,请自行修改文件名;
2、本接口文件请复制在网站根目录下使用,为保密,请自行修改文件名;
3、本接口文件不能独立使用,必须配合发布接口文件使用。
4、要使用本回复,请确认对应的采集规则-正文数据项(或单独设置的回复数据项)“匹配多条正文”选项有效;
5、发布配置-文章回复网址处,可以如下填写:
注:
使用大小写敏感的服务器的用户请注意网址大小写和网站文件一致
6、接口文件无须任何改动即可使用,如果你希望增加校验或其他功能,请仔细修改;
五、常见错误:
当提示采集失败时,请查看返回信息了解错误详情,以便改正,返回信息窗见下图:
一、[err]账号密码错误[/err]
1、检查发布规则-参数取值-账号密码队列;
二、[err]invalidvercode[/err]
1、在发布规则-检查网址中填写的vercode值和检查接口文件中的vercode值不一致;
2、在发布规则-参数取值-附件参数队列中填写的vercode值和发布接口文件中的vercode值不一致;
三、[err]cms_subjectisnull[/err]:
1、使用的采集规则未能正确采集到标题;
2、采集规则的数据整理将标题过滤了;
3、错误的修改了发布规则-发布项中的标题参数名,正确的参数名请看本文接口说明部分;
4、发布规则未开启utf-8编码转换;
四、[err]内容不能为空[/err]:
1、使用的采集规则未能正确采集到正文数据项;
2、采集规则的数据整理将正文数据过滤了;
3、错误的修改了发布规则-发布项中的正文参数名,正确的参数名请看本文接口说明部分;
4、发布规则未开启utf-8编码转换;
五、[err]fidisnull[/err]:
1、fid参数的值或格式错误;
六、文章乱码:
1、发布规则未开启utf-8编码转换;
2、数据整理不当;
七、附件上传不成功:
1、检查附件保存路径和格式是否正确
2、检查附件是否存在
3、检查FTP目录和权限设置;
八、图片不显示:
1、检查发布规则文件显示URL设置;
2、如果启用FTP上传,则文件显示URL和FTP上传目录应一致;
3、如果使用保存目录而未使用FTP上传,则文件显示URL应和方案的文件保存目录一致;
九、[err]Firstuploadfiles[/err]:
在方案中没有选择“先上传文件”;
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- phpwind 论坛 多功能 接口 说明