第 1 页 共 26 页
很厚搜索 - www.henhou.com
很厚网络
-
中国搜索引擎的后起之秀
www. henhou .com
PHPCMS
PHPCMS
PHPCMS
PHPCMS
V9
V9
V9
V9
标签参考手册
指导:和南
编写:马云他爹
第 2 页 共 26 页
很厚搜索 - www.henhou.com
很厚网络
-
中国搜索引擎的后起之秀
www. henhou .com
目录
前言 .......................................................................................................... 3
1
、
PC
标签使用说明
................................................................................ 3
2
、
PC
标签分析:
.................................................................................... 3
3 、如何显示 PC 标签中的数据: ........................................................... 3
4 、 PC 标签保留参数 ................................................................................ 4
附: GET 标签
.........................................................................................................
4
5
、
PC
标签分类:
.................................................................................... 5
一、 内容模块 .......................................................................................... 6
1 、内容模块 PC 标签调用接口 ............................................................... 6
2
、
action
值列表
....................................................................................... 6
2.1 、内容列表( lists ) :
.....................................................................................
9
2.2 、点击排行榜( hits ) :
.................................................................................
1 4
2.3 、内容推荐位列表( position ) :
.................................................................
15
2.4 、相关文章( relation ) :
.............................................................................
16
二、友情链接 模块 ............................................................................... 20
1 、友情链接模块 PC 标签调用接口 .................................................... 20
2
、
action
值列表
..................................................................................... 20
2.1 、友情链接列表( lists ):
.........................................................................
2 1
三、公告模块 ........................................................................................ 22
1 、内容模块 PC 标签调用接口 ............................................................. 22
2 、 action 值列表 ..................................................................................... 22
2.1 、公告列表( lists ):
.................................................................................
2 3
四、投票模块
........................................................................................ 24
1
、投票模块
PC
标签调用接口
............................................................. 24
2 、 action 值列表 ..................................................................................... 24
2.1 、投票列表( lists ):
.................................................................................
2 5
第 3 页 共 26 页
很厚搜索 - www.henhou.com
很厚网络
-
中国搜索引擎的后起之秀
www. henhou .com
前言
1
1
1
1 、 PC
PC
PC
PC 标签使用说明
在 PHPCMS V9 中我们正式开始需要 PC 标签做为数据的获取的方式。
PC 标签是以下面的方式进行声明
{ pc : content action = "lists" cache = "3600" num = "20" page = "$page" } {/ pc }
PC 标签必须以 {pc} 开头,并以 {/pc} 结尾的代码片段。
当然不以 {/pc} 结尾并不会引起程序致命性的错误,导致程序无法继续运行。
以下为两种已知可能会出现的问题:
当网页中出现两个 PC 标签时,可能会使得没有闭合的 PC 标签之后的 PC 标签数据和其混乱。
在后台可视化编辑时,可能出现网页结构错乱的问题。
2
2
2
2
、
PC
PC
PC
PC
标签分析:
PC 标签中 {pc:} 冒号之后跟随的为模块名。如上面的例子中调用的是内容模型的 PC 标签。
action = "list"
这个形式所代表的是参数 。 每一个 PHPCMS V9 模型都为其 PC 标签定义了调用的参数 。 其中有一些
调用参数是系统保留的参数,其对所有的 PC 标签都是有效的。
参数必须使用
参数名 = " 参数值 "
的方式填写,多个参数之间使用空格分开(如下例),参数值可使用双引号来包括,无论是什么形
式的引号都必须是成对出现的。
{ pc : content 参数名 = " 参数值 " 参数名 = " 参数值 " 参数名 = " 参数值 " }
请查看 PC 标签保留参数相关章节,以了解具体保留参数及其用途。
3
3
3
3 、如何显示 PC
PC
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 标签,返回的数据来判断。
第 4 页 共 26 页
很厚搜索 - www.henhou.com
很厚网络
-
中国搜索引擎的后起之秀
www. henhou .com
4
4
4
4 、 PC
PC
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
GET
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 }
第 5 页 共 26 页
很厚搜索 - www.henhou.com
很厚网络
-
中国搜索引擎的后起之秀
www. henhou .com
从上面的代码里面可以看出 GET 标签所支持的参数。对照下面的列表了解每一个参数的用途:
参数 默认值 必须 说明
sql null 是 要执行的 SQL 语句
cache 0 否 缓存时间,单位为秒
page 0 否 分页,通过变量把当前的分布传给 PC 标签进行处理
dbsource null 否
数据源,当你通过系统后台的数据源模块配置过数据源时,可把数据源名
填写到这里,系统会去对应的数据源来读取数据。如果要读取本系统的数
据请留空
return data 否 返回的数据的变量
5
5
5
5
、
PC
PC
PC
PC
标签分类:
PC 标签包含两个类别,分别为:
○
1
1
1
1
、 模块类
○
2
2
2
2
、 工具类
模块类,是 PHPCMS V9 各个模型提供给大家调用模块 数据的数据接口。查看具体模块的相关说明
章节,以了解更多关于模块类的 PC 标签的更多信息。
工具类,大体上可以理解为 PHPCMS V9 所提供的一些工具箱。请查看 PC 标签工具箱相关章节 , 以
了解更多关于工具类的 PC 标签的更多信息。
下面我们将以模块类和工具类来讲解具体标签的使用:
- 1
- 2
前往页