网站建设   网站建设技术   网站后端技术   网站建设CMS   phpcms  
phpcms之PC标签使用详解
人浏览 发布时间:2021-11-23
在PHPCMS V9中我们正式开始需要PC标签做为数据的获取的方式。 PC标签是以下面的方式进行声明 1 {pc:content action= lists cache= 3600 num= 20 page= $page }{/pc} PC标签必须以{pc}开头,并以{/pc}结尾的代码片段。...

在PHPCMS V9中我们正式开始需要PC标签做为数据的获取的方式。
PC标签是以下面的方式进行声明
1 {pc:content action="lists" cache="3600" num="20" page="$page"}{/pc}
PC标签必须以{pc}开头,并以{/pc}结尾的代码片段。
当然不以{/pc}结尾并不会引起程序致命性的错误,导致程序无法继续运行。
以下为两种已知可能会出现的问题:
1.当网页中出现两个PC标签时,可能会使得没有闭合的PC标签之后的PC标签数据和其混乱。
2.在后台可视化编辑时,可能出现网页结构错乱的问题。
PC标签分析:
PC标签中{pc:}冒号之后跟随的为模块名。如上面的例子中调用的是内容模型的PC标签。
后台选择模块如图

选择模块管理子选项模块管理如图

模块名称 | 模块目录 | 版本号 | 安装日期 | 更新日期 | 管理操作 |
---|---|---|---|---|---|
admin | admin | 1.0 | 2010-10-18 | 2010-10-18 | 禁止 |
公告 | announce | 1.0 | 2021-11-03 | 2021-11-03 | 卸载 |
附件 | attachment | 1.0 | 2010-09-01 | 2010-09-06 | 禁止 |
碎片 | block | 1.0 | 2010-09-01 | 2010-09-06 | 禁止 |
采集模块 | collection | 1.0 | 2010-09-01 | 2010-09-06 | 禁止 |
评论 | comment | 1.0 | 2021-11-03 | 2021-11-03 | 卸载 |
内容模块 | content | 1.0 | 2010-09-06 | 2010-09-06 | 禁止 |
数据源 | dbsource | 2010-09-01 | 2010-09-06 | 禁止 | |
表单向导 | formguide | 1.0 | 2010-10-20 | 2010-10-20 | 卸载 |
友情链接 | link | 1.0 | 2010-09-06 | 2010-09-06 | 卸载 |
会员 | member | 1.0 | 2010-09-06 | 2010-09-06 | 禁止 |
短消息 | message | 1.0 | 2010-09-06 | 2010-09-06 | 卸载 |
新闻心情 | mood | 1.0 | 2021-11-03 | 2021-11-03 | 卸载 |
支付 | pay | 1.0 | 2010-09-06 | 2010-09-06 | 禁止 |
广告模块 | poster | 1.0 | 2021-11-03 | 2021-11-03 | 卸载 |
发布点 | release | 1.0 | 2010-09-01 | 2010-09-06 | 禁止 |
木马扫描 | scan | 1.0 | 2010-09-01 | 2010-09-06 | 卸载 |
全站搜索 | search | 1.0 | 2010-09-06 | 2010-09-06 | 卸载 |
短信平台 | sms | 1.0 | 2011-09-02 | 2011-09-02 | 卸载 |
专题 | special | 1.0 | 2010-09-06 | 2010-09-06 |
卸载 |
标签向导 | tag | 1.0 | 2021-11-03 | 2021-11-03 | 卸载 |
模板风格 | template | 1.0 | 2010-09-01 | 2010-09-06 | 禁止 |
在线升级 | upgrade | 1.0 | 2011-05-18 | 2011-05-18 | 卸载 |
视频库 | video | 1.0 | 2012-09-28 | 2012-09-28 | 卸载 |
投票 | vote | 1.0 | 2010-09-06 | 2010-09-06 | 卸载 |
手机门户 | wap | 1.0 | 2021-11-03 | 2021-11-03 | 卸载 |
1 action="list"
phpcms手册中“功能模块”如图:

