content内容标签 · ShuipFCMS使用手册

**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标签`使用，具体看手册基本语法！ [TOC] ##基本参数 | 参数名称 | 说明 | | -- | -- | | @action | 调用方法（必填） | | @page | 当前分页号，默认$page，当传入该参数表示启用分页，一个页面只允许有一个page，多个标签使用多个page会造成不可预知的问题。 | | @num | 每次返回数据量。 | | @catid| 栏目id（必填），列表页，内容页可以使用 $catid 获取当前栏目。| ##公用参数 | 参数名称 | 说明 | | -- | -- | | @cache | 数据缓存时间，单位秒 | |@return|返回值变量名称，默认data| |@pagefun|分页函数，默认page()| |@pagetp|分页模板| |@where|设置SQL where 部分。 说明：出现“`>`”，“`<`”这类，建议使用`{gt}`代替`>`，`{lt}`代替`<`，`{neq}`代替`<>`，`{elt}`代替`<=`，`{egt}`代替`>=`。 建议直接`传入变量`。| **`下面的参数，是根据@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部分。 `views` 点击总数 `yesterdayviews` 昨日点击 `dayviews` 今日点击 `weekviews` 本周点击 `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> ~~~ ##其他一些小技巧 1. 如果要添加where条件，可以这样使用 `where="field='8'"`，如果想在where里调用变量，要使用`<?php $sql = "field = '{$id}'"; ?> where="$sql"` 这种方式，不可以直接在where里使用变量！（`注意：为了你的网站安全，不建议直接接受$_GET,$_POST等不可信数据！`） 2. 如果为了性能考虑，可以添加 `cache="3600"` 参数，标识缓存3600秒。这样在动态访问的时候，可以加快！推荐网站开启Memcached缓存。