【phpcms-v9】前台content模块中pc标签的调用说明

内容模块PC标签调用说明

模块名：content

模块提供的可用操作

	操作名			说明

	lists			内容数据列表
	relation		内容相关文章
	hits			内容数据点击排行榜
	category		内容栏目列表
	position		内容推荐位列表 

--------------------------------------------------------------------------------

内容推荐位列表（position）：

可用参数：

	参数名		是否必须		默认值		说明

	posid		是		null		推荐位ID
	catid		否		null		调用栏目ID
	thumb		否		0			是否仅必须缩略图
	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		推荐位缩略图
	其他			不定		是	根据模型所设置的加入到推荐位中字段名称 

--------------------------------------------------------------------------------

内容列表（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}

提醒：从PHPCMS V9 Beta 20101105版本开始支持moreinfo参数属性，本参数表示在返回数据的时候，会把副表中的数据也一起返回。
一个内容模型分为2个表，一个主表一个副表，主表中一般是保存了标题、所属栏目等等短小的数据（方便用于索引），而副表则保存
了大字段的数据，如内容等数据。在模型管理中新建字段的时候，是允许你选择存入到主表还是副表的（我们推荐的是，把不重要的
信息放到副表中）。想要在列表中调取副表的数据就需要在PC标签中使用moreinfo这个属性。

代码例子：

	{pc:content  action="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: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		推荐位缩略图
	其他			不定		是		其他模型字段 

--------------------------------------------------------------------------------

点击排行榜（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		推荐位缩略图
	其他			不定		是		其他模型字段 

--------------------------------------------------------------------------------

相关文章（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
	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)		无		栏目拼音

原网址：http://blog.csdn.net/yanhui_wei/article/details/7927387