織夢DedeCMS建站系統(tǒng)模板標(biāo)簽代碼參考

{dede:arclist typeid='' row='' col='' titlelen='' infolen=''

imgwidth='' imgheight='' listtype='' orderby='' keyword=''}

底層模板(InnerText)

{/dede:arclist}

[1] typeid='' 表示欄目ID，在列表模板和檔案模板中一般不需要指定，在封面模板中允許用"，"分開表示多個欄目；

[2] row='' 表示返回文檔列表總數(shù)；

[3] col='' 表示分多少列顯示（默認(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'時，表示專題，等同于標(biāo)記{dede:specart}{/dede:specart}

以上屬性值可以聯(lián)合使用，如： type='commend image' 表示推薦的圖片文檔

[9] orderby='' 表示排序方式，默認(rèn)值是 senddate 按發(fā)布時間排列。

§ orderby='hot' 或 orderby='click' 表示按點擊數(shù)排列

§ orderby='pubdate' 按出版時間排列（即是前臺允許更改的時間值）

§ orderby='sortrank' 按文章的新排序級別排序（如果你想使用置頂文章則使用這個屬性）

§ orderby='id' 按文章ID排序

§ orderby='postnum' 按文章評論次數(shù)排序

§ orderby='rand' 隨機獲得指定條件的文檔列表

[10] orderway='' 值為 desc 或 asc ，指定排序方式是降序還是順向排序，默認(rèn)為降序。

[11] keyword='' 表示含有指定關(guān)鍵字的文檔列表，多個關(guān)鍵字用"，"分開

[12] channelid='' 表示特定的頻道模型ID，內(nèi)置的頻道：專題(-1)、文章(1)、圖集(2)、Flash(4)、軟件(3)

[13] limit='起始，結(jié)束' 表示限定的記錄范圍，row屬性必須等于"結(jié)束 - 起始"，mysql的limit語句是由0起始的，如 “l(fā)imit 0，5”表示的是取前五筆記錄，“l(fā)imit 5，5”表示由第五筆記錄起，取下五筆記錄，使用了本屬性后，row屬性將無效。

[14] att='數(shù)值' 表示自定義屬性值

[15] subday='天數(shù)' 表示在多少天以內(nèi)的文檔，通常用于獲取指定天數(shù)的熱門文檔、推薦文檔、熱門評論文檔等

[16] partsort='排列位數(shù)' 表示自動獲得父欄目的所有子數(shù)中排列在第幾位的欄目ID，標(biāo)記為 {dede:autolist}{/dede:autolist} 時，使用本屬性才有效。

底層模板字段：

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實現(xiàn)也是織夢標(biāo)記的一種形式，因此支持使用PHP語法，F(xiàn)unction擴展等功能

如： 給當(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)境變量值

適用范圍：封面模板、列表模板、文檔模板

(1)基本語法

{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)記】

功能說明：用于獲取欄目列表

適用范圍：封面模板、列表模板、文檔模板

(1)基本語法

{dede:channel row='' type=''}

自定義樣式模板(InnerText)

{/dede:channel}

(2)屬性

[1] row='數(shù)字' 表示獲取記錄的條數(shù)（通用在某級欄目太多的時候使用，默認(rèn)是 8）

[2] type = top，sun/son，self

type='top' 表示頂級欄目

type='son' 或 'sun' 表示下級欄目

type='self' 表示同級欄目

其中后兩個屬性必須在列表模板中使用。

(3)底層模板變量

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

功能說明：表示指定的單個欄目的鏈接

適用范圍：封面模板、列表模板、文檔模板

(1)語法 {dede:type typeid=''}{/dede:type}

(2)屬性 typeid='欄目ID'

(3)底層模板變量

typename，typelink(僅表示欄目的網(wǎng)址)

【Autochannel 標(biāo)記】

功能說明：表示指定排序位置的單個欄目的鏈接

適用范圍：封面模板、列表模板、文檔模板

(1)語法 {dede:autochannel partsort=''}{/dede:autochannel}

(2)屬性 partsort='欄目所在的排序位置'

(3)底層模板變量

typename，typelink(僅表示欄目的網(wǎng)址)

【Mytag 標(biāo)記】

功能說明：用于獲取自定義宏標(biāo)記的內(nèi)容

適用范圍：封面模板、列表模板、文檔模板

(1)基本語法

{dede:mytag typeid='' name='' ismake=''/}

(2)屬性

[1] typeid = '數(shù)字' 表示欄目ID，默認(rèn)為 0，在沒有設(shè)定的欄目沒有定義這個名稱的標(biāo)記，會按如下搜索方式來搜索“先向上查找父欄目 -> 通用標(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)記】

功能說明：用于獲取一組投票表單

適用范圍：封面模板

(1) 基本語法

{dede:vote id='投票ID' lineheight='22'

tablewidth='100%' titlebgcolor='#EDEDE2'

titlebackground='' tablebgcolor='#FFFFFF'}

{/dede:vote}

注：本標(biāo)記直接生成投票的HTML表單，為了讓你更方便修改其樣式，建議在后臺->投票管理的地方直接復(fù)制生成的HTML代碼來使用。

【Flink 標(biāo)記】，等同 friendlink

功能說明：用于獲取友情鏈接

適用范圍：封面模板

(1)基本語法

{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：站點文字的長度

[5]tablestyle： 表示 <table 這里的內(nèi)容>

【Mynews 標(biāo)記】

功能說明：用于獲取站內(nèi)新聞

適用范圍：封面模板

(1) 基本語法

{dede:mynews row='條數(shù)' titlelen='標(biāo)題長度'}Innertext{/dede:mynews}

(2)屬性

[1] row 新聞條數(shù)

[2] titlelen 標(biāo)題長度

(3)底層模板變量

[field:title/]、[field:writer/]、

[field:senddate function="strftime('%y-%m-%d %H:%M'，@me)"/](時間)、[field:body/]

【LOOP 標(biāo)記】

功能說明：用于調(diào)用任意表的數(shù)據(jù)，一般用于調(diào)用論壇貼子之類的操作

適用范圍：所有模板

(1) 基本語法

{dede:loop table=' sort='' row='' if=''}

底層模板

{/dede:loop}

(2) 屬性

[1] table 表示查詢的數(shù)據(jù)表

[2] sort 用于排序的字段

[3] row 返回結(jié)果的條數(shù)

[4] if 查詢條件

(3)底層模板變量

這個標(biāo)記的底層模板變量即是被查詢表的所有字段

例：獲取Phpwind論壇的Zui新主題貼子

{dede:loop table='pw_threads' sort='tid' row='8' if=''}

·[field:subject function="cn_substr('@me'，30)"/] ([field:lastpost function="date('m-d H:M'，'@me')"/])

{/dede:loop}

【Channelartlist 標(biāo)記】

功能說明：用于獲取當(dāng)前頻道的下級欄目的內(nèi)容列表

適用范圍：封面模板

(1)基本語法

{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>

<p style='font-size:2px'>&nbsp;</p>

{/dede:channelArtlist}

除了宏標(biāo)記外，channelArtlist 是唯一一個可以直接嵌套其它標(biāo)記的標(biāo)記，不過僅限于嵌套

{dede:type}{/dede:type} 和 {dede:arclist}{/dede:arclist} 兩個標(biāo)記。

(2) 屬性

[1]typeid=0 頻道ID，默認(rèn)的情況下，嵌套的標(biāo)記使用的是這個欄目ID的下級欄目，如果你想用特定的欄目，可以用"，"分開多個ID。

[2]col=2 分多列顯示

[3]tablewidth='100%' 外圍表格的大小

【List 標(biāo)記】

功能說明：表示列表模板里的分頁內(nèi)容列表

適用范圍：僅列表模板 list_*.htm

(1)基本語法

{dede:list col='' titlelen=''

infolen='' imgwidth='' imgheight='' orderby='' pagesize=''}{/dede:list}

(2)屬性

[1]col 內(nèi)容列數(shù)

[2]titlelen 標(biāo)題長度

[3]infolen 內(nèi)容摘要長度

[4]imgwidth 縮略圖寬

[5]imgheight 縮略圖高

[6]orderby 排序方式，有效的排序方式有 senddate、pubdate、id、click、lastpost、postnum ，默認(rèn)為 sortrank

[7]pagesize 分頁大小

(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)記】

功能說明：表示分頁頁面的附加參數(shù)

適用范圍：列表模板

語法： {dede:page pagesize="每頁結(jié)果條數(shù)"/}

注：此標(biāo)記在dedecms3.1中已經(jīng)過期，dedecms3.1中直接把 pagesize屬性加在 list 標(biāo)記中，表示記錄分頁大小。

【Pagelist 標(biāo)記】

功能說明：表示分頁頁碼列表

適用范圍：列表模板

(1)語法

{dede:pagelist listsize='3' listitem=''/}

(2)屬性

[1] listsize 表示 [1][2][3] 這些項的長度 x 2

[2] listitem 表示頁碼樣式，可以把下面的值疊加

index首頁

pre 上一頁

pageno 頁碼

next 下一頁

end 末頁

option 下拉跳轉(zhuǎn)框

例： {dede:pagelist listsize='3' listitem='index pre pageno next end option'/}

【Pagebreak 標(biāo)記】

功能說明：表示文檔的分頁鏈接列表。

適用范圍：僅文檔模板。

語法：{dede:pagebreak/}

【Prenext 標(biāo)記】

功能說明：表示獲取文檔“上一篇／下一篇”的鏈接列表。

適用范圍：僅文檔模板。

(1)語法：{dede:prenext/}

(2)屬性：

[1] get 獲取連接類型（僅2007版），get='' 同V4顯示橫排的上下頁連接， get='pre' 上一篇的連接 get='next' 下一篇連接

注：此標(biāo)記默認(rèn)為橫向排列，如果你想用豎向排列，可以用

{dede:prenext function="str_replace(' 下一篇：'，'<'.'br'.' />下一篇：'，@me)"/}

表示

【Pagetitle 標(biāo)記】

功能說明：表示獲取文檔的分頁標(biāo)題

適用范圍：僅文檔模板。

(1)語法：{dede:pagetitle style='select'/}

(2)屬性：style 表示分頁標(biāo)題的展示樣式

select 表示下拉框、link 表示文字直接鏈接

【Fieldlist 標(biāo)記】

功能說明：獲得附加表的所有字段信息。

適用范圍：僅文檔模板。

語法：

{dede:fieldlist}

[field:name/] ： [field:value/] <br>

{/dede:fieldlist}

【Myad 標(biāo)記】

功能說明：獲取廣告代碼

適用范圍：所有模板。

建議在廣告管理模塊中獲取，在此不作描述

##############################################################

## 以下僅適用于DedeCms2007版

##############################################################

【Ask 標(biāo)記】

功能說明：用于獲取Zui新的問答的主題。

適用范圍：非擴展模塊所有模板。

(1)語法：{dede:ask row='' qtype=''}底層模板{/dede:ask}

(2)屬性：

[1] row 記錄條數(shù)。

[2] qtype 類型 默認(rèn)為新回復(fù)問題，commend推薦問題 ok已解決問題 high高分問題

(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ǎng)址 [field:title/] 問題標(biāo)題 [field:id/] 問題id

【Sql 標(biāo)記】

功能說明：用于從模板中用一個SQL查詢獲得其返回內(nèi)容。

適用范圍：非擴展模塊所有模板。

(1)語法：{dede:sql sql=""}底層模板{/dede:sql}

(2)屬性：

[1] sql 完整的SQL查詢語句。

(3)底層模板：

SQL語句中查出的所有字段都可以用[field:字段名/]來調(diào)用。

【Group 標(biāo)記】

功能說明：獲取特定條件的圈子。

適用范圍：非擴展模塊所有模板。

(1)語法：{dede:group row="個數(shù)" orderby='排序條件' }底層模板{/dede:group}

(2)屬性：

[1] row 返回結(jié)果個數(shù)。

[2] orderby 排序條件，一般為： 默認(rèn) threads 發(fā)貼量，members會員數(shù)，hits瀏覽量，stime創(chuàng)建時間。

(3)底層模板：

[field:url/]圈子網(wǎng)址 [field:groupname/]圈子名稱 [field:icon/]圈子圖標(biāo) [field:groupid/] 圈子ID

【Groupthread 標(biāo)記】

功能說明：獲取圈子Zui新發(fā)表的主題。

適用范圍：非擴展模塊所有模板。

(1)語法：{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)記】

功能說明：用于獲取Zui新連載圖書。

適用范圍：連載書庫。

(1)語法：{dede:booklist row='' booktype='' titlelen='' orderby='' catid='' author='' imgwidth='' imgheight=''}底層模板{/dede:booklist}

(2)屬性：

[1] row='' 行數(shù)

[2] booktype='' 圖書類型 1 漫畫，0 小說， -1 或默認(rèn) 全部

[3] titlelen='' 標(biāo)題長度

[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)記】

功能說明：用于獲取書庫的欄目。

適用范圍：連載書庫。

(1)語法：{dede:catalog type=''}底層模板{/dede:catalog}

(2)屬性：

[1] type 類型 默認(rèn)為頂級欄目，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}

<p 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>

<p class="clear">

</p>

</p>

{/dede:catalog}

【chapter 標(biāo)記】

功能說明：用于獲取圖書的章節(jié)列表，適用于book_book.htm。

適用范圍：連載書庫。

(1)語法：{dede:chapter}底層模板{/dede:chapter}

(2)屬性：

(3)底層模板：

url 網(wǎng)址 ch 章節(jié) title 標(biāo)題

【contentlist 標(biāo)記】

功能說明：用于獲取Zui新圖書章節(jié)。

適用范圍：連載書庫。

(1)語法：{dede:contentlist row='' booktype='' titlelen='' catid=''}底層模板{/dede:contentlist}

(2)屬性：

[1] row 條數(shù)

[2] booktype 圖書類型 1 漫畫，0 小說， -1 或默認(rèn) 全部

[3] titlelen

[4] catid 欄目ID

(3)底層模板：

contenttitle，contentid，contenturl，dmbookurl，bookurl，catalogurl，cataloglink，booklink，contentlink，imglink，ischeck，booktypename

本標(biāo)記實際是由booklist引申的，不同之處是按book的Zui新發(fā)表章節(jié)排序