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

来源:互联网 发布:mysql补丁 编辑:程序博客网 时间:2024/05/16 02:27
[html] view plaincopy
  1. 内容模块PC标签调用说明  
  2.   
  3. 模块名:content  
  4.   
  5. 模块提供的可用操作  
  6.   
  7.     操作名         说明  
  8.       
  9.     lists           内容数据列表   
  10.     relation        内容相关文章   
  11.     hits            内容数据点击排行榜   
  12.     category        内容栏目列表   
  13.     position        内容推荐位列表   
  14.   
  15.   
  16. --------------------------------------------------------------------------------  
  17.   
  18. 内容推荐位列表(position):  
  19.   
  20. 可用参数:  
  21.   
  22.     参数名     是否必须        默认值     说明  
  23.       
  24.     posid       是       null        推荐位ID   
  25.     catid       否       null        调用栏目ID   
  26.     thumb       否       0           是否仅必须缩略图   
  27.     order       否       null        排序类型   
  28.     num         是       null        数据调用数量   
  29.   
  30.   
  31. 代码例子:  
  32.   
  33.     {pc:content  action="position" posid="2" order="listorder DESC" num="4"}  
  34.   
  35.     <ul>  
  36.   
  37.         {loop $data $key $val}  
  38.   
  39.         <li> <a href="{$val['url']}">{$val['title']}</a></li>  
  40.   
  41.         {/loop}  
  42.   
  43.     </ul>  
  44.   
  45.     {/pc}  
  46.   
  47. 返回参数如下表:  
  48.   
  49.     字段      类型      空   默认      注释   
  50.     title       char(80)    否   NULL        推荐位标题   
  51.     url         char        否   NULL        推荐位链接地址   
  52.     inputtime   int(10)     否   NULL        推荐位发布时间   
  53.     thumb       char        是   NULL        推荐位缩略图   
  54.     其他          不定      是   根据模型所设置的加入到推荐位中字段名称   
  55.   
  56.    
  57.   
  58.   
  59. --------------------------------------------------------------------------------  
  60.   
  61. 内容列表(lists):  
  62.   
  63. 可用参数:  
  64.   
  65.     参数名     是否必须            默认值     说明  
  66.       
  67.     catid       否           null        调用栏目ID ,此参数必不可少,因为要根据此函数的值来设置模型、选择模型数据表  
  68.     where       否           null        sql语句的where部分   
  69.     thumb       否           0       是否仅必须缩略图   
  70.     order       否           null        排序类型   
  71.     num         是           null        数据调用数量   
  72.     moreinfo    否           0       是否调用副表数据   
  73.   
  74. 也可以自定义多个参数名,如:aa、bb、cc,这些参数的值都可以再lists方法中通过$data['aa']、$data['bb']、$data['cc']来获取到参数的值,这样的话我们就可以根据  
  75. 业务的需要,给pc标签添加任意多个参数作为条件用于lists方法中的流程控制,这一点个人感觉phpcms-v9做的比较灵活,非常便于二次开发  
  76. 如:{pc:content  action="lists" catid="2" aa='aa' bb='bb' c='cc' order="id DESC" num="4"}{/pc}  
  77.   
  78.   
  79. 提醒:从PHPCMS V9 Beta 20101105版本开始支持moreinfo参数属性,本参数表示在返回数据的时候,会把副表中的数据也一起返回。  
  80. 一个内容模型分为2个表,一个主表一个副表,主表中一般是保存了标题、所属栏目等等短小的数据(方便用于索引),而副表则保存  
  81. 了大字段的数据,如内容等数据。在模型管理中新建字段的时候,是允许你选择存入到主表还是副表的(我们推荐的是,把不重要的  
  82. 信息放到副表中)。想要在列表中调取副表的数据就需要在PC标签中使用moreinfo这个属性。  
  83.   
  84. 代码例子:  
  85.   
  86.     {pc:content  action="lists" catid="2" order="id DESC" num="4"}  
  87.   
  88.     <ul>  
  89.   
  90.         {loop $data $key $val}  
  91.   
  92.         <li> <a href="{$val['url']}">{$val['title']}</a></li>  
  93.   
  94.         {/loop}  
  95.   
  96.     </ul>  
  97.   
  98.     {/pc}  
  99.   
  100.   
  101. where用法:  
  102.   
  103.   
  104.     {pc:content  action="lists" catid="2" where="`thumb`!='' AND `status`=99" order="id DESC" num="4"}  
  105.   
  106.     <ul>  
  107.   
  108.         {loop $data $key $val}  
  109.   
  110.         <li> <a href="{$val['url']}">{$val['title']}</a></li>  
  111.   
  112.         {/loop}  
  113.   
  114.     </ul>  
  115.   
  116.     {/pc}  
  117.   
  118. 返回参数如下表:  
  119.   
  120.     字段      类型      空       默认      注释  
  121.       
  122.     title       char(80)    否       NULL        推荐位标题   
  123.     url         char        否       NULL        推荐位链接地址   
  124.     inputtime   int(10)     否       NULL        推荐位发布时间   
  125.     thumb       char        是       NULL        推荐位缩略图   
  126.     其他          不定      是       其他模型字段   
  127.   
  128. --------------------------------------------------------------------------------  
  129.   
  130. 点击排行榜(hits):  
  131.   
  132. 可用参数:  
  133.   
  134.     参数名     是否必须            默认值     说明   
  135.   
  136.     catid       否           null        调用栏目ID   
  137.     day         否           0       调用多少天内的排行   
  138.     order       否           null        排序类型(本月排行- monthviews DESC 、本周排行 - weekviews DESC、今日排行 - dayviews DESC)   
  139.     num         是           null        数据调用数量   
  140.   
  141. 代码例子:  
  142.   
  143.     {pc:content  action="hits" catid="2" order="weekviews DESC" num="10"}  
  144.   
  145.     <ul>  
  146.   
  147.         {loop $data $key $val}  
  148.   
  149.         <li> <a href="{$val['url']}">{$val['title']}</a></li>  
  150.   
  151.         {/loop}  
  152.   
  153.     </ul>  
  154.   
  155.     {/pc}  
  156.   
  157. 返回参数如下表:  
  158.   
  159.     字段      类型          空       默认      注释  
  160.       
  161.     title       char(80)    否       NULL        推荐位标题   
  162.     url         char        否       NULL        推荐位链接地址   
  163.     inputtime   int(10)     否       NULL        推荐位发布时间   
  164.     thumb       char        是       NULL        推荐位缩略图   
  165.     其他          不定      是       其他模型字段   
  166.   
  167. --------------------------------------------------------------------------------  
  168.   
  169. 相关文章(relation):  
  170.   
  171. 可用参数:   
  172.   
  173.     参数名     是否必须            默认值     说明   
  174.     catid       否           null        调用栏目ID   
  175.     relation    否           $relation   关联文章id   
  176.     keywords    否           null        热词搜索   
  177.     num         是           null        数据调用数量   
  178.   
  179.    
  180.   
  181.    
  182.   
  183. 代码例子:  
  184.   
  185.     {pc:content action="relation" relation="$relation" catid="$catid" num="5" keywords="$rs[keywords]"}  
  186.       
  187.          {loop $data $r}   
  188.   
  189.           <li><a href="{$r[url]}" target="_blank">{$r[title]}</a><span>({date('Y-m-d',$r[inputtime])})</span></li>   
  190.            
  191.          {/loop}   
  192.     {/pc}  
  193.   
  194. 返回参数如下表:  
  195.   
  196.     字段          类型      空       默认      注释  
  197.       
  198.     title       char(80)    否       NULL        推荐位标题   
  199.     url         char        否       NULL        推荐位链接地址   
  200.     inputtime   int(10)     否       NULL        推荐位发布时间   
  201.     thumb       char        是       NULL        推荐位缩略图   
  202.     其他          不定      是       其他模型字段   
  203.   
  204. --------------------------------------------------------------------------------  
  205.   
  206. 栏目列表(category):  
  207.   
  208. 可用参数:  
  209.   
  210.     参数名     是否必须            默认值     说明   
  211.     catid       否               0       调用该栏目下的所有栏目 ,默认0,调用一级栏目   
  212.     $siteid     否               1       默认调用系统站点   
  213.     order       否           null        排序方式、一般按照listorder ASC排序,即栏目的添加顺序   
  214.   
  215.    
  216.   
  217. 代码例子:  
  218.   
  219.     {pc:content action="category" catid="0" num="25" siteid="$siteid" order="listorder ASC"}  
  220.   
  221.         {loop $data $r}   
  222.           
  223.         <li><a href="{$r[url]}"><span>{$r[catname]}</span></a></li>       
  224.           
  225.         {/loop}  
  226.   
  227.     {/pc}  
  228.   
  229. 返回参数如下表:  
  230.   
  231.     字段          类型          默认值     说明    
  232.   
  233.     catid       smallint        无       栏目ID   
  234.     siteid      tinyint(3)      0       站点ID   
  235.     module      varchar(15)     无       模块ID   
  236.     type        tinyint(1)      1       栏目类型ID   
  237.     modelid     tinyint(5)      5       模型ID   
  238.     parentid    smallint(5)     5       上级父栏目   
  239.     arrparentid varchar(255)    无       所有父栏目   
  240.     child       tinyint(1)      0       子栏目   
  241.     arrchildid  mediumtext      无       所有子栏目   
  242.     catname     varchar(30)     无       栏目名称   
  243.     image       varchar(100)    无       栏目图片   
  244.     description mediumtext      无       栏目描述   
  245.     parentdir   varchar(100)    无       父栏目目录   
  246.     catdir      varchar(30)     无       栏目目录   
  247.     url         varchar(100)    无       栏目链接   
  248.     items       mediumint(8)    0       栏目内容数   
  249.     hits        int(10)         0       点击数   
  250.     setting     mediumtext      无       栏目设置   
  251.     listorder   smallint(5)     0       排序   
  252.     ismenu      tinyint(1)      0       是否显示   
  253.     sethtml     tinyint(1)      0       是否生成到根目录   
  254.     letter      varchar(30)     无       栏目拼音    
0 0