1、PC标签使用说明
在PHPCMS V9 中我们正式开始需要PC 标签做为数据的获取的方式。
PC 标签是以下面的方式进行声明
{pc:content action="lists" cache="3600" num="20" page="$page"}{/pc}
PC 标签必须以{pc}开头,并以{/pc}结尾的代码片段。
当然不以{/pc}结尾并不会引起程序致命性的错误,导致程序无法继续运行。
以下为两种已知可能会出现的问题:
当网页中出现两个PC 标签时,可能会使得没有闭合的PC 标签之后的PC 标签数据和其混乱。
在后台可视化编辑时,可能出现网页结构错乱的问题。
2、PC标签分析:
PC 标签中{pc:}冒号之后跟随的为模块名。如上面的例子中调用的是内容模型的PC 标签。
action="list"
这个形式所代表的是参数。每一个PHPCMS V9 模型都为其PC 标签定义了调用的参数。其中有一些
调用参数是系统保留的参数,其对所有的PC 标签都是有效的。
参数必须使用
参数名="参数值"
的方式填写,多个参数之间使用空格分开(如下例),参数值可使用双引号来包括,无论是什么形
式的引号都必须是成对出现的。
{pc:content 参数名="参数值" 参数名="参数值" 参数名="参数值"}
请查看PC 标签保留参数相关章节,以了解具体保留参数及其用途。
3、如何显示 PC标签中的数据:
默认情况下PC 标签中的数据都是数组方式返回的,你都可以通过$data 来获取到这个数组,如果
你在PC 标签中定义了return 参数,返回的数组将使用return 的值进行命令。
一般情况下你可以使用如下的方式来显示值:
{loop $data $key $val}
<a href="{$val[url]}">{$val[title]}</a><br>
{/loop}
其中的$val[url]和$val[title]需要具体根据所使用的PC 标签,返回的数据来判断。

4、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 否返回的数据的变量
5、PC标签分类:
PC 标签包含两个类别,分别为:
○1 、模块类
○2 、工具类
模块类,是PHPCMS V9 各个模型提供给大家调用模块数据的数据接口。查看具体模块的相关说明
章节,以了解更多关于模块类的PC 标签的更多信息。
工具类,大体上可以理解为PHPCMS V9 所提供的一些工具箱。请查看PC 标签工具箱相关章节,以
了解更多关于工具类的PC 标签的更多信息。
下面我们将以模块类和工具类来讲解具体标签的使用:

 

请看第二

posted on 2012-11-20 11:47  lihuajunztdh  阅读(215)  评论(0编辑  收藏  举报