內容模塊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)     無       欄目拼音