DedeCMS標(biāo)簽包括Arclist標(biāo)記、Field標(biāo)記、Channel標(biāo)記、Type標(biāo)記、Mytag標(biāo)記、Vote標(biāo)記、Flink 標(biāo)記等等,本文主要介紹DedeCMS標(biāo)簽的功能和用法。
一、Arclist標(biāo)記
Arclist標(biāo)記是DedeCMS中最常用的標(biāo)記之一,通常被稱為自由列表標(biāo)記。其他一些標(biāo)記,如 hotart、coolart、likeart、artlist、imglist、imginfolist、specart 和 autolist,都是基于Arclist標(biāo)記的不同屬性派生而來的。
適用范圍:可在封面模板、列表模板和文檔模板中使用。
基本語法:
{dede:arclist typeid='' row='' col='' titlelen='' infolen='' imgwidth='' imgheight='' listtype='' orderby='' keyword=''}
底層模板 (InnerText)屬性說明:
1、typeid=”:表示欄目ID。在列表模板和檔案模板中通常不需要指定,在封面模板中,可以用逗號(hào)分隔多個(gè)欄目。
2、row=”:返回文檔列表的總數(shù)。
3、col=”:顯示的列數(shù)(默認(rèn)為單列)。
4、titlelen=”:標(biāo)題的長度限制。
5、infolen=”:內(nèi)容簡介的長度限制。
6、imgwidth=”:縮略圖的寬度。
7、imgheight=”:縮略圖的高度。
8、type=”:檔案類型,取值如下:
- 空值或type=’all’:表示普通文檔;
- type=’commend’:表示推薦文檔 (等同于 {dede:coolart}{/dede:coolart});
- type=’image’:表示必須包含縮略圖的文檔 (等同于 {dede:imglist}{/dede:imglist} 和 {dede:imginfolist}{/dede:imginfolist});
- type=’spec’:表示專題文檔 (等同于 {dede:specart}{/dede:specart});
- 可以同時(shí)使用多個(gè)類型,如 type=’commend image’ 表示推薦的圖片文檔。
9、orderby=”:指定排序方式,默認(rèn)是按發(fā)布時(shí)間 (senddate) 排列??蛇x值:
- orderby=’hot’ 或 orderby=’click’:按點(diǎn)擊數(shù)排序;
- orderby=’pubdate’:按出版時(shí)間排序;
- orderby=’sortrank’:按文章的新排序級(jí)別排序;
- orderby=’id’:按文章ID排序;
- orderby=’postnum’:按評(píng)論次數(shù)排序;
- orderby=’rand’:隨機(jī)獲取文檔列表。
- 10、orderway=”:指定排序方式為降序 (desc) 或升序 (asc),默認(rèn)為降序。
11、keyword=”:獲取包含指定關(guān)鍵字的文檔,有多個(gè)關(guān)鍵字時(shí)用逗號(hào)分隔。
12、channelid=”:表示特定頻道模型ID,內(nèi)置的頻道模型包括:專題 (-1)、文章 (1)、圖集 (2)、Flash (4)、軟件 (3)。
13、limit=’起始,結(jié)束’:限制記錄的范圍,row屬性必須等于結(jié)束 – 起始。例如,“l(fā)imit 0,5”表示獲取前五筆記錄;“l(fā)imit 5,5”表示從第六筆記錄開始獲取。
14、att=’數(shù)值’:表示自定義屬性值。
15、subday=’天數(shù)’:表示獲取在指定天數(shù)內(nèi)的文檔,一般用于獲取熱門或推薦文檔。
16、partsort=’排列位數(shù)’:表示自動(dòng)獲取父欄目所有子欄目中排序的位置。
底層模板字段:ID (同id)、title、iscommend、color、typeid、ismake、description (同info)、writer、shorttitle、memberid、pubdate、senddate、arcrank、click、litpic (同picname)、typedir、typename、arcurl(同picname)、typedir、typename、arcurl(同 filename)、typeurl、stime(pubdate 的”0000-00-00″格式)、textlink、typelink、imglink、image 。
其中:
textlink = <a href='arcurl'>title</a> typelink = <a href='typeurl'>typename</a> imglink = <a href='arcurl'><img src='picname' border='0' width='imgwidth' height='imgheight'></a> image = <img src='picname' border='0' width='imgwidth' height='imgheight'>
字段調(diào)用方法:[field:varname/]
如:
{dede:arclist infolen='100'} [field:textlink/] <br> [field:info/] <br> {/dede:arclist}
注:底層模板里的Field實(shí)現(xiàn)也是DedeCMS標(biāo)記的一種形式,因此支持使用PHP語法,F(xiàn)unction擴(kuò)展等功能。
如: 給當(dāng)天發(fā)布的內(nèi)容加上 (new) 標(biāo)志
[field:senddate runphp='yes'] $ntime = time(); $oneday = 3600 * 24; if(($ntime - @me)<$oneday) @me = "<font color='red'>(new)</font>"; else @me = ""; [/field:senddate]
二、Field標(biāo)記
Field標(biāo)記用于獲取特定欄目或檔桉的字段值及常用的環(huán)境變量值。
基本語法:
{dede:field name='字段名'/}
三、Channel標(biāo)記
Channel標(biāo)記用于獲取欄目列表,適用封面模板、列表模板、文檔模板。
基本語法:
{dede:channel row='' type=''} 自定義樣式模板(InnerText) {/dede:channel}
四、Type標(biāo)記
Type標(biāo)記別名onetype,表示指定的單個(gè)欄目的鏈接。適用范圍:封面模板、列表模板、文檔模板。
語法:
{dede:type typeid=''}{/dede:type}
五、Autochannel標(biāo)記
Autochannel標(biāo)記表示指定排序位置的單個(gè)欄目的鏈接
語法:
{dede:autochannel partsort=''}{/dede:autochannel}
六、Mytag標(biāo)記
Mytag標(biāo)記用于獲取自定義宏標(biāo)記的內(nèi)容
基本語法:
{dede:mytag typeid='' name='' ismake=''/}
七、Vote標(biāo)記
Vote標(biāo)記用于獲取一組投票表單,適用封面模板。
基本語法:
{dede:vote id='投票ID' lineheight='22' tablewidth='100%' titlebgcolor='#EDEDE2' titlebackground='' tablebgcolor='#FFFFFF'}{/dede:vote}
注:本標(biāo)記直接生成投票的HTML表單,為了讓你更方便修改其樣式,建議在后臺(tái)->投票管理的地方直接復(fù)制生成的HTML代碼來使用。
八、Flink標(biāo)記
Flink標(biāo)記等同friendlink,,用于獲取友情鏈接。
基本語法:
{dede:flink type='' row='' col='' titlelen='' tablestyle=''}{/dede:flink}
九、Mynews標(biāo)記
Mynews標(biāo)記用于獲取站內(nèi)新聞
基本語法
{dede:mynews row='條數(shù)' titlelen='標(biāo)題長度'}Innertext{/dede:mynews}
十、LOOP標(biāo)記
LOOP標(biāo)記用于調(diào)用任意表的數(shù)據(jù),一般用于調(diào)用論壇貼子之類的操作
基本語法:
{dede:loop table=' sort='' row='' if=''} 底層模板 {/dede:loop}
十一、Channelartlist標(biāo)記
Channelartlist標(biāo)記用于獲取當(dāng)前頻道的下級(jí)欄目的內(nèi)容列表
基本語法:
{dede:channelArtlist typeid=0 col=2 tablewidth='100%'} <table width="99%" border="0" cellpadding="3" cellspacing="1" bgcolor="#BFCFA9"> <tr> <td bgcolor="#E6F2CC"> {dede:type} <table border="0" cellpadding="0" cellspacing="0" width="98%"> <tr> <td width='10%' align="center"><img src='[field:global name='cfg_plus_dir'/]/img/channellist.gif' width='14' height='16'></td> <td width='60%'> <a href="[field:typelink /]" rel="external nofollow" rel="external nofollow" >[field:typename /]</a> </td> <td width='30%' align='right'> <a href="[field:typelink /]" rel="external nofollow" rel="external nofollow" >更多...</a> </td> </tr> </table> {/dede:type} </td> </tr> <tr> <td height="150" valign="top" bgcolor="#FFFFFF"> {dede:arclist row="8"} ·<a href="[field:arcurl /]" rel="external nofollow" rel="external nofollow" >[field:title /]</a><br> {/dede:arclist} </td> </tr> </table> <div style='font-size:2px'> </div> {/dede:channelArtlist}
十二、List標(biāo)記
List標(biāo)記列出文章列表模板中的分頁內(nèi)容列表,僅列表模板 list_*.htm 可用。
基本語法:
{dede:arclist row="8"} ·<a href="[field:arcurl /]" rel="external nofollow" rel="external nofollow" >[field:title /]</a><br> {/dede:arclist}
十三、Page標(biāo)記
Page標(biāo)記表示分頁頁面的附加參數(shù)。
語法:
{dede:page pagesize="每頁結(jié)果條數(shù)"}/
注:此標(biāo)記在dedecms3.1中已經(jīng)過期,dedecms3.1中直接把 pagesize屬性加在 list 標(biāo)記里,表示記錄分頁大小。
十四、Pagelist標(biāo)記
Pagelist標(biāo)記表示分頁頁碼列表
語法:
{dede:pagelist listsize='3' listitem=''/}
十五、Prenext標(biāo)記
Prenext標(biāo)記表示獲取文檔“上一篇”和“下一篇”的鏈接。
語法:
{dede:prenext/}