【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)記所定義的不同屬性延伸出來(lái)的別名標(biāo)記。
功能說(shuō)明:獲取指定的文檔列表
適用范圍:封面模板、列表模板、文檔模板
基本語(yǔ)法:
{dede:arclist typeid='' row='' col='' titlelen='' infolen=''
imgwidth='' imgheight='' listtype='' orderby='' keyword=''}
底層模板(InnerText)
{/dede:arclist}
屬性說(shuō)明:
[1] typeid='' 表示欄目ID,在列表模板和檔案模板中一般不需要指定,在封面模板中允許用","分開(kāi)表示多個(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='rand' 隨機(jī)獲得指定條件的文檔列表
[10] orderway='' 值為 desc 或 asc ,指定排序方式是降序還是順向排序,默認(rèn)為降序。
[11] keyword='' 表示含有指定關(guān)鍵字的文檔列表,多個(gè)關(guān)鍵字用","分開(kāi)
[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屬性將無(wú)效。
[14] att='數(shù)值' 表示自定義屬性值
[15] subday='天數(shù)' 表示在多少天以內(nèi)的文檔,通常用于獲取指定天數(shù)的熱門(mén)文檔、推薦文檔、熱門(mén)評(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)記】
功能說(shuō)明:用于獲取特定欄目或檔桉的字段值及常用的環(huán)境變量值
適用范圍:封面模板、列表模板、文檔模板
(1)基本語(yǔ)法
{dede:field name='字段名'/}
(2) 系統(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)
(3) 文檔所有內(nèi)容字段
檔案dede_archives表 和 附加表的所有字段。
【Channel 標(biāo)記】
功能說(shuō)明:用于獲取欄目列表
適用范圍:封面模板、列表模板、文檔模板
(1)基本語(yǔ)法
{dede:channel row='' type=''}
自定義樣式模板(InnerText)
{/dede:channel}
(2)屬性
[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è)屬性必須在列表模板中使用。
(3)底層模板變量
ID,typename,typedir,typelink(僅表示欄目的網(wǎng)址)
例:
{dede:channel type='top'}
<a href='[field:typelink /]'>[field:typename/]</a>
{/dede:channel}
|
注:在沒(méi)有指定typeid的情況下,type標(biāo)記與模板的環(huán)境有關(guān),如,模板生成到欄目一,那么type='son'就表示欄目一的所有子類
【Type 標(biāo)記】別名 onetype
功能說(shuō)明:表示指定的單個(gè)欄目的鏈接
適用范圍:封面模板、列表模板、文檔模板
(1)語(yǔ)法 {dede:type typeid=''}{/dede:type}
(2)屬性 typeid='欄目ID'
(3)底層模板變量
typename,typelink(僅表示欄目的網(wǎng)址)
【Autochannel 標(biāo)記】
功能說(shuō)明:表示指定排序位置的單個(gè)欄目的鏈接
適用范圍:封面模板、列表模板、文檔模板
(1)語(yǔ)法 {dede:autochannel partsort=''}{/dede:autochannel}
(2)屬性 partsort='欄目所在的排序位置'
(3)底層模板變量
typename,typelink(僅表示欄目的網(wǎng)址)
【Mytag 標(biāo)記】
功能說(shuō)明:用于獲取自定義宏標(biāo)記的內(nèi)容
適用范圍:封面模板、列表模板、文檔模板
(1)基本語(yǔ)法
{dede:mytag typeid='' name='' ismake=''/}
(2)屬性
[1] typeid = '數(shù)字' 表示欄目ID,默認(rèn)為 0,在沒(méi)有設(shè)定的欄目沒(méi)有定義這個(gè)名稱的標(biāo)記,會(huì)按如下搜索方式來(lái)搜索“先向上查找父欄目 -> 通用標(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)記】
功能說(shuō)明:用于獲取一組投票表單
適用范圍:封面模板
(1) 基本語(yǔ)法
{dede:vote id='投票ID' lineheight='22'
tablewidth='100%' titlebgcolor='#EDEDE2'
titlebackground='' tablebgcolor='#FFFFFF'}
{/dede:vote}
注:本標(biāo)記直接生成投票的HTML表單,為了讓你更方便修改其樣式,建議在后臺(tái)->投票管理的地方直接復(fù)制生成的HTML代碼來(lái)使用。
【Flink 標(biāo)記】,等同 friendlink
功能說(shuō)明:用于獲取友情鏈接
適用范圍:封面模板
(1)基本語(yǔ)法
{dede:flink type='' row='' col='' titlelen='' tablestyle=''}{/dede:flink}
(2)屬性
[1]type:鏈接類型,值:
a. textall 全部用文字顯示
b. textimage 文字和圖得混合排列
c. text 僅顯示不帶Logo的鏈接
d. image 僅顯示帶Logo的鏈接
-------------------------------------
[2]row:顯示多少行,默認(rèn)為4行
[3]col:顯示多少列,默認(rèn)為6列
[4]titlelen:站點(diǎn)文字的長(zhǎng)度
[5]tablestyle: 表示 <table 這里的內(nèi)容>
【Mynews 標(biāo)記】
功能說(shuō)明:用于獲取站內(nèi)新聞
適用范圍:封面模板
(1) 基本語(yǔ)法
{dede:mynews row='條數(shù)' titlelen='標(biāo)題長(zhǎng)度'}Innertext{/dede:mynews}
(2)屬性
[1] row 新聞條數(shù)
[2] titlelen 標(biāo)題長(zhǎng)度
(3)底層模板變量
[field:title/]、[field:writer/]、
[field:senddate function="strftime('%y-%m-%d %H:%M',@me)"/](時(shí)間)、[field:body/]
【LOOP 標(biāo)記】
功能說(shuō)明:用于調(diào)用任意表的數(shù)據(jù),一般用于調(diào)用論壇貼子之類的操作
適用范圍:所有模板
(1) 基本語(yǔ)法
{dede:loop table=' sort='' row='' if=''}
底層模板
{/dede:loop}
(2) 屬性
[1] table 表示查詢的數(shù)據(jù)表
[2] sort 用于排序的字段
[3] row 返回結(jié)果的條數(shù)
[4] if 查詢條件
(3)底層模板變量
這個(gè)標(biāo)記的底層模板變量即是被查詢表的所有字段
例:獲取Phpwind論壇的最新主題貼子
{dede:loop table=&#39;pw_threads&#39; sort=&#39;tid&#39; row=&#39;8&#39; if=&#39;&#39;}<br> <a href=&quot;/bbs/read.php?tid=[field:tid/]&quot;> &middot;[field:subject function=&quot;cn_substr(&#39;@me&#39;,30)&quot;/] ([field:lastpost function=&quot;date(&#39;m-d H:M&#39;,&#39;@me&#39;)&quot;/])</a> <br/> {/dede:loop}
【Channelartlist 標(biāo)記】
功能說(shuō)明:用于獲取當(dāng)前頻道的下級(jí)欄目的內(nèi)容列表
適用范圍:封面模板
(1)基本語(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><br>
{/dede:arclist}
</td>
</tr>
</table>
<div style='font-size:2px'> </div>
{/dede:channelArtlist}
|
除了宏標(biāo)記外,channelArtlist 是唯一一個(gè)可以直接嵌套其它標(biāo)記的標(biāo)記,不過(guò)僅限于嵌套
{dede:type}{/dede:type} 和 {dede:arclist}{/dede:arclist} 兩個(gè)標(biāo)記。
(2) 屬性
[1]typeid=0 頻道ID,默認(rèn)的情況下,嵌套的標(biāo)記使用的是這個(gè)欄目ID的下級(jí)欄目,如果你想用特定的欄目,可以用","分開(kāi)多個(gè)ID。
[2]col=2 分多列顯示
[3]tablewidth='100%' 外圍表格的大小
【List 標(biāo)記】
功能說(shuō)明:表示列表模板里的分頁(yè)內(nèi)容列表
適用范圍:僅列表模板 list_*.htm
(1)基本語(yǔ)法
{dede:list col='' titlelen=''
infolen='' imgwidth='' imgheight='' orderby='' pagesize=''}{/dede:list}
(2)屬性
[1]col 內(nèi)容列數(shù)
[2]titlelen 標(biāo)題長(zhǎng)度
[3]infolen 內(nèi)容摘要長(zhǎng)度
[4]imgwidth 縮略圖寬
[5]imgheight 縮略圖高
[6]orderby 排序方式,有效的排序方式有 senddate、pubdate、id、click、lastpost、postnum ,默認(rèn)為 sortrank
[7]pagesize 分頁(yè)大小
(3)底層模板變量
ID(同 id),title,iscommend,color,typeid,ismake,description(同 info),postnum,lastpost,shorttitle
pubdate,senddate,arcrank,click,litpic(同 picname),typedir,typename,
arcurl(同 filename),typeurl,stime(pubdate 的"0000-00-00"格式),
textlink,typelink,imglink,image
注:list標(biāo)記除了支持檔案表的基本模板變量外,還支持附加表的字段,你可以在模型管理中知道附加表支持列表使用的字段有哪些。
【Page 標(biāo)記】
功能說(shuō)明:表示分頁(yè)頁(yè)面的附加參數(shù)
適用范圍:列表模板
語(yǔ)法: {dede:page pagesize="每頁(yè)結(jié)果條數(shù)"/}
注:此標(biāo)記在dedecms3.1中已經(jīng)過(guò)期,dedecms3.1中直接把 pagesize屬性加在 list 標(biāo)記中,表示記錄分頁(yè)大小。
【Pagelist 標(biāo)記】
功能說(shuō)明:表示分頁(yè)頁(yè)碼列表
適用范圍:列表模板
(1)語(yǔ)法
{dede:pagelist listsize='3' listitem=''/}
(2)屬性
[1] listsize 表示 [1][2][3] 這些項(xiàng)的長(zhǎng)度 x 2
[2] listitem 表示頁(yè)碼樣式,可以把下面的值疊加
index 首頁(yè)
pre 上一頁(yè)
pageno 頁(yè)碼
next 下一頁(yè)
end 末頁(yè)
option 下拉跳轉(zhuǎn)框
例: {dede:pagelist listsize='3' listitem='index pre pageno next end option'/}
【Pagebreak 標(biāo)記】
功能說(shuō)明:表示文檔的分頁(yè)鏈接列表。
適用范圍:僅文檔模板。
語(yǔ)法:{dede:pagebreak/}
【Prenext 標(biāo)記】
功能說(shuō)明:表示獲取文檔“上一篇/下一篇”的鏈接列表。
適用范圍:僅文檔模板。
(1)語(yǔ)法:{dede:prenext/}
(2)屬性:
[1] get 獲取連接類型(僅2007版),get='' 同V4顯示橫排的上下頁(yè)連接, get='pre' 上一篇的連接 get='next' 下一篇連接
注:此標(biāo)記默認(rèn)為橫向排列,如果你想用豎向排列,可以用
{dede:prenext function="str_replace(' 下一篇:','<'.'br'.' />下一篇:',@me)"/}
表示
【Pagetitle 標(biāo)記】
功能說(shuō)明:表示獲取文檔的分頁(yè)標(biāo)題
適用范圍:僅文檔模板。
(1)語(yǔ)法:{dede:pagetitle style='select'/}
(2)屬性:style 表示分頁(yè)標(biāo)題的展示樣式
select 表示下拉框、link 表示文字直接鏈接
【Fieldlist 標(biāo)記】
功能說(shuō)明:獲得附加表的所有字段信息。
適用范圍:僅文檔模板。
語(yǔ)法:
{dede:fieldlist}
[field:name/] : [field:value/] <br>
{/dede:fieldlist}
【Myad 標(biāo)記】
功能說(shuō)明:獲取廣告代碼
適用范圍:所有模板。
建議在廣告管理模塊中獲取,在此不作描述
##############################################################
## 以下僅適用于DedeCms2007版
##############################################################
【Ask 標(biāo)記】
功能說(shuō)明:用于獲取最新的問(wèn)答的主題。
適用范圍:非擴(kuò)展模塊所有模板。
(1)語(yǔ)法:{dede:ask row='' qtype=''}底層模板{/dede:ask}
(2)屬性:
[1] row 記錄條數(shù)。
[2] qtype 類型 默認(rèn)為新回復(fù)問(wèn)題,commend推薦問(wèn)題 ok已解決問(wèn)題 high高分問(wèn)題
(3)底層模板:
<dd>
<span class="tclass">[<a href='[field:typeurl/]'>[field:tidname/]</a>]</span>
<span class="tlink"><a href="[field:url/]">[field:title/]</a></span>
</dd>
|
[field:typeurl/] 欄目網(wǎng)址 [field:tidname/] 欄目名稱
[field:url/] 問(wèn)題網(wǎng)址 [field:title/] 問(wèn)題標(biāo)題 [field:id/] 問(wèn)題id
【Sql 標(biāo)記】
功能說(shuō)明:用于從模板中用一個(gè)SQL查詢獲得其返回內(nèi)容。
適用范圍:非擴(kuò)展模塊所有模板。
(1)語(yǔ)法:{dede:sql sql=""}底層模板{/dede:sql}
(2)屬性:
[1] sql 完整的SQL查詢語(yǔ)句。
(3)底層模板:
SQL語(yǔ)句中查出的所有字段都可以用[field:字段名/]來(lái)調(diào)用。
【Group 標(biāo)記】
功能說(shuō)明:獲取特定條件的圈子。
適用范圍:非擴(kuò)展模塊所有模板。
(1)語(yǔ)法:{dede:group row="個(gè)數(shù)" orderby='排序條件' }底層模板{/dede:group}
(2)屬性:
[1] row 返回結(jié)果個(gè)數(shù)。
[2] orderby 排序條件,一般為: 默認(rèn) threads 發(fā)貼量, members 會(huì)員數(shù), hits 瀏覽量, stime 創(chuàng)建時(shí)間。
(3)底層模板:
[field:url/]圈子網(wǎng)址 [field:groupname/]圈子名稱 [field:icon/]圈子圖標(biāo) [field:groupid/] 圈子ID
【Groupthread 標(biāo)記】
功能說(shuō)明:獲取圈子最新發(fā)表的主題。
適用范圍:非擴(kuò)展模塊所有模板。
(1)語(yǔ)法:{dede:groupthread gid='' row='' orderby='' orderway=''}底層模板{/dede:groupthread}
(2)屬性:
[1] gid='' 圈子分類,為空或0剛表示所有分類
[2] row='' 條數(shù)
[3] orderby='' 排序條件 默認(rèn) dateline
[4] orderway=' 排序方向 desc 或 asc
(3)底層模板:
[field:url/]圈子網(wǎng)址 [field:groupname/]圈子名稱 [field:icon/]圈子圖標(biāo) [field:groupid/] 圈子ID
【booklist 標(biāo)記】
功能說(shuō)明:用于獲取最新連載圖書(shū)。
適用范圍:連載書(shū)庫(kù)。
(1)語(yǔ)法:{dede:booklist row='' booktype='' titlelen='' orderby='' catid='' author='' imgwidth='' imgheight=''}底層模板{/dede:booklist}
(2)屬性:
[1] row='' 行數(shù)
[2] booktype='' 圖書(shū)類型 1 漫畫(huà),0 小說(shuō), -1 或默認(rèn) 全部
[3] titlelen='' 標(biāo)題長(zhǎng)度
[4] orderby='' 排序
[5] catid='' 欄目ID
[6] author='' 作者
[7] imgwidth=''
[8] imgheight=''
(3)底層模板:
contenttitle,contentid,contenturl,dmbookurl,bookurl,catalogurl,cataloglink,booklink,contentlink,imglink,ischeck,booktypename
【catalog 標(biāo)記】
功能說(shuō)明:用于獲取書(shū)庫(kù)的欄目。
適用范圍:連載書(shū)庫(kù)。
(1)語(yǔ)法:{dede:catalog type=''}底層模板{/dede:catalog}
(2)屬性:
[1] type 類型 默認(rèn)為頂級(jí)欄目,type=son 表示當(dāng)前欄目的子欄目,指定特定的欄目id則為所指定的欄目。
(3)底層模板:
本標(biāo)記支持in嵌套,里面的in標(biāo)記還可以再使用一重樣式
{dede:catalog}
<dd><a href="{in:field name='url'}{/in:field}">{in:field name='classname'}{/in:field}</a></dd>
{/dede:catalog}
列出所有分類:
{dede:catalog}
<div class="book_class_form">
<dl>
<dt><a href="{in:field name='url'}{/in:field}">{in:field name='classname'}{/in:field}:</a></dt>
{in:sonlist}<dd> <a href='[field:url/]'>[field:classname/]</a></dd>{/in:sonlist}
</dl>
<div class="clear">
</div>
</div>
{/dede:catalog}
|
【chapter 標(biāo)記】
功能說(shuō)明:用于獲取圖書(shū)的章節(jié)列表,適用于book_book.htm。
適用范圍:連載書(shū)庫(kù)。
(1)語(yǔ)法:{dede:chapter}底層模板{/dede:chapter}
(2)屬性:
(3)底層模板:
url 網(wǎng)址 ch 章節(jié) title 標(biāo)題
【contentlist 標(biāo)記】
功能說(shuō)明:用于獲取最新圖書(shū)章節(jié)。
適用范圍:連載書(shū)庫(kù)。
(1)語(yǔ)法:{dede:contentlist row='' booktype='' titlelen='' catid=''}底層模板{/dede:contentlist}
(2)屬性:
[1] row 條數(shù)
[2] booktype 圖書(shū)類型 1 漫畫(huà),0 小說(shuō), -1 或默認(rèn) 全部
[3] titlelen
[4] catid 欄目ID
(3)底層模板:
contenttitle,contentid,contenturl,dmbookurl,bookurl,catalogurl,cataloglink,booklink,contentlink,imglink,ischeck,booktypename
本標(biāo)記實(shí)際是由booklist引申的,不同之處是按book的最新發(fā)表章節(jié)排序