KingCMS调用详情.doc

KingCMS官方文章插件标签完全解析2007年10月31日 星期三 12:09官方的文章插件终于发布了，首先给Sin.CS道个辛苦；KingCMS5.0的文章插件和3.0区别不是很大，如果你对3.0版本很熟悉的话，相信你很快就能上手。KingCMS 通用文章标签king:article Article 标签开始 (HTML)循环输出部分/king 结束标签循环输出标签必须有标签 开始 如：king:article 和 结束 /king需要在模板中循环输出的的数据，如文章列表必须包含在开始和结束之间，内部循环标签要由( ) 小括号包围 Article标签参数解析*type参数如king:article type=new 为调用文章类型，type具有的值 new，related，hot ，commend，list ，sql new ：king:article type=new 最新添加的文章related ：king:article type=related 相关文章，与一个页面具有相同关键词keyword 的文章hot：king:article type=hot 热门，后台统计点击量，按点击量由最高到最低排列head ：king:article type=head 头条文章commend：king:article type=commend 推荐文章list ：king:article type=list 文章列表(只能在文章列表页的模板里调用，在其他非文章列表页如：文章内容页,但页面调用无效)sql ：king:article type=sql 直接输入sql调用文章，但必须要和sql属性配套使用，举例见下面type=sql用法这个需要你懂得文章插件的数据结构及sql命令才可以正常使用。king:article type=sql sql=where artshow=0 order by artid desc;(king:title/)/king需要注意的是，当type=sql的时候，必须有sql属性去设置sql代码，不然将调用最初加入的文章。上面的例子中调用的是最新加入的草稿文章其中头条，推荐只是文章的一个普通属性，两者之间只有名字不一样，其他属性值均相同，这两个属性是通过后台添加文章时手动控制在模板某一模块想显示改栏目下的某些特殊文章，那么就想该特殊文章的推荐或者头条选取，支持同时选择*number 循环调用文章的数量，必须为自然数，为0不输出数据无意义，可以不设置number则默认输出具有相同type参数的所有文章；实例：king:article type=new number=10 说明调用10篇最新文章*zebra 斑马线，必须为数字，如zebra=2，当第2、4、8等整除于zebra参数值的时候，输出1，其他输出0*order 排序，默认值为desc正序，最新添加的文章在最前面，要按id顺序输出，则设置值为asc倒序(跟以前版本正好相反,最早添加的文章在最前面)；限在type=list的时候有效*id (栏目id值，在后台栏目列表可以查看栏目的具体id)指定栏目调用，和3.0版本的union一样，支持多栏目同时调用，用英文逗号分开，该参数可以不设置则默认输出所有栏目下具有相同type参数的文章；同时注意5.0文章插件已将union更换为id ，3.0老用户注意区别实例：king:article type=new id=1 number=10 说明调用1栏目下10篇最新文章*name 指定栏目名称调用，多个栏目名称之间用英文逗号分开，和id参数作用一样；但是一个标签中，id或name不能同时存在。实例：king:article type=new name=seo number=10 说明调用SEO栏目下10篇最新文章*keywords 关键字参数，调用和keywords参数里指定的关键字一致的文章，和type=related功能类似，但是keywords是用户手动指定，而type=related是程序自动寻找循环体内标签(HTML)循环输出部分(king:artid /) 文章id(king:listid /) 列表id栏目id(king:listname /) 列表名称栏目名称(king:listpath /) 列表路径栏目路径(king:path /)文章路径即一篇文章的地址(king:title /)文章标题,具有size值，指定输出多少字节的描述信息，格式(king:title size=64 /)输出64字符32个汉字的描述信息，一个汉字为两个字符(king:from /) 来源(king:description /) 简述，具有size值，指定输出多少字节的描述信息，格式(king:description size=200 /)输出200字符100个汉字的描述信息，一个汉字为两个字符(king:keywords /)关键字(king:author /) 作者(king:image /) 缩略图路径，支持width和height属性，格式(king:image width=100 height=100 /) 输出宽高均为100像素的缩略图，不填写width和height则输出原图片(king:date /) 文章发布日期，(king:date mode=yy-MM-dd/) mode属性指定输出日期的格式，y年m月d日，之间可以有划线链接或无连接完整用法举例：king:article type=hot number=20(king:title size=30 /)(king:description size=200 /)(king:date mode=yy-MM-dd/) /king内容页面标签king:artid / 文章idking:listid / 列表idking:title / 文章标题king:content /内容king:from / 来源king:keywords / 关键字king:description / 简述king:author / 作者king:image / 缩略图路径，支持width和height属性king:path /文章路径king:guide / 导航king:pagelist / 文章分页king:nextpage / 下一页king:lastpage / 上一页king:hit / 点击次数调用及页面访问统计king:date / 日期以上标签不在循环体内必须有 包围，