CmsTop模板制作帮助手册(6)——模板标签

2010-09-09 21:07:04来源:作者:

1.      Content标签

1.      Content标签

作用:调用CmsTop系统中各种内容模型数据;
示例:
{content catid="4" modelid="1" orderby="published desc, pv desc" page="$page" size="8"}
 • <a href="{$r[url]}">{$r[title]}</a> {date('Y-m-d',$r[published])}
{/content}
{pages($total, $page, $pagesize, 2, $urlrule)}
参数对照表:

参数
详解
modelid
内容模型ID,多个ID用“,”隔开
catid
栏目ID,多个ID用“,”开 ,可自动取子栏目内容
sourceid
来源ID,多个ID用“,”隔开
weight
权重范围
weight="60",表示权重值等于60
weight="60,",表示权重值大于等于60
weight=",60",表示权重值小于等于60
weight="60,100",表示权重值大于等于60,且小于等于100
published
发布时间范围
published="2009-11-10" 表示调用发布时间为2009年 11月10日的内容
published="2009-11-10," 表示调用发布时间大于2009年11月 10日的内容
published=",2009-11-10" 表示用发布时间小于2009年11月10日 的内容
published="2009-11-10,2009-11-30" 表示调用发布时间大于2009年11 月10日,且小于2009年11月30日的内容
published="1" 表示调用发布时间1天以内的内容
createdby
建人 ID,多个 ID 用“,”隔开
tags
关键词,多个关键词用“,”隔开,例如:tags="福布斯,权力"
orderby
排序方式,多个“,”隔开,例如:orderby="published desc, pv desc, comments desc, weight desc"
offset
数据库查询结果偏移值(必须是正整数),默认值为 0
size
行数(必须是正整数)
page
当前页码(必须是正整数)
return
返回值变量 return:返回结果变量名,默认为 r

2.      Db标签
作用:通用的数据库数据调用方法,通常用于调用cmstop_content表以外的数据表的数据;
示例:
{db sql="select * from #table_content where catid=$catid and modelid=1 and status=6 order by published desc" size="$pagesize" page="$page"}
    <a href="{$r[url]}">{$r[title]}</a> {date('n月j日H:i',$r['published'])}
{/db}
{pages($total, $page, $pagesize, 2, $urlrule)}
参数对照表:

参数名
必选
说明
dsn
数据源名,当需要调用的数据库帐号和当前系统不同时使用,并且需要事先在后台添加好数据源
dbname
数据库名,当需要调用的数据库帐号和当前系统相同而数据库名不同时使用
charset
数据字符集,当需要调用的数据和当前系统字符集不同时设置,数据输出的时候系统会根据此设置自动转码
sql
要查询的sql语句,数据表的前缀可以用 #table_ 代替
page
当前的页码,一般用法都是 page="$page"
size
行数(必须是正整数)
return
返回值变量 return:返回结果变量名,默认为 r

3.      Discuz标签
作用:调用同一服务器上的discuz论坛帖子数据
示例:
{discuz dsn="discuz"  fid="1" filter="all" published="1" keywords="cmstop" author="1" special="1,2" prefix="cdb_" orderby="dateline desc" size="$pagesize" page="$page"}
      <!-更多可使用字段,请参考discuz数据表posts、threads-à
      <a href="htpp://url_to_discuz/tid={$r[tid]}">{$r[subject]}</a> {date('n月j日H:i',$r['dateline'])}
{/discuz}
{pages($total, $page, $pagesize, 2, $urlrule)}
参数对照表:

参数名
必选
说明
dsn
数据源名,当需要调用的数据库帐号和当前系统不同时使用,并且需要事先在后台添加好数据源
fid
论坛版块ID,多个以半角逗号分隔
filter
主题类型,全部主题(all) 、精华主题(digest)、 置顶主题(top)
published
时间范围,数字n表示n天之内的帖子
keywords
关键字,关键词写法参考discuz搜索,以(AND、&、空格) (OR、|)组合查询,*模糊匹配
author
作者ID或者作者名称,多个以逗号分隔
special
特殊主题:投票主题(1)、商品主题(2)、悬赏主题(3)、活动主题(4)、辩论主题(5)、
多个以逗号分隔
orderby
排序类型:
lastpost (asc|desc) 最后回复
 dateline (asc|desc) 发表时间
 replies (asc|desc)   回复数
 views (asc|desc)     查看数
prefix
默认‘cdb_’ discuz数据表前缀
其它字段
page,offset,size,charset参考db标签

4.      Section标签
作用:定义页面区块属性,通常用于通过页面模板自动创建页面区块;
示例: 
<!--{section name="热点专题 图片" type="hand" width="0" frequency="0" rows="1" output="html" description=""}-->
模板代码当type为html的时候只能为html,其他可以是html跟模板标签组合的代码
<!--{/section}-->
区块类型对照表:

类型
说明
代码
支持html和js代码,通常用于不规则数据和广告位维护等
自动
支持通过模板标签调用数据,可以定时刷新,无需人工维护
手动
支持手动更新数据,并通过设定的模板代码输出
rss
获取指定的rss新闻源,并通过设定的模板代码输出,可定时刷新,通常用于RSS数据远程调用
json
获取指定的json数据源,并通过设定的模板代码输出,可定时刷新,通常用于JSON数据远程调用
rpc
获取指定的rpc接口数据,并通过设定的模板代码输出,可定时刷新,通常用于RPC协议接口

参数对照表:

参数名
必选
说明
sectionid
区块ID,如果没填写就会自动创建此碎片
name
区块名称,可以重复
type
区块类型,(html,auto,hand,rss,json,rpc)其中之一。
url
当type为(rss,json,rpc)时有效
method
当type为rpc时有效
args
当type为rpc时有效
width
区块宽度,主要用来参考标题长度是否合适
frequency
更新频率,当type为html和hand时此选项无效
rows
默认的行数,仅type为hand时有效
origdata
默认的数据,需php序列化以后的数据
output
输出格式,(html,xml,json)三者之一 ,仅type为hand时有效
description
区块备注,一般用来说明区块显示在什么位置,缩略图规格,标题最大长度等

关键词:CmsTop

赞助商链接: