POST TIME:2021-05-14 11:43
【Arclist 標(biāo)記】
這個(gè)標(biāo)記是DedeCMS最常用的一個(gè)標(biāo)記,也叫自由列表標(biāo)記,其中 hotart、coolart、likeart、artlist、imglist、imginfolist、specart、autolist 這些標(biāo)記都是由這個(gè)標(biāo)記所定義的不同屬性延伸出來的別名標(biāo)記。
功能說明:獲取指定的文檔列表
適用范圍:封面模板、列表模板、文檔模板
基本語(yǔ)法:
{dede:arclist typeid='' row='' col='' titlelen='' infolen='' imgwidth='' imgheight='' listtype='' orderby='' keyword=''} 底層模板(InnerText) {/dede:arclist}
屬性說明:
[1] typeid='' 表示欄目ID,在列表模板和檔案模板中一般不需要指定,在封面模板中允許用","分開表示多個(gè)欄目; [2] row='' 表示返回文檔列表總數(shù); [3] col='' 表示分多少列顯示(默認(rèn)為單列); [4] titlelen='' 表示標(biāo)題長(zhǎng)度; [5] infolen='' 表示內(nèi)容簡(jiǎn)介長(zhǎng)度; [6] imgwidth='' 表示縮略圖寬度; [7] imgheight='' 表示縮略圖高度; [8] type='' 表示檔案類型,其中空值、不使用這個(gè)屬性或type='all'時(shí)為普通文檔 § type='commend'時(shí),表示推薦文檔,等同于 {dede:coolart}{/dede:coolart} § type='image'時(shí),表示必須含有縮略圖片的文檔,等同于{dede:imglist}{/dede:imglist}、{dede:imginfolist}{/dede:imginfolist} § type='spec'時(shí),表示專題,等同于標(biāo)記{dede:specart}{/dede:specart} 以上屬性值可以聯(lián)合使用,如: type='commend image' 表示推薦的圖片文檔 [9] orderby='' 表示排序方式,默認(rèn)值是 senddate 按發(fā)布時(shí)間排列。 § orderby='hot' 或 orderby='click' 表示按點(diǎn)擊數(shù)排列 § orderby='pubdate' 按出版時(shí)間排列(即是前臺(tái)允許更改的時(shí)間值) § orderby='sortrank' 按文章的新排序級(jí)別排序(如果你想使用置頂文章則使用這個(gè)屬性) § orderby='id' 按文章ID排序 § orderby='postnum' 按文章評(píng)論次數(shù)排序 § orderby='rank' 隨機(jī)獲得指定條件的文檔列表 [10] orderway='' 值為 desc 或 asc ,指定排序方式是降序還是順向排序,默認(rèn)為降序。 [11] keyword='' 表示含有指定關(guān)鍵字的文檔列表,多個(gè)關(guān)鍵字用","分開 [12] channelid='' 表示特定的頻道模型ID,內(nèi)置的頻道:專題(-1)、文章(1)、圖集(2)、Flash(4)、軟件(3) [13] limit='起始,結(jié)束' 表示限定的記錄范圍,row屬性必須等于"結(jié)束 - 起始",mysql的limit語(yǔ)句是由0起始的, 如 “limit 0,5”表示的是取前五筆記錄,“limit 5,5”表示由第五筆記錄起,取下五筆記錄,使用了本屬性后,row屬性將無效。 [14] att='數(shù)值' 表示自定義屬性值 [15] subday='天數(shù)' 表示在多少天以內(nèi)的文檔,通常用于獲取指定天數(shù)的熱門文檔、推薦文檔、熱門評(píng)論文檔等 [16] partsort='排列位數(shù)' 表示自動(dòng)獲得父欄目的所有子數(shù)中排列在第幾位的欄目ID, 標(biāo)記為 {dede:autolist}{/dede:autolist} 時(shí),使用本屬性才有效。
底層模板字段:
ID(同 id),title,iscommend,color,typeid,ismake,description(同 info),writer,shorttitle,memberid pubdate,senddate,arcrank,click,litpic(同 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)也是織夢(mèng)標(biāo)記的一種形式,因此支持使用PHP語(yǔ)法,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)記】
功能說明:用于獲取特定欄目或檔桉的字段值及常用的環(huán)境變量值
適用范圍:封面模板、列表模板、文檔模板
基本語(yǔ)法
{dede:field name='字段名'/}
系統(tǒng)分配的field
板塊模板:phpurl,indexurl,indexname,templeturl,memberurl,powerby,webname,specurl
列表模板:position,title,phpurl,templeturl,memberurl,powerby,indexurl,indexname,specurl,欄目表dede_arctype的所有字段
其中 position 為 “欄目一 > 欄目二” 這樣形式的鏈接,title則為這種形式的標(biāo)題
文檔模板:position,phpurl,templeturl,memberurl,powerby,indexurl,indexname,specurl,id(同 ID,aid)
文檔所有內(nèi)容字段
檔案dede_archives表 和 附加表的所有字段。
【Channel 標(biāo)記】
功能說明:用于獲取欄目列表
適用范圍:封面模板、列表模板、文檔模板
基本語(yǔ)法
{dede:channel row='' type=''} 自定義樣式模板(InnerText) {/dede:channel}
屬性
[1] row='數(shù)字' 表示獲取記錄的條數(shù)(通用在某級(jí)欄目太多的時(shí)候使用,默認(rèn)是 8) [2] type = top,sun/son,self type='top' 表示頂級(jí)欄目 type='son' 或 'sun' 表示下級(jí)欄目 type='self' 表示同級(jí)欄目 其中后兩個(gè)屬性必須在列表模板中使用。
底層模板變量
ID,typename,typedir,typelink(僅表示欄目的網(wǎng)址) 例: {dede:channel type='top'} <a href='[field:typelink /]'>[field:typename/]</a> {/dede:channel} 注:在沒有指定typeid的情況下,type標(biāo)記與模板的環(huán)境有關(guān),如,模板生成到欄目一,那么type='son'就表示欄目一的所有子類
【Type 標(biāo)記】別名 onetype
功能說明:表示指定的單個(gè)欄目的鏈接
適用范圍:封面模板、列表模板、文檔模板
語(yǔ)法 {dede:type typeid=}{/dede:type}
屬性 typeid='欄目ID'
底層模板變量:
typename,typelink(僅表示欄目的網(wǎng)址)
【Autochannel 標(biāo)記】
功能說明:表示指定排序位置的單個(gè)欄目的鏈接
適用范圍:封面模板、列表模板、文檔模板
語(yǔ)法 {dede:autochannel partsort=}{/dede:autochannel}
屬性 partsort='欄目所在的排序位置'
底層模板變量
typename,typelink(僅表示欄目的網(wǎng)址)
【Mytag 標(biāo)記】
功能說明:用于獲取自定義宏標(biāo)記的內(nèi)容
適用范圍:封面模板、列表模板、文檔模板
基本語(yǔ)法
{dede:mytag typeid= name= ismake=/}
屬性
[1] typeid = '數(shù)字' 表示欄目ID,默認(rèn)為 0,在沒有設(shè)定的欄目沒有定義這個(gè)名稱的標(biāo)記, 會(huì)按如下搜索方式來搜索“先向上查找父欄目 -> 通用標(biāo)記(typeid=0)的同名標(biāo)記”。 [2] name = '' 標(biāo)記名稱。 [3] ismake = yes|no 默認(rèn)為 no 表示mytag里的內(nèi)容不包含其它封面模板的標(biāo)記,yes則表示標(biāo)記內(nèi)容含有其它封面模板標(biāo)記。
【Vote 標(biāo)記】
功能說明:用于獲取一組投票表單
適用范圍:封面模板
基本語(yǔ)法
{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)記】,等同 friendlink
功能說明:用于獲取友情鏈接
適用范圍:封面模板
基本語(yǔ)法
{dede:flink type= row= col= titlelen= tablestyle=}{/dede:flink}
屬性
[1]type:鏈接類型,值:<br> a. textall 全部用文字顯示<br> b. textimage 文字和圖得混合排列<br> c. text 僅顯示不帶Logo的鏈接<br> d. image 僅顯示帶Logo的鏈接<br> [2]row:顯示多少行,默認(rèn)為4行<br> [3]col:顯示多少列,默認(rèn)為6列<br> [4]titlelen:站點(diǎn)文字的長(zhǎng)度<br> [5]tablestyle: 表示 <table 這里的內(nèi)容>
【Mynews 標(biāo)記】
功能說明:用于獲取站內(nèi)新聞
適用范圍:封面模板
基本語(yǔ)法
{dede:mynews row='條數(shù)' titlelen='標(biāo)題長(zhǎng)度'}Innertext{/dede:mynews}
屬性
[1] row 新聞條數(shù)
[2] titlelen 標(biāo)題長(zhǎng)度
底層模板變量
[field:title/]、[field:writer/]、
[field:senddate function="strftime('%y-%m-%d%H:%M',@me)"/](時(shí)間)、[field:body/]
【LOOP 標(biāo)記】
功能說明:用于調(diào)用任意表的數(shù)據(jù),一般用于調(diào)用論壇貼子之類的操作
適用范圍:所有模板
基本語(yǔ)法
{dede:loop table=' sort= row= if=}
底層模板
{dede:loop}
屬性
[1] table 表示查詢的數(shù)據(jù)表
[2] sort 用于排序的字段
[3] row 返回結(jié)果的條數(shù)
[4] if 查詢條件
底層模板變量
這個(gè)標(biāo)記的底層模板變量即是被查詢表的所有字段
例:獲取Phpwind論壇的最新主題貼子
{dede:loop table='pw_threads' sort='tid' row='8' if=}
<a href="/bbs/read.php?tid=[field:tid/]"> ·[field:subject function="cn_substr('@me',30)"/]
([field:lastpost function="date('m-d H:M','@me')"/])</a>
{dede:loop}
【Channelartlist 標(biāo)記】
功能說明:用于獲取當(dāng)前頻道的下級(jí)欄目的內(nèi)容列表
適用范圍:封面模板
基本語(yǔ)法
{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 /]">[field:typename /]</a> </td> <td width='30%' align='right'> <a href="[field:typelink /]">更多...</a> </td> </tr> </table> {/dede:type} </td> </tr> <tr> <td height="150" valign="top" bgcolor="#FFFFFF"> {dede:arclist row="8"} ·<a href="[field:arcurl /]">[field:title /]</a> {/dede:arclist} </td> </tr> </table> <div style='font-size:2px'></div> {/dede:channelArtlist} 除了宏標(biāo)記外,channelArtlist 是唯一一個(gè)可以直接嵌套其它標(biāo)記的標(biāo)記,不過僅限于嵌套 {dede:type}{/dede:type} 和 {dede:arclist}{/dede:arclist} 兩個(gè)標(biāo)記。
屬性
[1]typeid=0 頻道ID,默認(rèn)的情況下,嵌套的標(biāo)記使用的是這個(gè)欄目ID的下級(jí)欄目,如果你想用特定的欄目,可以用","分開多個(gè)ID。
[2]col=2 分多列顯示
[3]tablewidth='100%' 外圍表格的大小