DeDeCMS模板标签（1）
DeDeCMS模板标签
1、标签名称：adminname
功能说明：获得责任编辑名称
适用范围：仅内容模板 article_*.htm
基本语法：
{dede:adminname /}
2、标签名称：arclist
标记简介：织梦常用标记，也称为自由列表标记，其中imglist、imginfolist、specart、coolart、autolist都是由该标记所定义的不同属性延伸出来的别名标记。
功能说明：获取指定文档列表
适用范围：全局使用
基本语法：
{dede:arclist flag='h' typeid='' row='' col='' titlelen='' infolen='' imgwidth='' imgheight='' listtype='' orderby='' keyword='' limit='0,1'}
<a href='[field:arcurl/]'>[field:title/]</a>
{/dede:arclist}
参数说明：
-
- col='' 分多少列显示（默认为单列），5.3版中本属性可以通过多种方式进行多行显示，如果col='1'要多列显示的可用div+css实现，以下为通过div+css实现多列的示例：
<style type=text/css>
div{width:400px;float:left;}
</style>
{dede:arclist row='10' titlelen='24' orderby='pubdate' idlist='' col='2'}
•[field:textlink/]([field:pubdate function=MyDate('m-d',@me)/])<br/>
{/dede:arclist}
当col>1将使用原来的table多列方式显示
-
- row='10' 返回文档列表总数
- typeid='' 栏目ID,在列表模板和档案模板中一般不需要指定，在首页模板中允许用","分开表示多个栏目；
- getall='1' 在没有指定这属性的情况下,在栏目页、文章页模板,不会获取以","分开的多个栏目的下级子类
- titlelen = '30' 标题长度 等同于titlelength
- infolen='160' 表示内容简介长度 等同于infolength
- imgwidth='120' 缩略图宽度
- imgheight='90' 缩略图高度
- listtype='all' 栏目类型 image含有缩略图 commend推荐
- orderby='sortrank' 文档排序方式
§ orderby='hot' 或 orderby='click' 表示按点击数排列
§ orderby='sortrank' 或 orderby='pubdate' 按出版时间排列
§ orderby='near'
§ orderby=='lastpost' 按最后评论时间
§ orderby=='scores' 按得分排序
§ orderby='id' 按文章ID排序
§ orderby='rand' 随机获得指定条件的文档列表
-
- keyword='' 含有指定关键字的文档列表，多个关键字用","分
- innertext = '' 单条记录样式
- aid='' 指定文档ID
- idlist ='' 提取特定文档（文档ID）
- channelid 频道ID
- limit='起始ID,记录数' （起始ID从0开始）表示限定的记录范围（如：limit='1,2' 表示从ID为1的记录开始，取2条记录）
- flag = 'h' 自定义属性值：头条[h]推荐[c]图片[p]幻灯[f]滚动[s]跳转[j]图文[a]加粗[b]
- noflag = '' 同flag，但这里是表示不包含这些属性
- orderway='desc' 值为 desc 或 asc ，指定排序方式是降序还是顺向排序，默认为降序
- subday='天数' 表示在多少天以内的文档
用arclist调用于附加表字段的方法：
要获取附加表内容，必须符合两个条件
1、指定 channelid 属性
2、指定要获得的字段 addfields='字段1,字段'
如：
{dede:arclist addfields='filetype,language,softtype' row='8' channelid='3'}
[field:textlink /] - [field:softtype /]<br />
{/dede:arclist}
底层模板字段：
ID(同 id),typeid,sortrank,flag,ismake,channel,arcrank,click,money,title,shorttitle,color,writer,
source,litpic(同picname),pubdate,senddate,mid, lastpost,scores,goodpost,badpost,notpost,
description(同infos),filename, image, imglink, fulltitle, textlink, typelink,plusurl, memberurl, templeturl,
stime(pubdate 的"0000-00-00"格式)
其中：
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' alt=’titile’>
字段调用方法：[field:varname/]
如：
{dede:arclist infolen='100'}
[field:textlink/]
<br>
[field:infos/]
<br>
{/dede:arclist}
注：底层模板里的Field实现也是织梦标记的一种形式，因此支持使用PHP语法，Function扩展等功能。
如： 给当天发布的内容加上 (new) 标志
[field:senddate runphp='yes']
$ntime = time();
$oneday = 3600 * 24;
if(($ntime - @me)<$oneday) @me = "<font color='red'>(new)</font>";
else @me = "";
[/field:senddate]
[b][/b]
3、标签名称：arclistsg
功能说明：单表独立模型的文档列表调用标记
适用范围：全局使用
基本语法：
{dede:arclistsg flag='h' typeid='' row='' col='' titlelen='' orderway='' keyword='' limit='0,1'}
<a href='[field:arcurl/]'>[field:title/]</a>
{/dede:arclistsg}
参数说明：
-
- col='' 分多少列显示（默认为单列），5.3版中本属性无效，要多列显示的可用div+css实现
- row='10' 返回文档列表总数
- typeid='' 栏目ID,在列表模板和档案模板中一般不需要指定，在封面模板中允许用","分开表示多个栏目；
- titlelen = '30' 标题长度 等同于titlelength
- orderwey='desc'或'asc' 排序方向
- keyword= 含有指定关键字的文档列表，多个关键字用","分
- innertext = "[field:title/]" 单条记录样式(innertext是放在标签之间的代码)
- arcid='' 指定文档ID
- idlist ='' 提取特定文档（文档ID）
- channelid = '' 频道ID
- limit='' 起始,结束 表示限定的记录范围（如：limit='1,2'）
- flag = 'h' 自定义属性值：头条[h]推荐[c]图片[p]幻灯[f]滚动[s]跳转[j]图文[a]加粗[b]
- subday='天数' 表示在多少天以内的文档
底层模板字段：
ID(同 id),typeid, channel, arcrank, mid, click, title, senddate, flag, litpic(同picname), userip, lastpost, scores, goodpost, badpost, textlink
4、标签名称：ask
功能说明：问答调用标签
适用范围：全局使用
基本语法：
{dede:ask row='6' qtype='new' tid='0' titlelen='24'}
<dd>
<span class="tclass">[<a href='[field:typeurl/]'>[field:tidname/]</a>]</span>
<span class="tlink"><a href="[field:url/]">[field:title/]</a></span>
</dd>
{/dede:ask}
参数说明：
-
- row='6' 调用条数
- qtype='new' 排序类型 commend 推荐、ok 表示已解决问题、high 高分问题 、new 最新问题
- tid='0' 栏目id，默认是全部
- titlelen='24' 标题长度
底层模板字段：
tid,tidname,title,url,typeurl
4、标签名称：autochannel
功能说明：指定排序位置的单个栏目的链接
适用范围：全局使用
基本语法：
{dede:autochannel partsort='' typeid=’’}{/dede:autochannel}
参数说明：
partsort = '0' 栏目所在的排序位置
typeid=’0’ 获取单个栏目的顶级栏目
底层模板字段：
typename,typelink(仅表示栏目的网址)
5、标签名称：bookcontentlist
功能说明：连载图书最新内容调用
适用范围：全局使用
基本语法：
{dede:bookcontentlist row='12' booktype='-1' orderby='lastpost' author='' keyword=''}
<table width="100%" border="0" cellspacing="2" cellpadding="2">
<tr>
<td width='40%'>
[[field:cataloglink/]] [field:booklink/]</td>
<td width='40%'>[field:contentlink/]</td>
<td width='20%'>[field:lastpost function="GetDateMk(@me)"/]</td>
</tr>
</table>
{/dede:bookcontentlist}
参数说明：
-
- 这个标签和booklist实际是完全相同的，只是默认底层模板不同
- row='12' 调用记录条数
- booktype='-1' 图书类型，0 图书、1 漫画，默认全部
- orderby='lastpost' 排序类型，当按排序类型为 commend 表示推荐图书
- author='' 作者
- keyword='' 关键字（用 , 分开多个关键字）
6、标签名称：booklist
功能说明：连载图书调用
适用范围：全局使用
基本语法：
{dede:booklist row='12' booktype='-1' orderby='lastpost' author='' keyword=''}
<a href='[field:bookurl /]'>[field:bookname /]</a><br />
{/dede:booklist}
参数说明：
-
- 这个标签和bookcontentlist实际是完全相同的，只是默认底层模板不同
- row='12' 调用记录条数
- booktype='-1' 图书类型，0 图书、1 漫画，默认全部
- orderby='lastpost' 排序类型，当按排序类型为 commend 表示推荐图书
- author='' 作者
- keyword='' 关键字（用 , 分开多个关键字）
7、标签名称：channel
标记简介：织梦常用标记，通常用于网站顶部以获取站点栏目信息，方便网站会员分类浏览整站信息
功能说明：用于获取栏目列表
适用范围：全局使用
基本语法：
{dede:channel type='top' row='8' currentstyle="<li><a href='~typelink~' class='thisclass'>~typename~</a> </li>"}
<li><a href='[field:typelink/]'>[field:typename/]</a> </li>
{/dede:channel}
参数说明：
-
- typeid = '0' 栏目ID
- reid = '0' 上级栏目ID
- row = '100' 调用栏目数
- col = '1' 分多少列显示（默认为单列）
- type = 'son | sun' son表示下级栏目,self表示同级栏目,top顶级栏目
- currentstyle = '' 应用样式
底层模板字段：
ID(同 id),typeid, typelink, typename, typeurl,typedir(仅表示栏目的网址)
例：
{dede:channel type='top'}
<a href='[field:typelink /]'>[field:typename/]</a>
{/dede:channel}
注：在没有指定typeid的情况下，type标记与模板的环境有关，如，模板生成到栏目一，那么type='son'就表示栏目一的所有子类
8、标签名称：channelartlist
标记简介：
功能说明：获取当前频道的下级栏目的内容列表标签
适用范围：全局使用
基本语法：
{dede:channelartlist row=6}
<dl>
<dt><a href='{dede:field name='typeurl'/}'>{dede:field name='typename'/}</a></dt>
<dd>
{dede:arclist titlelen='42' row='10'} <ul class='autod'>
<li><a href="[field:arcurl /]">[field:title /]</a></li>
<li>([field:pubdate function="MyDate('m-d',@me)"/])</li>
</ul>
{/dede:arclist}
</dl>
{/dede:channelartlist}
参数说明：
-
- typeid = '0' 频道ID,多个请用","分隔
- row = '20' 获取的栏目返回值
其他说明：
除了宏标记外，channelArtlist 是唯一一个可以直接嵌套其它标记的标记，不过仅限于嵌套
{dede:type}{/dede:type} 和 {dede:arclist}{/dede:arclist} 两个标记。
底层模板变量：
包含{dede:type}{/dede:type}及{dede:arclist}{/dede:arclist}下面所有底层模板变量。
9、标签名称：feedback
功能说明：用于调用最新评论
适用范围：全局使用
基本语法：
{dede:feedback}
<ul>
<li class='fbtitle'>[field:username function="(@me=='guest' ? '游客' : @me)"/] 对 [field:title/] 的评论：</li>
<li class='fbmsg'> <a href="plus/feedback.php?aid=[field:aid/]" class='fbmsg'>[field:msg /]</a></li>
</ul>
{/dede:feedback}
参数说明：
-
- row='12' 调用评论条数
- titlelen='24' 标题长度
- infolen='100' 评论长度
10、标签名称：field
标记简介：织梦常用标记，通常用于栏目及内容页模板中
功能说明：用于获取特定栏目或者档案的字段值及常用的环境变量值
适用范围：全局使用
基本语法：
{dede:field name='字段名'/}
参数说明：
板块模板：phpurl,indexurl,indexname,templeturl,memberurl, specurl
列表模板：position,title,phpurl,templeturl,memberurl,indexurl,indexname,specurl,栏目表dede_arctype的所有字段
其中 position 为 “栏目一 > 栏目二” 这样形式的链接，title则为这种形式的标题
文档模板：position,phpurl,templeturl,memberurl,indexurl,indexname,specurl,id(同 ID,aid)
文档所有内容字段：
档案dede_archives表 和 附加表的所有字段。
11、标签名称：flink
标记简介：
功能说明：用于获取友情链接
适用范围：全局使用
基本语法：
{dede:flink row='24'/}
参数说明：
-
- type='image' 或textall，图片链接，text文字链接；
- row='24' 链接数量
- titlelen='24' 站点文字的长度
- linktype='2' 链接位置首页 linktype='1' 链接位置内页
- typeid='0' 所有类型，可以在系统后台[模块]-[友情链接]中的“网站类型管理”中查看
12、标签名称：group
功能说明：圈子调用标签
适用范围：全局使用
基本语法：
{dede:group row='6' orderby='threads' titlelen='30'}
<li>
<span><img style="visibility: inherit;" title="[field:groupname/]" src="[field:icon/]" /></span>
<span><a href="[field:url/]" title="[field:groupname/]" target="_blank">[field:groupname/]</a></span>
</li>
{/dede:group}
参数说明：
-
- row='6' 调用条数
- orderby='threads' 排列顺序（默认是主题数）
- titlelen='30' 圈子名称最大长度
13、标签名称：groupthread
功能说明：圈子主题调用标签
适用范围：全局使用
基本语法：
{dede:groupthread gid='0' orderby='dateline' orderway='desc' row='12' titlelen='30'}
<li>
<a href='[field:groupurl/]' target="_blank">[[field:groupname function="cn_substr(@me,10)"/]]</a>
<a href="[field:url/]" title="[field:subject/]" target="_blank">[field:subject/]</a>([field:lastpost function="GetDateMk('@me')"/])
</li>
{/dede:groupthread}
参数说明：
-
- gid='0' 圈子id，默认为全部
- orderby='dateline' 排序，默认为时间
- orderway='desc' 排序方向，默认是最新主题在前
- row='12' 记录数
- titlelen='30' 主题标题(subject)最大长度
14、标签名称：hotwords
功能说明：获取网站搜索的热门关键字
适用范围：全局使用
基本语法：
{dede:hotwords /}
参数说明：
-
- num='6' 关键词数目
- subday='365' 天数
- maxlength='16' 关键词最大长度
15、标签名称：infoguide
功能说明：分类信息的地区与小分类搜索
适用范围：全局使用
基本语法：
{dede:infoguide /}
16、标签名称：loop
标记简介：
功能说明：调用任意表的数据标签
适用范围：全局使用
基本语法：
{dede:loop table='dede_archives' sort='' row='4' if=''}
<a href='[field:arcurl/]'>[field:title/]</a>
{/dede:loop}
参数说明：
-
- table = '' 查询表名
- sort = '' 用于排序的字段
- row = '' 返回结果的条数
- if = '' 查询的条件
底层模板变量：
这个标记的底层模板变量即是被查询表的所有字段
17、标签名称：memberlist
功能说明：会员信息调用标签
适用范围：全局使用
基本语法：
{dede:memberlist orderby='scores' row='20'}
<a href="../member/index.php?uid={dede:field.userid /}">{dede:field.userid /}</a>
<span>{dede:field.scores /}</span>
{/dede:memberlist}
参数说明：
-
- row = '6' 调用数目
- iscommend = '0' 是否为推荐会员
- orderby = 'logintime' 按登陆时间排序 money 按金钱排序 scores 按积分排序
底层模板字段：
dede_member所有字段及spacename(空间名称)、sign(用户签名)
18、标签名称：myad
功能说明：获取广告代码
适用范围：全局使用
基本语法：
{dede:myad name=''/}
参数说明：
typeid='0' 投放范围,0为全站
name='' 广告标识
注：建议在广告管理模块中获取，在此不作过多描述
