【phpcms-v9】前台content模块中pc标签的调用说明

内容模块PC标签调用说明.

模块名:content

模块提供的可用操作:

1. 操作名         说明   
2.    
3. lists           内容数据列表    
4. relation        内容相关文章    
5. hits            内容数据点击排行榜    
6. category        内容栏目列表    
7. position        内容推荐位列表  

内容推荐位列表position,可用参数:

1. 参数名     是否必须        默认值     说明   
2.    
3. posid       是       null        推荐位ID    
4. catid       否       null        调用栏目ID    
5. thumb       否       0           是否仅必须缩略图    
6. order       否       null        排序类型    
7. num         是       null        数据调用数量  

代码例子:

1. {pc:content  action="position" posid="2" order="listorder DESC" num="4"}   
2.     <ul>   
3.    
4.         {loop $data $key $val}   
5.    
6.         <li> <a href="{$val['url']}">{$val['title']}</a></li>   
7.    
8.         {/loop}   
9.    
10.     </ul>   
11.    
12.     {/pc}   

1. 字段      类型      空   默认      注释    
2. title       char(80)    否   NULL        推荐位标题    
3. url         char        否   NULL        推荐位链接地址    
4. inputtime   int(10)     否   NULL        推荐位发布时间    
5. thumb       char        是   NULL        推荐位缩略图    
6. 其他          不定      是   根据模型所设置的加入到推荐位中字段名称  

内容列表,lists,可用参数:

1. 参数名     是否必须            默认值     说明   
2.       
3.    catid       否           null        调用栏目ID ,此参数必不可少，因为要根据此函数的值来设置模型、选择模型数据表   
4.    where       否           null        sql语句的where部分    
5.    thumb       否           0       是否仅必须缩略图    
6.    order       否           null        排序类型    
7.    num         是           null        数据调用数量    
8.    moreinfo    否           0       是否调用副表数据   

也可以自定义多个参数名,如：aa、bb、cc，这些参数的值都可以再lists方法中通过$data['aa']、$data['bb']、$data['cc']来获取到参数的值,这样的话我们就可以根据 业务的需要,给pc标签添加任意多个参数作为条件用于lists方法中的流程控制,这一点个人感觉phpcms-v9做的比较灵活,非常便于二次开发.

如:{pc:content  action="lists" catid="2" aa='aa' bb='bb' c='cc' order="id DESC" num="4"}{/pc}  

提醒:从PHPCMS V9 Beta 20101105版本开始支持moreinfo参数属性,本参数表示在返回数据的时候,会把副表中的数据也一起返回.

一个内容模型分为2个表,一个主表一个副表,主表中一般是保存了标题、所属栏目等等短小的数据,方便用于索引,而副表则保存了大字段的数据,如内容等数据,在模型管理中新建字段的时候,是允许你选择存入到主表还是副表的,我们推荐的是,把不重要的信息放到副表中,想要在列表中调取副表的数据就需要在PC标签中使用moreinfo这个属性.

代码例子:

1. {pc:content  action="lists" catid="2" order="id DESC" num="4"}   
2.    
3.     <ul>   
4.    
5.         {loop $data $key $val}   
6.    
7.         <li> <a href="{$val['url']}">{$val['title']}</a></li>   
8.          //开源软件:Vevb.com 
9.         {/loop}   
10.    
11.     </ul>   
12.    
13.     {/pc}   

where用法:

1. {pc:content  action="lists" catid="2" where="`thumb`!='' AND `status`=99" order="id DESC" num="4"}   
2.    
3.     <ul>   
4.    
5.         {loop $data $key $val}   
6.    
7.         <li> <a href="{$val['url']}">{$val['title']}</a></li>   
8.    
9.         {/loop}   
10.    
11.     </ul>   
12.    
13.     {/pc}   

返回参数如下表:

1. 字段      类型      空       默认      注释   
2.        
3.     title       char(80)    否       NULL        推荐位标题    
4.     url         char        否       NULL        推荐位链接地址    
5.     inputtime   int(10)     否       NULL        推荐位发布时间    
6.     thumb       char        是       NULL        推荐位缩略图    
7.     其他          不定      是       其他模型字段    

