content内容标签
标签:<content></content>
作用:内容模型相关标签,可调用栏目,列表等常用信息
用法示例:<content action="lists" catid="$catid" order="id DESC" num="4" page="$page"> .. HTML ..</content>
格式:<content action="方法名" 参数="内容"> .. HTML ..</content>
特别说明:
$catid
变量在列表页,和内容页都表示当前栏目ID。page="$page"
表示开启分页,每个页面,只允许出现一
个,多个会出现未知错误!
content 标签返回的是数组
,所以要配合volist标签
使用,具体看手册基本语法!
基本参数
参数名称 | 说明 |
---|---|
@action | 调用方法(必填) |
@page | 当前分页号,默认$page,当传入该参数表示启用分页,一个页面只允许有一个page,多个标签使用多个page会造成不可预知的问题。 |
@num | 每次返回数据量。 |
@catid | 栏目id(必填),列表页,内容页可以使用 $catid 获取当前栏目。 |
公用参数
参数名称 | 说明 |
---|---|
@cache | 数据缓存时间,单位秒 |
@return | 返回值变量名称,默认data |
@pagefun | 分页函数,默认page() |
@pagetp | 分页模板 |
@where | 设置SQL where 部分。<br/>说明:出现“> ”,“< ”这类,建议使用{gt} 代替> ,{lt} 代替< ,{neq} 代替<> ,{elt} 代替<= ,{egt} 代替>= 。<br/> 建议直接传入变量 。 |
下面的参数,是根据@action参数不同,而独有的
调用栏目信息列表
当@action
为lists
时,调用栏目信息列表
用法示例:<content action="lists" catid="$catid" order="id DESC" num="4" page="$page"> .. HTML ..</content>
| 参数名称 | 说明 |
| -- | -- |
|@order|排序,例如“id DESC”|
|@where|sql语句的where部分 例如: thumb != "" AND status = 99
|
|@thumb|是否仅必须缩略图,1为调用带缩略图的|
|@moreinfo|是否调用副表数据 1为是|
|@output|是否经过ContentOutput处理,例如时间,在除了内容页其他调用,是一串数字,开启这个后就是直接输出日期了。同时,如果开启这个参数后,会增加一个_original参数,可以访问数据库存储的原始内容,例如 $vo["_original"]["id"]
|
用法示例:
<content action="lists" catid="$catid" order="id DESC" num="4" page="$page">
循环列表,默认返回数据是$data
<ul>
<volist name="data" id="vo">
<li>标题:{$vo.title},地址:{$vo.url}</li>
</volist>
</ul>
</content>
调用点击排行榜
当@action
为hits
时,调用点击排行榜
用法格式:<content action="hits" catid="$catid" order="weekviews DESC" num="10"> .. HTML ..</content>
| 参数名称 | 说明 |
| -- | -- |
|@order|排序,例如“weekviews DESC”|
|@day|调用多少天内的排行|
|@where|sql语句的where部分。<br/>views
点击总数<br/>yesterdayviews
昨日点击<br/>dayviews
今日点击<br/>weekviews
本周点击<br/>monthviews
本月点击|
用法示例:
<content action="hits" catid="$catid" order="weekviews DESC" num="10">
循环列表,默认返回数据是$data
<ul>
<volist name="data" id="vo">
<li>标题:{$vo.title},地址:{$vo.url}</li>
</volist>
</ul>
</content>
调用相关文章
当@action
为relation
时,调用相关文章
用法格式:<content action="relation" relation="$relation" catid="$catid" order="id DESC" num="5" keywords="$keywords"> .. HTML ..</content>
| 参数名称 | 说明 |
| -- | -- |
|@nid|排除id 一般是 $id,排除当前文章|
|@keywords|内容页面取值:$keywords,也就是关键字|
|@relation|内容页取值$relation,当有$relation时keywords参数失效|
|@where|sql语句的where部分|
用法示例:
<content action="relation" relation="$relation" catid="$catid" order="id DESC" num="5" keywords="$keywords">
循环列表,默认返回数据是$data
<ul>
<volist name="data" id="vo">
<li>标题:{$vo.title},地址:{$vo.url}</li>
</volist>
</ul>
</content>
调用栏目列表
当@action
为category
时,调用栏目列表
用法格式:<content action="category" catid="$catid" order="listorder ASC" > .. HTML ..</content>
| 参数名称 | 说明 |
| -- | -- |
|@order|排序,例如“listorder DESC”|
|@where|sql语句的where部分 例如: child = 0
|
用法示例:
<content action="category" catid="$catid" order="listorder ASC" >
循环列表,默认返回数据是$data
<ul>
<volist name="data" id="vo">
<li>栏目标题:{$vo.catname},地址:{$vo.url}</li>
</volist>
</ul>
</content>
其他一些小技巧
- 如果要添加where条件,可以这样使用
where="field="8""
,如果想在where里调用变量,要使用<?php $sql = "field = "{$id}""; ?> where="$sql"
这种方式,不可以直接在where里使用变量!(注意:为了你的网站安全,不建议直接接受$_GET,$_POST等不可信数据!
) - 如果为了性能考虑,可以添加
cache="3600"
参数,标识缓存3600秒。这样在动态访问的时候,可以加快!推荐网站开启Memcached缓存。