PHPcms v9的模板标签

一、评论模块pc标签

评论模块PC标签调用说明

模块名：comment

模块提供的可用操作

操作名	说明
get_comment	获取评论总数据
lists	评论数据列表
bang	评论排行榜

下面对所有的操作分开说明

 

获取评论总数据（get_comment）：

可用参数：

参数名	是否必须	默认值	说明
commentid	是	null	评论的ID号

代码例子：

 

{pc:comment action="get_comment" commentid="$commentid"}

 评论ID ：{$data[commentid]}  评论总数：{$data[total]}

 {/pc}

上面的例子中输出了评论ID和评论总数，评论模块还提供了更多的数据可以输出。如下表所示：

 

字段	类型	空	默认	注释
commentid	char(30)	否		评论ID号
siteid	mediumint(8)	否	0	站点ID
title	char(255)	否		文章标题
url	char(255)	否		URL地址
total	int(8)	是	0	总评论数
square	mediumint(8)	是	0	正方评论数
anti	mediumint(8)	是	0	反方评论数
neutral	mediumint(8)	是	0	中立评论数
display_type	tinyint(1)	是	0	显示方式{1:辩论,0:列表}
lastupdate	int(10)	是	0	最后更新时间

 

评论数据列表(lists)：

可用参数：

参数名	是否必须	默认值	说明
commentid	是	null	评论的ID号
siteid	否	当前所在站点id	站点id
direction	否	0	评论方向｛0：方向，1：正方，2：反方，3：中立｝
hot	否	0	排序方式｛0：最新，1：最热｝

代码例子：

 

{pc:comment action="lists" commentid="$commentid"}

 <ul>

 {loop $data $key $val}

 <li> {$val[url]}于{format::date($val[creat_at], 1)}发布，他支持{direction($v[direction])}<br>{$val[content]}</li>

 {/loop}

 </ul>

 {/pc}

返回参数如下表：

 

字段	类型	空	默认	注释
commentid	char(30)	否		评论ID号
username	varchar(20)	是	NULL	用户名
creat_at	int(10)	是	NULL	发布时间
ip	varchar(15)	是	NULL	用户IP地址
content	text	是	NULL	评论内容
direction	tinyint(1)	是	0	评论方向{0:无方向,1:正文,2:反方,3:中立}
support	mediumint(8)	是	0	支持数

 

评论排行榜(bang)：

评论排行榜无定义参数。

 代码例子：

 

{pc:comment action="bang" num="10"}

 <ul>

 {loop $data $key $val}

 <li><a href="{$val[url]}">{$val[title]}</a>({$val[total]})</li>

 {/loop}

 </ul>

 {/pc}

返回参数如下表：

 

字段	类型	空	默认	注释
commentid	char(30)	否		评论ID号
siteid	mediumint(8)	否	0	站点ID
title	char(255)	否		文章标题
url	char(255)	否		URL地址
total	int(8)	是	0	总评论数
square	mediumint(8)	是	0	正方评论数
anti	mediumint(8)	是	0	反方评论数
neutral	mediumint(8)	是	0	中立评论数
display_type	tinyint(1)	是	0	显示方式{1:辩论,0:列表}
lastupdate	int(10)	是	0	最后更新时间

 

 

 

 

 

二、会员模块pc标签

会员模块PC标签调用说明

模块名：member

模块提供的可用操作

 

操作名	说明
favoritelist	获取收藏文章列表

 

 

 

获取收藏文章列表（favoritelist）：

可用参数：

参数名	是否必须	默认值	说明
userid	是	null	用户userid

代码例子：

 

{pc:member action="favoritelist" userid="$userid" order="id DESC"  num="10"}

 <ul class="title-list">

 {loop $data $k $v}
                 <li>·<a href="{$v['url']}" target="_blank">{$v['title']}</a><span><em>{format::date($v['adddate'], 1)}</em> </span></li>
                {/loop}

 </ur>

 {/pc}

上面的例子中输出了获取的用户userid为$userid的10条最新收藏文章

 v9_favorite表数据结构

字段	类型	空	默认	注释
id	int(10)	否		收藏标识id
userid	int(10)	否		用户id
title	char(100)	否		文章标题
url	char(100)	否		URL地址
adddate	int(10)	否		添加时间

 

 

 

三、友情链接模块pc标签

友情链接模块PC标签调用说明

模块名：link

模块提供的可用操作

 

操作名	说明
type_list	获取友情链接列表

 

 

 

获取友情链接列表（type_list）：

可用参数：

 

参数名	是否必须	默认值	说明
siteid	是	null	当前站点ID
linktype	是	1	显示方式
order	是	listorder DESC	排序方式
typeid	否	null	分类ID

代码例子：

 

{pc:link  action="type_list" typeid="4" siteid="1" linktype="1" order="listorder DESC" num="8" return="pic_link"}

 {loop $pic_link $v}

 <li><a href="{$v['url']}" title="{$v['name']}" target="_blank"><img src="{$v[logo]}" width="90" height="30" /></a></li>

 {/loop}

 {/pc}

上面的例子中输出了站点ID为1,分类ID为4的所有图片友情链接

 

字段	类型	空	默认	注释
linkid	int(10)	否		友情链接ID号
siteid	mediumint(8)	否	0	站点ID
typeid	smallint(5)	否		分类ID
linktype	tinyint(1)	否	0	链接形式
name	varchar(50)	否	0	网站名称
url	char(255)	否	0	网站URL地址
logo	varchar(255)	否	0	LOGO地址
introduce	text(0)	是	0	网站简介
username	varchar(30)	是	0	网站联系人
listorder	smallint(5)	否	0	排序值
elite	tinyint(1)	是	0	是否推荐
passed	tinyint(1)	否	1	是否通过审核
addtime	int(10)	否	0	添加时间

 