一、内容模块
内容模块PC标签调用说明
模块名:content
模块提供的可用操作
操作名 | 说明 |
lists | 内容数据列表 |
relation | 内容相关文章 |
hits | 内容数据点击排行榜 |
category | 内容栏目列表 |
position | 内容推荐位列表 |
1.position操作说明如下:
内容推荐位列表(position):
可用参数:
参数名 | 是否必须 | 默认值 | 说明 |
posid | 是 | null | 推荐位ID |
catid | 否 | null | 调用栏目ID |
thumb | 否 | 0 | 是否仅必须缩略图 |
where | 否 | null | sql语句(可与其他条件组合) |
order | 否 | null | 排序类型 |
num | 是 | null | 数据调用数量 |
catid:
代码例子:
|
{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} |
返回参数如下表:
字段 | 类型 | 空 | 默认 | 注释 |
---|---|---|---|---|
char(80) | 否 | NULL | 推荐位标题 | |
char | 否 | NULL | 推荐位链接地址 | |
int(10) | 否 | NULL | 推荐位发布时间 | |
char | 是 | NULL | 推荐位缩略图 | |
不定 | 是 | 根据模型所设置的加入到推荐位中字段名称 |
2.内容列表(lists):
可用参数:
参数名 | 是否必须 | 默认值 | 说明 |
catid | 否 | null | 调用栏目ID |
where | 否 | null | sql语句的where部分 |
thumb | 否 | 0 | 是否仅必须缩略图 |
order | 否 | null | 排序类型 |
num | 是 | null | 数据调用数量 |
moreinfo | 否 | 0 | 是否调用副表数据 |
提醒:从PHPCMS V9 Beta 20101105版本开始支持moreinfo参数属性,本参数表示在返回数据的时候,会把副表中的数据也一起返回。一个内容模型分为2个表,一个主表一 个副表,主表中一般是保存了标题、所属栏目等等短小的数据(方便用于索引),而副表则保存了大字段的数据,如内容等数据。在模型管理中新建字段的时候,是 允许你选择存入到主表还是副表的(我们推荐的是,把不重要的信息放到副表中)。想要在列表中调取副表的数据就需要在PC标签中使用moreinfo这个属 性。
代码例子:
1
2
3
4
5
6
7
|
{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用法:
1
2
3
4
5
6
7
|
{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} |
返回参数如下表:
字段 | 类型 | 空 | 默认 | 注释 |
---|---|---|---|---|
char(80) | 否 | NULL | 标题 | |
char | 否 | NULL | 链接地址 | |
int(10) | 否 | NULL | 发布时间 | |
char | 是 | NULL | 缩略图 | |
不定 | 是 | 其他模型字段 |
3.点击排行榜(hits):
可用参数:
参数名 | 是否必须 | 默认值 | 说明 |
catid | 否 | null | 调用栏目ID |
day | 否 | 0 | 调用多少天内的排行 |
order | 否 | null | 排序类型(本月排行- monthviews DESC 、本周排行 - weekviews DESC、今日排行 - dayviews DESC) |
num | 是 | null | 数据调用数量 |
代码例子:
1
2
3
4
5
6
7
|
{pc:content action= "hits" catid= "2" order= "weekviews DESC" num= "10" }<P></P> <ul> {loop $data $key $val } <li> <a href= "{$val['url']}" >{ $val [ 'title' ]}</a></li> {/loop} </ul> {/pc} |
返回参数如下表:
字段 | 类型 | 空 | 默认 | 注释 |
---|---|---|---|---|
char(80) | 否 | NULL | 推荐位标题 | |
char | 否 | NULL | 推荐位链接地址 | |
int(10) | 否 | NULL | 推荐位发布时间 | |
char | 是 | NULL | 推荐位缩略图 | |
不定 | 是 | 其他模型字段 |
4.相关文章(relation):
可用参数:
参数名 | 是否必须 | 默认值 | 说明 |
catid | 否 | null | 调用栏目ID |
relation | 否 | $relation | 无需更改 |
keywords | 否 | null | 内容页面取值:$rs[keywords] |
num | 是 | null | 数据调用数量 |
代码例子:
1
2
3
4
5
|
{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} |
返回参数如下表:
字段 | 类型 | 空 | 默认 | 注释 |
---|---|---|---|---|
char(80) | 否 | NULL | 标题 | |
char | 否 | NULL | 链接地址 | |
int(10) | 否 | NULL | 发布时间 | |
char | 是 | NULL | 缩略图 | |
不定 | 是 | 其他模型字段 |
5.栏目列表(category):
可用参数:
参数名 | 是否必须 | 默认值 | 说明 |
catid | 否 | 0 | 调用该栏目下的所有栏目 ,默认0,调用一级栏目 |
$siteid | 否 | 1 | 默认调用系统站点 |
order | 否 | null | 排序方式、一般按照listorder ASC排序,即栏目的添加顺序 |
代码例子:
1
2
3
4
5
|
{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} |
返回参数如下表:
字段 | 类型 | 默认值 | 说明 |
---|---|---|---|
smallint | 无 | 栏目ID | |
tinyint(3) | 0 | 站点ID | |
varchar(15) | 无 | 模块ID | |
tinyint(1) | 1 | 栏目类型ID | |
tinyint(5) | 5 | 模型ID | |
smallint(5) | 5 | 上级父栏目 | |
varchar(255) | 无 | 所有父栏目 | |
tinyint(1) | 0 | 子栏目 | |
mediumtext | 无 | 所有子栏目 | |
varchar(30) | 无 | 栏目名称 | |
varchar(100) | 无 | 栏目图片 | |
mediumtext | 无 | 栏目描述 | |
varchar(100) | 无 | 父栏目目录 | |
varchar(30) | 无 | 栏目目录 | |
varchar(100) | 无 | 栏目链接 | |
mediumint(8) | 0 | 栏目内容数 | |
int(10) | 0 | 点击数 | |
mediumtext | 无 | 栏目设置 | |
smallint(5) | 0 | 排序 | |
tinyint(1) | 0 | 是否显示 | |
tinyint(1) | 0 | 是否生成到根目录 | |
varchar(30) | 无 | 栏目拼音 |
这个形式所代表的是参数。每一个PHPCMS V9模型都为其PC标签定义了调用的参数。其中有一些调用参数是系统保留的参数,其对所有的PC标签都是有效的。
参数必须使用
2 参数名="参数值"
的方式填写,多个参数之间使用空格分开(如下例),参数值可使用双引号来包括,无论是什么形式的引号都必须是成对出现的。
3 {pc:content 参数名="参数值" 参数名="参数值" 参数名="参数值"}
请查看PC标签保留参数相关章节,以了解具体保留参数及其用途。
PC标签分类:
PC标签包含两个类别,分别为:
4工具类
5.模块类
工具类,大体上可以理解为PHPCMS V9所提供的一些工具箱。请查看PC标签工具箱相关章节,以了解更多关于工具类的PC标签的更多信息。
而模块 类,是PHPCMS V9各个模型提供给大家调用模块 数据的数据接口。查看具体模块的相关说明章节,以了解更多关于模块类的PC标签的更多信息。
如何显示PC标签中的数据:
默认情况下PC标签中的数据都是数组方式返回的,你都可以通过 $data 来获取到这个数组,如果你在PC标签中定义了return参数,返回的数组将使用return的值进行命令。
一般情况下你可以使用如下的方式来显示值:
123 {loop $data $key $val} <A href="{$val[url]}">{$val[title]}</A><BR> {/loop}
基中的$val[url]和$val[title]需要具体根据所使用的PC标签,返回的数据来判断。
(编辑:360°搜索建站)