phpcms v9模板标签使用说明

在PHPCMS V9中正式开始需要PC标签做为数据的获取的方式。

PC标签是以下面的方式进行声明

｛pc:content action="lists" cache="3600" num="20" page="$page"｝{/pc}

PC标签必须以{pc}开头，并以{/pc}结尾的代码片段。

当然不以{/pc}结尾并不会引起程序致命性的错误，导致程序无法继续运行。

以下为两种已知可能会出现的问题：

当网页中出现两个PC标签时，可能会使得没有闭合的PC标签之后的PC标签数据和其混乱。在后台可视化编辑时，可能出现网页结构错乱的问题。

PC标签分析：

PC标签中{pc:}冒号之后跟随的为模块名。如上面的例子中调用的是内容模型的PC标签。

action=”list”

这个形式所代表的是参数。每一个PHPCMS V9模型都为其PC标签定义了调用的参数。其中有一些调用参数是系统保留的参数，其对所有的PC标签都是有效的。

参数必须使用

参数名=”参数值”

的方式填写，多个参数之间使用空格分开（如下例），参数值可使用双引号来包括，无论是什么形式的引号都必须是成对出现的。

{pc:content 参数名=”参数值” 参数名=”参数值” 参数名=”参数值”}

请查看PC标签保留参数相关章节，以了解具体保留参数及其用途。

PC标签分类：

PC标签包含两个类别，分别为：

工具类模块类

工具类，大体上可以理解为PHPCMS V9所提供的一些工具箱。请查看PC标签工具箱相关章节，以了解更多关于工具类的PC标签的更多信息。

而模块 类，是PHPCMS V9各个模型提供给大家调用模块 数据的数据接口。查看具体模块的相关说明章节，以了解更多关于模块类的PC标签的更多信息。

如何显示PC标签中的数据：

默认情况下PC标签中的数据都是数组方式返回的，你都可以通过 $data 来获取到这个数组，如果你在PC标签中定义了return参数，返回的数组将使用return的值进行命令。

一般情况下你可以使用如下的方式来显示值：

{loop $data $key $val}

<a href=”{$val[url]}”>{$val[title]}</a><br>

{/loop}

基中的$val[url]和$val[title]需要具体根据所使用的PC标签，返回的数据来判断。

PC标签保留参数

下表为PC标签保留参数表，几乎所有的PC标签都支持这些保留参数设置

变量名	默认值	说明
action	null	本参数的值表示为操作事件，模型类PC标签必须使用包含本参数，以说明要进行的操作。
cache	0	缓存存储时间（单位秒）
num	20	获取记录的条数，最后会被模板引擎处理成limit传送到处理函数中。
page	null	当前分页。一般填写为$_GET[page]
urlrule	null	URL规则
return	data	返回数据变量名

下例中是一个完整的使用例子。

{pc:content action=”lists” catid=”25″ num=”20″ page=”$_GET[page]” return=”data”}

<ul>

{loop $data $n $r}

<li><a href=”{$r[url]}”>{$r[title]}</a></li>

{/loop}

</ul>

{/pc}

get标签

GET标签源自于PHPCMS 2008版，其使用SQL语句直接获取数据的特性，成为大家制作模板的首选。

在V9中这样强大的工具也得到保留下来。

GET标签使用方式如下：

{pc:get sql=”SELECT * FROM phpcms_member” cache=”3600″ page=”$page” dbsource=”discuz” return=”data”}

<ul>

{loop $data $key $val}

{$val[username]}<br />

{/loop}

</ul>

{$pages}

{/pc}

从上面的代码里面可以看出GET标签所支持的参数。对照下面的列表了解每一个参数的用途：

参数	默认值	必须	说明
sql	null	是	要执行的SQL语句
cache	0	否	缓存时间，单位为秒
page	0	否	分页，通过变量把当前的分布传给PC标签进行处理
dbsource	null	否	数据源，当你通过系统后台的数据源模块配置过数据源时，可把数据源名填写到这里，系统会去对应的数据源来读取数据。如果要读取本系统的数据请留空
return	data	否	返回的数据的变量

内容模块

内容模块PC标签调用说明

模块名：content

模块提供的可用操作

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

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	是否调用副表数据

提醒：从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	无需更改
keywords	否	null	内容页面取值：$rs[keywords]
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)	无	栏目拼音