phpcms v9文章模型栏目接口第四版
检查接口说明
-
1、接口文件名etchk_cms.php,为保密,请自行修改文件名;
2、本接口文件复制在网站根目录下使用,如果目录名有变更,请自行对应;
3、主要参数
title
文章标题;
catid
栏目ID号,用于限定检查栏目范围,必填,可在后台网站栏目管理处查看id;
siteid
站点ID号,用于指定栏目所属站点,选填,留空则默认站点ID为1,可在网站后台-设置-站点管理中查看ID;
vercode
安全校验码,请自行设定,并在检查接口文件源代码开始处修改vercode使其一致;
4、发布配置-文章检查网址处,可以如下填写:
http://您的网址/ etchk_cms.php?vercode=&catid=您的栏目ID&siteid=&title=<%title%>
注:使用大小写敏感的服务器的用户请注意网址大小写和网站文件一致
5、接口文件无须任何改动即可使用,如果你希望增加校验或其他功能,请仔细修改;
检查接口代码
发布接口说明
-
1、接口文件名etpost_cms.php,为保密,请自行修改文件名;
2、本接口文件请复制在网站根目录下使用,如果目录名有变更,请自行对应;
注1、以下参数中,格式为info[字段名]参数,其中字段名必须在栏目的模型数据表中存在,如果不存在的字段,不能使用该参数;用户自定义的字段,可以用同样格式的参数使用。
注2:以下参数名后“=”号为示范取值而用,参数名本身不含“=”号;
参数项,请在发布规则-发布项中添加,如图:
3、基本参数
username
会员名参数名
password
密码参数名
info[title]
主题标题参数名,最大40字(80字符)
info[content]
内容参数名。
4、主要参数
siteid
站点ID,可再网站后台站点管理处查看,选填,留空则默认为1;
info[catid]=
主栏目ID,可在后台网站栏目管理处查看该id,必填;
othor_catid[栏目ID]=1
同时发布到其他栏目,例如othor_catid[7]=1 表示将文章同时发布到ID为7的栏目,此参数可以设置多个,每个换行单独设置,可选用,必须为相同站点栏目。
info[keywords]
关键词,留空则自动获取。
info[copyfrom]=
文章来源,可留空。
info[description]
内容摘要,最大127字(255字符),可留空;可设置参数add_introduce进行自动获取。
5、可选参数
info[islink]=0
是否转向链接,1为是,0为否,留空默认为0;配合参数linkurl使用。
linkurl
转向链接网址。
add_introduce=1
是否自动摘要,1为是,0为否,留空为0;配合参数introcude_length使用。
introcude_length=200
自动摘要字符数,配合add_introduce使用;留空默认为200字符。
info[thumb]
标题缩略图,可留空,可设置参数auto_thumb进行自动获取。
auto_thumb=1
是否自动获取标题缩略图,1为是,0为否,留空为0;配合参数auto_thumb_no使用。
auto_thumb_no=X
自动获取第X张图片为标题缩略图片,格式如“auto_thumb_no=1”,配合auto_thumb使用;留空默认为1。
info[paginationtype]=0
分页模式,0为不分页,1为自动分页,2为手动分页,留空默认为0。
phpcms分页符为“[page]”,带标题分页符为“[page]标题[/page]”,当用户选择分页模式为手动分页时,可以使用ET的数据整理功能将ET分隔标记#-0-# 替换为phpcms分页符 进行自动分页,可保持和原文相同分页。
注:因phpcms v9 自动分页功能BUG较多,不建议用户使用自动分页方式,推荐使用上述手动分页模式。
info[maxcharperpage]=1000
自动分页每页字符数(包含HTML标记),配合自动分页模式使用,留空默认为1000。
info[posids][]=1
首页焦点图推荐,可与其他推荐同时使用,留空不做本推荐。
info[posids][]=2
首页头条推荐,可与其他推荐同时使用,留空不做本推荐。
info[posids][]=9
网站顶部推荐,可与其他推荐同时使用,留空不做本推荐。
info[posids][]=10
栏目首页推荐,可与其他推荐同时使用,留空不做本推荐。
info[posids][]=12
首页图片推荐,可与其他推荐同时使用,留空不做本推荐。
groupids_view[]=1
阅读权限:禁止访问,可与其他权限同时使用。
groupids_view[]=8
阅读权限:游客,可与其他权限同时使用。
groupids_view[]=2
阅读权限:新手上路,可与其他权限同时使用。
groupids_view[]=6
阅读权限:注册会员,可与其他权限同时使用。
groupids_view[]=4
阅读权限:中级会员,可与其他权限同时使用。
groupids_view[]=5
阅读权限:高级会员,可与其他权限同时使用。
groupids_view[]=7
阅读权限:邮件认证,可与其他权限同时使用。
info[relation]
相关文章,格式为 “文章id1|文章id2|文章id3|文章id……”
info[inputtime]
发布时间,标准时间格式,例“2012-02-25 11:23:55”,留空为当前时间。
info[template]
内容页模板,留空为栏目默认模板,若要使用非默认模板,取值参见网站管理后台添加文章的内容页模板选项源代码;
info[allow_comment]=1
是否允许评论,1为允许,0为否,留空默认为1。
info[readpoint]=
阅读收费数额,留空为不收费。
info[paytype]=0
阅读收费数额类型,0为点,1为元,留空默认为0。
status=99
发布状态,99为直接发布,1为审核。
style_color=
标题颜色,格式例如:红色为“#FF0000”,留空为默认色。
style_font_weight=bold
标题加粗,留空为不加粗
6、图片附件
如果不启用ET的文件下载上传功能,本接口也会自动下载远程附件为网站本地文件(phpcmsv9的特性)。
启用ET的文件下载上传功能时,发布规则中的文件显示url应填为“http://您的网站/uploadfile/”(您的网站请自行替换)。
如果不启用ET的文件下载上传,并且没有启用接口的自动获取缩略图参数,而是指定了缩略图info[thumb]的地址,那么此时缩略图为引用对方网址,不是自动下载到网站后的本地网址。
启用ET文件下载上传时,制定方案里发布顺序必须使用“先上传文件”;
7、自定义字段
本接口支持自定义字段,自定义字段参数名格式如下:
info[自定义字段名]
使用方法和其他参数相同,可在参数取值中设固定值,或在发布项对应采集规则数据项。
8、发布配置-发布网址处,可以如下填写:
http://您的网址/etpost_cms.php
注:使用大小写敏感的服务器的用户请注意网址大小写和网站文件一致
9、接口文件无须任何改动即可使用,如果你希望增加校验或其他功能,请仔细修改;
发布接口代码
发布规则使用说明
在ET采集软件发布配置的规则列表使用鼠标右键菜单导入本发布规则代码。
1、将发布规则导入到软件发布配置中;2、按接口说明书图示,设置如栏目ID、站点ID、用户网站等信息;
3、范例为UTF8编码,GBK编码网站在编码转换处选不使用;
常见错误:
当提示采集失败时,请查看返回信息了解错误详情,以便改正。
一、返回信息中有类似提示“MySQL Error : Unknown column '字段名' in 'field list' ”
说明使用了数据表中不存在的字段作为参数,请检查发布项的info[字段名]格式的参数,与栏目所属模型的数据表不一致的,请删掉。
二、[err]账号密码错误[/err]
1、检查发布规则-参数取值-账号密码队列;
三、[err]invalid vercode[/err]
1、在发布规则-检查网址中填写的vercode 值和检查接口文件中的vercode值不一致;
2、在发布规则-参数取值-附件参数队列中填写的vercode值和发布接口文件中的vercode值不一致;
ET采集2发布规则范例
(请使用 CTRL+A 和 CTRL+C 从上栏复制规则)
免责声明:自在工坊网站所展示的作品信息由用户自行提供,其真实性、准确性和合法性由信息发布人负责。自在工坊不提供任何保证,并不承担任何法律责任。