【phpcms-v9】内容模块content标签的调用说明
内容模块PC标签调用说明
模块名:content
模块提供的可用操作
操作名 说明
lists 内容数据列表
relation 内容相关文章
hits 内容数据点击排行榜
category 内容栏目列表
position 内容推荐位列表
--------------------------------------------------------------------------------
1、内容推荐位列表(position):
可用参数:
参数名 是否必须 默认值 说明
posid 是 null 推荐位ID
catid 否 null 调用栏目ID
thumb 否 null 是否仅必须缩略图
order 否 null 排序类型
num 是 null 数据调用数量
代码例子:
{pc:content action="position" posid="2" order="listorder DESC" num="4"} <ul> {loop $data $key $val} <li> <a href="{$val['url']}">{$val['title']}</a></li> {/loop} </ul> {/pc}
返回参数如下表:
字段 类型 空 默认 注释 title char(80) 否 NULL 推荐位标题 url char 否 NULL 推荐位链接地址 inputtime int(10) 否 NULL 推荐位发布时间 thumb char 是 NULL 推荐位缩略图 其他 不定 是 根据模型所设置的加入到推荐位中字段名称
--------------------------------------------------------------------------------
2、内容列表(lists):
可用参数:
参数名 是否必须 默认值 说明 catid 否 null 调用栏目ID ,此参数必不可少,因为要根据此函数的值来设置模型、选择模型数据表 where 否 null sql语句的where部分 thumb 否 0 是否仅必须缩略图 order 否 null 排序类型 num 是 null 数据调用数量 moreinfo 否 0 是否调用副表数据
也可以自定义多个参数名,如:aa、bb、cc,这些参数的值都可以再lists方法中通过$data['aa']、$data['bb']、$data['cc']来获取到参数的值,这样的话我们就可以根据
业务的需要,给pc标签添加任意多个参数作为条件用于lists方法中的流程控制,这一点个人感觉phpcms-v9做的比较灵活,非常便于二次开发
如:{pc:content action="lists" catid="2" aa='aa' bb='bb' c='cc' order="id DESC" num="4"}{/pc}
moreinfo参数属性
提醒:从PHPCMS V9 Beta 20101105版本开始支持moreinfo参数属性,本参数表示在返回数据的时候,会把副表中的数据也一起返回。
一个内容模型分为2个表,一个主表一个副表,
主表中一般是保存了标题、所属栏目等等短小的数据(方便用于索引),
副表则保存了大字段的数据,如内容等数据。
在模型管理中新建字段的时候,是允许你选择存入到主表还是副表的(我们推荐的是,把不重要的
信息放到副表中)。想要在列表中调取副表的数据就需要在PC标签中使用moreinfo这个属性。
代码例子:
{pc:content action="lists" catid="2" order="id DESC" moreinfo=“1”num="4"} <ul> {loop $data $key $val} <li> <a href="{$val['url']}">{$val['title']}</a></li> {/loop} </ul> {/pc}
where用法:
{pc:content action="lists" catid="2" where="`thumb`!='' AND `status`=99" order="id DESC" num="4"} <ul>
{loop $data $key $val} <li> <a href="{$val['url']}">{$val['title']}</a></li>
{/loop} </ul>
{/pc}
返回参数如下表:
字段 类型 空 默认 注释 title char(80) 否 NULL 推荐位标题 url char 否 NULL 推荐位链接地址 inputtime int(10) 否 NULL 推荐位发布时间 thumb char 是 NULL 推荐位缩略图 其他 不定 是 其他模型字段
--------------------------------------------------------------------------------
3、点击排行榜(hits):
可用参数:
参数名 是否必须 默认值 说明 catid 否 null 调用栏目ID day 否 0 调用多少天内的排行 order 否 null 排序类型(本月排行- monthviews DESC 、本周排行 - weekviews DESC、今日排行 - dayviews DESC) num 是 null 数据调用数量
代码例子:
{pc:content action="hits" catid="2" order="weekviews DESC" num="10"} <ul> {loop $data $key $val} <li> <a href="{$val['url']}">{$val['title']}</a></li> {/loop} </ul> {/pc}
返回参数如下表:
字段 类型 空 默认 注释 title char(80) 否 NULL 推荐位标题 url char 否 NULL 推荐位链接地址 inputtime int(10) 否 NULL 推荐位发布时间 thumb char 是 NULL 推荐位缩略图 其他 不定 是 其他模型字段
--------------------------------------------------------------------------------
4、相关文章(relation):
可用参数:
参数名 是否必须 默认值 说明 catid 否 null 调用栏目ID relation 否 $relation 关联文章id keywords 否 null 热词搜索 num 是 null 数据调用数量
代码例子:
{pc:content action="relation" relation="$relation" catid="$catid" num="5" keywords="$rs[keywords]"} {loop $data $r} <li><a href="{$r[url]}" target="_blank">{$r[title]}</a><span>({date('Y-m-d',$r[inputtime])})</span></li> {/loop} {/pc}
返回参数如下表:
字段 类型 空 默认 注释 title char(80) 否 NULL 推荐位标题 url char 否 NULL 推荐位链接地址 inputtime int(10) 否 NULL 推荐位发布时间 thumb char 是 NULL 推荐位缩略图 其他 不定 是 其他模型字段
--------------------------------------------------------------------------------
5、栏目列表(category):
可用参数:
参数名 是否必须 默认值 说明 catid 否 0 调用该栏目下的所有栏目 ,默认0,调用一级栏目 $siteid 否 1 默认调用系统站点 order 否 null 排序方式、一般按照listorder ASC排序,即栏目的添加顺序
代码例子:
{pc:content action="category" catid="0" num="25" siteid="$siteid" order="listorder ASC"} {loop $data $r} <li><a href="{$r[url]}"><span>{$r[catname]}</span></a></li> {/loop} {/pc}
返回参数如下表:
字段 类型 默认值 说明 catid smallint 无 栏目ID siteid tinyint(3) 0 站点ID module varchar(15) 无 模块ID type tinyint(1) 1 栏目类型ID modelid tinyint(5) 5 模型ID parentid smallint(5) 5 上级父栏目 arrparentid varchar(255) 无 所有父栏目 child tinyint(1) 0 子栏目 arrchildid mediumtext 无 所有子栏目 catname varchar(30) 无 栏目名称 image varchar(100) 无 栏目图片 description mediumtext 无 栏目描述 parentdir varchar(100) 无 父栏目目录 catdir varchar(30) 无 栏目目录 url varchar(100) 无 栏目链接 items mediumint(8) 0 栏目内容数 hits int(10) 0 点击数 setting mediumtext 无 栏目设置 listorder smallint(5) 0 排序 ismenu tinyint(1) 0 是否显示 sethtml tinyint(1) 0 是否生成到根目录 letter varchar(30) 无 栏目拼音