四、投票模块pc标签

投票模块PC标签调用说明

模块名：vote

模块提供的可用操作

 

操作名	说明
lists	获取投票列表
get_vote	获取投票概述

 

 

 

获取投票列表（lists）：

可用参数：

 

参数名	是否必须	默认值	说明
siteid	是	null	站点ID
enabled	否	1	显示方式
order	否	subjectid DESC	排序方式

代码例子：

 

{pc:vote action="lists" order="subjectid desc" siteid="$siteid" num="6" page="$page"  return="dat"}

 

        <ul class="wrap icon3j">

         {loop $dat $r}

         <li><a title="{$r[subject]}" target="_blank" href="{APP_PATH}index.php?m=vote&c=index&a=show&id={$r['subjectid']}">{$r[subject]}</a><span><font color="#1E50A0">(投票数: {$r[votenumber]})</font></span></li>

         {/loop}

         </ul>

         <div id="pages" class="text-c">{$pages}</div>

 {/pc}

 

上面的例子中输出了站点ID为$siteid,所有投票列表,并按subjectid倒序排列.每页6条数据.

 

五、公告模块pc标签

公告模块PC标签调用说明

模块名：announce

模块提供的可用操作

操作名	说明
lists	公告数据列表

lists操作说明如下：

 

公告数据列表（lists）：

可用参数：

参数名	是否必须	默认值	说明
siteid	否	当前站点ID	站点ID

代码例子：

 

{pc:announce action="lists" siteid="$siteid"}

 <ul>

 {loop $data $key $val}

 <li> <a href="{APP_PATH}index.php?m=announce&c=index&a=show&aid={$val['aid']}">{$val['title']}</a></li>

 {/loop}

 </ul>

 {/pc}

返回参数如下表：

字段	类型	空	默认	注释
siteid	tinyint(3)	否		所属站点ID
aid	smallint(4)	否	NULL	公告ID
title	char(80)	否	NULL	公告标题
content	text	否	NULL	公告正文
starttime	date	是	NULL	公告有效的开始时间
endtime	date	是	NUll	公告的到期时间
hits	smallint(5)	是	0	浏览数

 

六、专题模块pc标签

专题模块PC标签调用说明

模块名：special

模块提供的可用操作

操作名	说明
lists	专题列表
content_list	专题信息列表
hits	专题信息点击排序

下面对所有的操作分开说明

 

 

专题列表（lists）：

可用参数：

参数名	是否必须	默认值	说明
siteid	否	当前站点	站点ID
elite	否	null	是否推荐
isthumb	否	null	必须有缩略图
listorder	否	null	排序方式

代码例子：

 

{pc:special action="lists" siteid="$siteid" elite="1" listorder="2" num="3"}

      <div class="changeDiv">
                        {loop $data $r}
                           <a href="{$r['url']}"><img src="{thumb($r['thumb'], 224, 112)}" width="224" height="112" alt="{$r['title']}" /><p><strong>{$r['title']}</strong><br />
                {$r['description']}</p></a>
                        {/loop}
                      </div>

{/pc}

返回参数如下表：

字段	类型	空	默认	注释
siteid	smallint(5)	否		所属站点ID
id	smallint(5)	否	0	专题ID
title	char(60)	否		专题名称
thumb	char(255)	否		专题缩略图
banner	char(100)	否	0	专题横幅
description	char(255)	是	0	专题导读
url	char(100)	是	0	专题url地址
ishtml	tinyint(1)	否	0	生成静态
ispage	tinyint(1)	是	0	首页实现分页
createtime	int(10)	是	0	创建时间

 

专题信息列表（content_list）：

可用参数：

参数名	是否必须	默认值	说明
specialid	是	null	专题ID
typeid	否	null	分类ID
isthumb	否	null	必须有缩略图
listorder	否	null	排序方式

代码例子：

   

 

 {pc:special action="content_list" specialid="$specialid" typeid="$typeid" listorder="2" num="3"}

        {loop $data $r}
                                <div class="bk20 hr"><hr></div><h4 class="blue"><a href="{$r['url']}" target="_blank">{$r['title']}</a></h4>
                                <p>{str_cut($r['description'], 150)}</p>
                                {/loop}

{/pc}

返回参数如下表：

字段	类型	空	默认	注释
id	mediumint(8)	否		ID
specialid	smallint(5)	否	0	专题ID
title	char(80)	否		文章标题
typeid	smallint(5)	否		分类ID
url	char(100)	否	0	url地址
thumb	char(100)	是	0	缩略图
keywords	char(40)	是	0	关键字
inputtime	int(10)	否	0	添加时间
updatetime	int(10)	否	0	更新时间
islink	tinyint(1)	是	0	外部链接

 

专题内容排行榜（hits）：

可用参数：

参数名	是否必须	默认值	说明
specialid	否	null	专题ID
listorder	否	null	排序方式

代码例子：

 

      {pc:special action="hits" specialid="$specialid" listorder="2" num="3"}

   <ul>

    {loop $data $r}
                     <li><a href="{$r['url']}">{$r['title']}</a></li>
                   {/loop}

{/pc}

返回参数如下表：

字段	类型	空	默认	注释
hitsid	char(30)	否		ID
views	int(10)	否	0	总浏览数
yesterdayviews	int(10)	否	0	昨天浏览数
dayviews	int(10)	否	0	当日浏览数
weekviews	int(10)	否	0	本周浏览数
monthviews	int(10)	否	0	本月浏览数
url	char(100)	是	0	url地址
title	char(60)	否	0	标题

 

 

七、内容模块pc标签

内容模块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)	无	栏目拼音