【phpcms-v9】前臺content模塊中pc標籤的調用說明

  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)     無       欄目拼音    
發佈了383 篇原創文章 · 獲贊 774 · 訪問量 271萬+
發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章