点击排行榜,hits,可用参数:

1. 参数名     是否必须            默认值     说明    
2.    
3.     catid       否           null        调用栏目ID    
4.     day         否           0       调用多少天内的排行    
5.     order       否           null        排序类型（本月排行- monthviews DESC 、本周排行 - weekviews DESC、今日排行 - dayviews DESC）    
6.     num         是           null        数据调用数量    

代码例子:

1. {pc:content  action="hits" catid="2" order="weekviews DESC" num="10"}   
2.    
3.     <ul>   
4.    
5.         {loop $data $key $val}   
6.   //开源软件:Vevb.com 
7.         <li> <a href="{$val['url']}">{$val['title']}</a></li>   
8.    
9.         {/loop}   
10.    
11.     </ul>   
12.    
13.     {/pc}   

返回参数如下表:

1. 字段      类型          空       默认      注释   
2.    
3. title       char(80)    否       NULL        推荐位标题    
4. url         char        否       NULL        推荐位链接地址    
5. inputtime   int(10)     否       NULL        推荐位发布时间    
6. thumb       char        是       NULL        推荐位缩略图    
7. 其他          不定      是       其他模型字段    

相关文章,relation,可用参数:

1. 参数名     是否必须            默认值     说明    
2. catid       否           null        调用栏目ID    
3. relation    否           $relation   关联文章id    
4. keywords    否           null        热词搜索    
5. num         是           null        数据调用数量    

代码例子:

1. {pc:content action="relation" relation="$relation" catid="$catid" num="5" keywords="$rs[keywords]"}   
2.        
3.          {loop $data $r}    
4.    
5.           <li><a href="{$r[url]}" target="_blank">{$r[title]}</a><span>({date('Y-m-d',$r[inputtime])})</span></li>    
6.             
7.          {/loop}    
8.     {/pc}   

返回参数如下表:

1. 字段          类型      空       默认      注释   
2.    
3. title       char(80)    否       NULL        推荐位标题    
4. url         char        否       NULL        推荐位链接地址    
5. inputtime   int(10)     否       NULL        推荐位发布时间    
6. thumb       char        是       NULL        推荐位缩略图    
7. 其他          不定      是       其他模型字段 

栏目列表,category,可用参数:

1. 参数名     是否必须            默认值     说明    
2.     catid       否           0       调用该栏目下的所有栏目 ，默认0，调用一级栏目    
3.     $siteid     否           1     默认调用系统站点    
4.     order       否           null      排序方式、一般按照listorder ASC排序，即栏目的添加顺序    

代码例子:

1. {pc:content action="category" catid="0" num="25" siteid="$siteid" order="listorder ASC"}   
2.    
3.         {loop $data $r}    
4.            
5.         <li><a href="{$r[url]}"><span>{$r[catname]}</span></a></li>        
6.            
7.         {/loop}   
8.    
9.     {/pc}   

返回参数如下表:

1. 字段          类型          默认值     说明     
2.    
3.     catid       smallint        无       栏目ID    
4.     siteid      tinyint(3)      0       站点ID    
5.     module      varchar(15)     无       模块ID    
6.     type        tinyint(1)      1       栏目类型ID    
7.     modelid     tinyint(5)      5       模型ID    
8.     parentid    smallint(5)     5       上级父栏目    
9.     arrparentid varchar(255)    无       所有父栏目    
10.     child       tinyint(1)      0       子栏目    
11.     arrchildid  mediumtext      无       所有子栏目    
12.     catname     varchar(30)     无       栏目名称    
13.     image       varchar(100)    无       栏目图片    
14.     description mediumtext      无       栏目描述    
15.     parentdir   varchar(100)    无       父栏目目录    
16.     catdir      varchar(30)     无       栏目目录    
17.     url         varchar(100)    无       栏目链接    
18.     items       mediumint(8)    0       栏目内容数    
19.     hits        int(10)         0       点击数    
20.     setting     mediumtext      无       栏目设置    
21.     listorder   smallint(5)     0       排序    
22.     ismenu      tinyint(1)      0       是否显示    
23.     sethtml     tinyint(1)      0       是否生成到根目录    
24.     letter      varchar(30)     无       栏目拼音