您现在的位置是：首页 > cms教程 > phpcms教程phpcms教程

phpcmsv9前台content模块中pc标签的调用说明

醉易2025-06-15phpcms教程已有人查阅

导读内容模块PC标签调用说明模块名：content模块提供的可用操作操作名说明lists 内容数据列表relation内容相关文章hits内容数据点击排行榜

内容模块PC标签调用说明
模块名：content
模块提供的可用操作
操作名说明
lists 内容数据列表
relation内容相关文章
hits内容数据点击排行榜
category内容栏目列表
position内容推荐位列表
--------------------------------------------------------------------------------
内容推荐位列表（position）：
可用参数：
参数名是否必须默认值说明
posid 是 null推荐位ID
catid 否 null调用栏目ID
thumb 否 0 是否仅必须缩略图
order 否 null排序类型
num 是 null数据调用数量
代码例子：

{pc:contentaction="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推荐位缩略图
其他不定是根据模型所设置的加入到推荐位中字段名称
--------------------------------------------------------------------------------
内容列表（lists）：
可用参数：
参数名是否必须默认值说明
catid 否 null调用栏目ID ,此参数必不可少，因为要根据此函数的值来设置模型、选择模型数据表
where 否 nullsql语句的where部分
thumb 否 0 是否仅必须缩略图
order 否 null排序类型
num 是 null数据调用数量
moreinfo否 0 是否调用副表数据
也可以自定义多个参数名，如：aa、bb、cc，这些参数的值都可以再lists方法中通过$data['aa']、$data['bb']、$data['cc']来获取到参数的值，这样的话我们就可以根据
业务的需要，给pc标签添加任意多个参数作为条件用于lists方法中的流程控制，这一点个人感觉phpcms-v9做的比较灵活，非常便于二次开发
如：{pc:contentaction="lists" catid="2" aa='aa' bb='bb' c='cc' order="id DESC" num="4"}{/pc}
提醒：从PHPCMS V9 Beta 20101105版本开始支持moreinfo参数属性，本参数表示在返回数据的时候，会把副表中的数据也一起返回。
一个内容模型分为2个表，一个主表一个副表，主表中一般是保存了标题、所属栏目等等短小的数据（方便用于索引），而副表则保存
了大字段的数据，如内容等数据。在模型管理中新建字段的时候，是允许你选择存入到主表还是副表的（我们推荐的是，把不重要的
信息放到副表中）。想要在列表中调取副表的数据就需要在PC标签中使用moreinfo这个属性。
代码例子：

{pc:contentaction="lists" catid="2" order="id DESC" num="4"}
<ul>
{loop $data $key $val}
<li> <a href="{$val['url']}">{$val['title']}</a></li>
{/loop}
</ul>
{/pc}

where用法：

{pc:contentaction="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推荐位缩略图
其他不定是其他模型字段
--------------------------------------------------------------------------------
点击排行榜（hits）：
可用参数：
参数名是否必须默认值说明
catid 否 null调用栏目ID
day 否 0 调用多少天内的排行
order 否 null排序类型（本月排行- monthviews DESC 、本周排行 - weekviews DESC、今日排行 - dayviews DESC）
num 是 null数据调用数量
代码例子：

{pc:contentaction="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推荐位缩略图
其他不定是其他模型字段
--------------------------------------------------------------------------------
相关文章（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推荐位缩略图
其他不定是其他模型字段
--------------------------------------------------------------------------------
栏目列表（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
siteidtinyint(3)0 站点ID
modulevarchar(15) 无模块ID
typetinyint(1)1 栏目类型ID
modelid tinyint(5)5 模型ID
parentidsmallint(5) 5 上级父栏目
arrparentid varchar(255)无所有父栏目
child tinyint(1)0 子栏目
arrchildidmediumtext无所有子栏目
catname varchar(30) 无栏目名称
image varchar(100)无栏目图片
description mediumtext无栏目描述
parentdir varchar(100)无父栏目目录
catdirvarchar(30) 无栏目目录
url varchar(100)无栏目链接
items mediumint(8)0 栏目内容数
hitsint(10) 0 点击数
setting mediumtext无栏目设置
listorder smallint(5) 0 排序
ismenutinyint(1)0 是否显示
sethtml tinyint(1)0 是否生成到根目录
lettervarchar(30) 无栏目拼音