一、织梦模板解析引擎概述 在了解DedeCms的模板代码之前，了解一下织梦模板引擎的知识是非常有意义的。织梦模板引擎是一种使用XML名字空间形式的模板解析器，使用织梦解析 器_ k | h解析模板的最大好处是可以轻松的制定标记的属性y W n，感觉上就像在用HTML一样，使模板代码十分直观灵活，新版的织梦模板引擎不单能实现模板的解析还能~ c M分 析模板里错误的s 8 ^ N | !标记。
1、织梦模板引擎的代码样式有如下几种形式：
{dede:标记名称 属性='值'/}
{dede:标记名称 属性='值'}{/dede:标记名称}
{dede:标记名称 属性='值'}自定义样式模板(InnerText){/dede:标记名称}
提示：
对于{dede:标记名称 属性='值'}{/dq G E D N wede:标记名称}这种形式的标记，在2.1版中，表示结束只需要用“{/dede}”，但
V3中需要严格用“{/dede:标记名称}”，否则会报错。
2、织梦模板引擎内置有多个系统标记，这些系统标记在任何场合都是能直接使用的。
(1) global 标记，表示获取一个外部变量，除了数据库密码之外，能调用系统的任何配置参数，形式为J . k O L i：
{dede:global n= G I w Hame='变量名称'}{/dede:global}
或
{dede:global namk r * s . P $ ,e='变量名称' /}
其中变量名称不能加 $ 符号，如变量 $cfg_cmspath ，应该写成0 ^ m A A s {dede:global name='cfg_cmspath' /} 。
(2) foreach 用来输出一z - 1个数组，形式为：
{dede:foreach array='数组名称'}[field:key/] [field:value/]{/dede:foreach}
(3) include 引入一个文件，形式为：
{dede:include file='文件名称' /}
对文件的搜索路径为顺序为：绝对路径、include文件夹，CMS3 Y g @安装目录，CMS主模板目录
3、织梦标记允许在任何标记中使用函数对得到的值进& ~ A & A 2 2 ,行处理，形式为：
{dede:标记名称 属性='值' function='youx p c U W % V ? ,function("参数一","参数二","@me")'/}
其S { u中 @me 用于表示当前标记的值，其它参数由你的函数决定是否存在，例如：
{dede:field name='pubdate' function='strL i \ E n U 6 X ,ftime("%^ u ]Y-%m-%d %H:%M:%S","@me")' /}
二、DedeCms 模板制作规范
DedeCms系统的模板是非固定的，用户可以在新建栏目时可以自行选择栏目模板，官方仅提供最基本的默认模板，即是内置O J d z , g @系统模型的各个模板，DedeCms支持自定义频道模型，用户自定义新频道模型后，需要按该模型N u @ 1设计一套新的模板。
一、概念，设计和使用模板，必须要理解下面几个概念：
1、板块（封面）模板：
指网站主页或比较重要的栏目封面使用的模板，一般用“index_识别ID.htm”命名，此外，用户单独定义的单个页面或自定义标记，a i S ? 6 @也可选是否支持板块模板标记，如果支持，系统会用板块模板标记引擎去解析后才输出内容或生成特定的文件。
2] x Z C W n、列表模板：
指网站某个栏目的所有文章@ j U列表的模板，一般X ` = \ a C z ! ;用 “list_识别ID.h) , Itm” 命名。
3、档案模板? D Y {：
表示文档查看页的模板，一般用 “T j { larticle_识别ID.htm” 命名。
4、其它模板：
一般h ( { ? 8 2系统常= n O D - R规包含的模板有：主页模板、搜索模板、ＲＳＳ、ＪＳ编译功能模板等，此外用户也可以自定义一个模板创建为任意文件。
二、 命名，为了规范起见，织梦官方建议使用统一的方式来命名模板，具体如下：
1、模板保存位置：
模板目录：c g d J p｛cmspath/templets/样式名称（英文，默认为deB % f [ ? 0 Afault，其中system为系; r 0 V & } h [ c统底层模板，plh n 6 @ (us为插件使用的模板X & 6）/具体功能模板文件｝
一般的模板位置：“/templets/default”
2、 模板文件命名规范：
（１）index_识别ID.htm： 表示板块（栏目封面）模板；
（２）list_识别ID.htm： 表示栏目列表模板；
（３）article_识{ 9 N T G } _别ID.htm： 表示内容查看页（文档模板，包括专题查看页）；
（４）search.htm： 搜索结果列表模板；
（５）index.htm： 主页模板；
注解：
你的系统各个; W N \ 7 r \内容频道的[识别ID]分别为L b F { D & s U：
例：list_image.htm 表示是就是内容类型为图片集的栏目默认列表模板。
三、主要标记参考
1、arclist 标记
这个标记是Dede% = G X ~ eCms最常用的一个标记，其中` ; + P D P d hotart、coolart、likeart、artlist、imglist、imginfolist、spI M 8 J q 9 qecart 这些标记都是由这个标记所定义的不同属性延伸出来的。
作用：获取一个指定的文档列表
适用范围：封面模板、列表模板、文档模板
(1)基本语法：
{dede:arclist
typeid='' row='' col='' titlelen=''
infolen='' imgwidp u E \ : Vth='' imgheight='' listtype='' orderby='' keyword=''}
自定义样式模板(InnerText)
{/dede:arclist}
本标记等同于artlist{ o n、imglist、imginfolist标记，其中与artlist是完全等同的，与imglist、imginfolist仅是默认的底层模I 8 U板不同。
(2)属性参考：
[1] typeid='' 表示栏目IDv B ^，在列表模板和档案模板中一般不需要B 0 - l U T \ + R指定，在封面模板中允许用","分开表示多个栏目；
[2] row='' 表示% % s 5 m d返回: l 3 ,文档行数，如果和col联合使用，刚结果数等于row * col；
[3] col='x / o 4' 表示分多少列显示（默认为单列）；
[4] titlelen='' 表示标题长度；
[5] infolenn o [ \ % U y='' 表示内容简介长度；
[6] imgwidth='' 表示缩略图宽度；
[7] imgheight='' 表示缩略图高度；
[8] type='' 表示档案类型，其中默认值或type='all'时为普通文档
ty) 3 [ a / r O Ape='commend'时，表示^ ) M K 3 :推荐文档，等同于
type='image'时，表示必须含有x @ r x 9 r W s缩略图片的文档
[9] orderby='x C ; = g' 表示排序方式，默T \ l认值是 senddateP ~ E # ` b 9 按发布时间排列。
orderby='hot' 或 orderby='click' 表示按点击数排列
orderby='pubdate' 按出版时间排列（即是前台允许更改的时间值）
orderby='sortrank'A r F U 4 S S [ 按文章的新排序级别排序（如果你想使用置顶文章则使用这个属性）
orderby='id' 按文章ID排序
[10] keyword='' 表示含有指定关键字的文档列表，多个关键字用","分开
[11] channel} 1 ) . sid( # | b b ) : Z='数字' 表示特定的频道类型，内置的频道：专题(-1)、文章(1)、图集(2)、flash(4)、软件(3)
[12] limit='起始,结束' 表示限定的记录范围，row属性必须等于"结束 - 起始"，mysql的limitq # L B R s 7 l语句是由0起始的，如 “limit 0,5”表示的是取9 h ~ , l X ; j前五笔记录，“limit 5,5”表示由| 3 W s z 7 p第五笔记录起，取下五笔记录。
(3)K p w + I r y底层模板变量
ID(同 id),title,iscommend,color,typeid,ismake,description(同 info),
pubdate,senddate,arcrank,click,litpic% v l 6 r(同 picname),typedir,C j ? k L C }typename,
arcurl(同 filename),typeurl,stimv M 8 $ : ` ~ p Fe(pubdate 的"0000-00-V x i V y00"格式),
textlink,typelink,imglink,image
其中：
textlink = <a href='http://www.dede58.com/a/dedejq/arcurl'>title</a&~ A N T 2 ~ !gt;
typelink = <a href='http://www.dede58.com/a/dedeY Z H hjq/typeurl'>typename&= F =lt;/a>
imglink = <a href='http://www.dede58.c] c Y g yom/a/dedejq/arcurl'><img src='http://www.dede58.com/a/@ K r -dedejq/picname' border='0' width='imgwidth' height='imgheight'></a>
image = <img src='http://www.dede58.com/a/dedejq6 D = c 3 W/p: M Xicname' border='0' width='imgwidth' hA 9 xeight=B * 2 f _ L @ 9'imgheight'>
变量调用方法：[field:varname /]
如：
{dede:arclist infou \ R i t R G Wlen='100'}
[field:textlink /]
<I Q [;br>
[field:info /]
<br>
{/dede:arclist}
2、field 标记
这个标记用于获取特定栏目q _ e 5 3 7或档桉的字段值及常用的环境变量值A [ 4 & / e S D
适用范围：封面模板、列表模板、文档模板
(1)基本语法
{dede:field name=''/}
(2) name 属性的值：
板块模板：phpurl,indexurl,indexname,templeturl,memberurl,powerby,w % 0 R 0 6 j z )webname,specurl
列表模板：posit( t { \ion,S 7 }title,phpurl,templeturl,memberurl,powerby,indexurl,indexname,specurl,栏目表dede_arcty$ # P spe的所有字段
其中 position 为 “栏O - R目一 > 栏目二”i T P 这样形式的{ } E a k f l链接，title则为这种形式0 M M C O 2的标题
文档模板：position,phpurl,N L 2 1templeturl,memberurl,powerby,indexurl,indexname,specurl,id(同 ID,aid),档案dede_archives表和附加表的所有字段。
3、channel 标记
用于获取栏目列表
适用范围：封面模板、列表模板、文档模板
(1)基本语法
{dede:channel row='' type=''}
自定义样式模板(InnerText)
{/dede:channw O B B x ` o t vel}
(2)属性
[1] row='数字' 表示获取记录的条数（通用在某级栏目太多的时候使用，默认是 8）
[2] type = to` 5 e Dp,sun,selu b a T C + j i .f
ty3 ) 3 p G Q `pe='top' 表示D x {顶级栏目
type='sun' 表示下级栏目
type='self' 表示同级栏目
其中后两个属性必须在列表模板中使用。
(3)底层模板变量
ID,typename,typedir,typelink(这里仅表示栏目的网址)
例：
{dede:channel type='top'}
<a href='http://www.dede58.com/a/dedejq/[field:typelink /]'>[field:typename/]</a>
{/dede:channel}
4、mytag 标记
用于获取自定义标记的内容
适用范围：封面模板、列表模板、文p : ] `档模板
(1)基本语法
{dede:mytag typeid='' name='' ismaY l V 9 5 z tke='' /}
(2)属性
[1] typeid = '数字' 表示栏目ID，默认为 0，在没有设定的= ` C @ 9 A栏目没有定义这个名称的标记，会按如下搜索方式来搜索“先P % 8向上查找父栏目 -> 通用标记（typeid=0）的同名标记”。
[2] name = '' 标记名称。
[3] ismake = yes|no 默认为 no 表示mytaA 5 $ L q b ~g里的内容不包含其它封面模板的标记，yes则表示标记内容含有其它封面模板标记。
5、vote 标记
用于获取一组投票表单
适用范围：封面模板
(1) 基7 _ - \ c c 4 \本语法
{dede:vote id='投票ID' lineheight='22'
tablewidth='100%' titlebgcolor={ m R k o !'#EDEDE2'
titlebackground='' tablebgcolor# b H c='#FFFF4 } A 2 /FF'}
{/dede:vote}
6、friendlink 标记，等同 flink
用于获取友情链接
适用范围：封面模板
(1)基本语法
{dede:flink typ\ # v 0 : n / Ee='' row='' col='' titlelen='' tablestyle=''}{/dede:flink}
属性注解：
[1]type：链接类型，值：
a. textall 全部用文字显G O p & b v示
b. textimage 文字和图得混合排列
c. texV c ; Jt 仅显示不带Logo的链接
d. image 仅显示带Logo的链接
-------------------------------------
[2]row：显示多少行，默认为4行
[3]col：显示多少列，默认为6列
[4]titlelen：站点文字的长度
[5]tablestyle： 表示 <table 这里的内容>
7、x _ g o 9mynews 标记
用于获取站| $ X c S l o _内新闻
适a / i 7 k F用范围：封面模板
(1) 基本语法
{dede:mynews row='条数' titlelen='标题长度'}Innertext{/dede:mynews}
Innertext支持的字段为% % q：[field:title /],[field:writer /],[field:sendh F ;date /](时间),[field:body /]
8、loop 标记
用于调用任意表的数据，一般用于调用论坛贴子之类的操作，请参阅论坛扩展插件。
9、channelartlist 标记
用于获取频道的下级栏目的内容列表
适用范围：封面模板
语法：
{dede:channelArtlist typeid=0 col=2 tablewidth='100%'}
<table we X V 3 Vidth="99%" border="0" cT w * zellpadm f H ] Vding="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='http://www.dede58.com/a/dedejq/[field:global name='cfg_plus_dir'/]/img/% { - Rchannellist.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>
<A G ; % K r/td>
</tr>
</table>
{/dede:type}
</td>
</tr>
<tr>
<td height="150" valign="top" bgcolor="#FFFFFF">
{dede:arclist row="8"}
<a href="http://www.dede58.com/a/dedejq/[fiB _ Keld:arcurl /]">[field:title /]</a><br>
{/dede:arclist}
</td>2 L R @ 5
<5 \ k =/tr>
</table&g) ` ] 8 a r * _t;
<p> </p>
{/dede:channelArtlist}
channelArtlist 是唯一一个可以直接嵌套其它标记的标记，不过仅限于嵌套
{dede:type}{/dede:t9 v ; 3 aype} 和 {dede:arclist}{/dI b ] q i eede:arclist}
标记。
(1) 属性
typeb Q 4 9 7id=0 频道ID,默认的情况下，嵌套的标记使用的是这个栏目ID的下级栏目，如果你想用特定的栏目，可以用","分开多个ID。
col=2 分多列显示
tablewidth='100%' 外围表格的大小
10、page 标记
表示分页页面的附加参数
适用范围：列表模板
语法：
{dede:page pagesize="每页结果条数"/}
11、list 标记
表示列表模板里的内容列表
语法：G v o Z ?
{dede:list col='' titlelen=''
infolen='' imgwidth='' imgheigW d ~ht='' orderby=''}{/dede:list}
底层模板变量
ID(同 id),title,iscommend,color,tg i X zypeid,ismake,descriptN U L ) Lion(同 info),
pubdate,seJ m e / f 7 / 9nddatd N K y \e,arcrank,click,litpic(同 picname),typedir,typename,
arcurl(同 filename),typeurl,stime(pubdate 的^ m Q & ? U U"0000-9 ~ ; @ G w00-00"格式),
textlinX ~ f f z a { Kk,typelink,imglink,image
12、pagelist 标记
表示分页页码列表
适用范围：列表模板
语法：
{dede:pagelist listsize="3"/}
listsize 表示 [1][2][3] 这些项的长度 x 2
13、pagebreak 标记
用途：表示文档的分页链接列表。
适用范围：仅文档模板。
语法：{dede:pagebreak /}
14、 fieldlist 标记
用途：获得附加表的所有字段信息。
适用范围：仅文档模板。
语法：
{dede:fieldlist}
[field:name /] ： [field:value /] <br>
{/dede:fieldlist}
