编辑“DedeCMS:模板标记一”

<span style="text-align:center; border:1px solid #000; float:right; padding:6px;"><strong>导航:</strong> [[DedeCMS:模板标记介绍|上一级]] | [[DedeCMS]] | {{Template:Dede导航}}</span>
<div style="clear:both;"></div>
<strong style="color:#ad3d21;">【Arclist 标记】</strong>  
<p>&nbsp;&nbsp;这个标记是[[DedeCMS]]最常用的一个标记，也叫自由列表标记，其中 hotart、coolart、likeart、artlist、imglist、imginfolist、specart、autolist 这些标记都是由这个标记所定义的不同属性延伸出来的别名标记。</p>
<strong>功能说明：</strong>获取指定的文档列表  

<strong>适用范围：</strong>封面模板、列表模板、文档模板 

<strong>基本语法：</strong>
<pre style="border:0; background:white; padding:5px 20px 5px;">
{dede:arclist typeid='' row='' col='' titlelen='' infolen='' 
imgwidth='' imgheight='' listtype='' orderby='' keyword=''}
底层模板(InnerText)
{/dede:arclist}  
</pre>
<strong>属性说明：</strong>
<pre style="border:0; background:white; padding:5px 20px 5px;">
[1] typeid='' 表示栏目ID，在列表模板和档案模板中一般不需要指定，在封面模板中允许用","分开表示多个栏目；
[2] row='' 表示返回文档列表总数；
[3] col='' 表示分多少列显示（默认为单列）；
[4] titlelen='' 表示标题长度；
[5] infolen='' 表示内容简介长度；
[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'时，表示专题，等同于标记{dede:specart}{/dede:specart}
以上属性值可以联合使用，如： type='commend image' 表示推荐的图片文档
[9] orderby='' 表示排序方式，默认值是 senddate 按发布时间排列。 
§ orderby='hot' 或 orderby='click' 表示按点击数排列
§ orderby='pubdate' 按出版时间排列（即是前台允许更改的时间值）
§ orderby='sortrank' 按文章的新排序级别排序（如果你想使用置顶文章则使用这个属性）
§ orderby='id' 按文章ID排序
§ orderby='postnum' 按文章评论次数排序
§ orderby='rank' 随机获得指定条件的文档列表
[10] orderway='' 值为 desc 或 asc ，指定排序方式是降序还是顺向排序，默认为降序。
[11] keyword='' 表示含有指定关键字的文档列表，多个关键字用","分开
[12] channelid='' 表示特定的频道模型ID，内置的频道：专题(-1)、文章(1)、图集(2)、Flash(4)、软件(3)
[13] limit='起始,结束' 表示限定的记录范围，row属性必须等于"结束 - 起始"，mysql的limit语句是由0起始的，
如 “limit 0,5”表示的是取前五笔记录，“limit 5,5”表示由第五笔记录起，取下五笔记录，使用了本属性后，row属性将无效。
[14] att='数值' 表示自定义属性值
[15] subday='天数' 表示在多少天以内的文档，通常用于获取指定天数的热门文档、推荐文档、热门评论文档等
[16] partsort='排列位数' 表示自动获得父栏目的所有子数中排列在第几位的栏目ID，
标记为 {dede:autolist}{/dede:autolist} 时，使用本属性才有效。 
</pre>
<strong>底层模板字段：</strong>
<pre style="border:0; background:white; padding:5px 20px 5px;">
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'> 
</pre>
<strong>字段调用方法：[field:varname/]</strong>
<pre style="border:0; background:white; padding:5px 20px 5px;">
如：
{dede:arclist infolen='100'}
[field:textlink/]
<br>
[field:info/]
<br>
{/dede:arclist} 
</pre>
注：底层模板里的Field实现也是织梦标记的一种形式，因此支持使用[[PHP]]语法，Function扩展等功能

如： 给当天发布的内容加上 (new) 标志
<pre style="border:0; background:white; padding:5px 20px 5px;">
[field:senddate runphp='yes'] 
$ntime = time();
$oneday = 3600 * 24;
if(($ntime - @me)<$oneday) @me = "<font color='red'>(new)</font>";
else @me = "";
[/field:senddate]
</pre>

<strong style="color:#ad3d21;">【Field 标记】</strong>

<strong>功能说明：</strong>用于获取特定栏目或档桉的字段值及常用的环境变量值

<strong>适用范围：</strong>封面模板、列表模板、文档模板

<strong>基本语法</strong>

{dede:field name='字段名'/}

<strong>系统分配的field</strong>
<p>
板块模板：phpurl,indexurl,indexname,templeturl,memberurl,powerby,webname,specurl<br>
列表模板：position,title,phpurl,templeturl,memberurl,powerby,indexurl,indexname,specurl,栏目表dede_arctype的所有字段<br>
其中 position 为 “栏目一 > 栏目二” 这样形式的链接，title则为这种形式的标题 <br>
文档模板：position,phpurl,templeturl,memberurl,powerby,indexurl,indexname,specurl,id(同 ID,aid)</p>

<strong>文档所有内容字段</strong>

档案dede_archives表 和 附加表的所有字段。 

<strong style="color:#ad3d21;">【Channel 标记】</strong> 

<strong>功能说明：</strong>用于获取栏目列表 

<strong>适用范围：</strong>封面模板、列表模板、文档模板 

<strong>基本语法</strong>
<pre style="border:0; background:white; padding:5px 20px 5px;">
{dede:channel row='' type=''}
自定义样式模板(InnerText)
{/dede:channel} 
</pre>
<strong>属性 </strong>
<pre style="border:0; background:white; padding:5px 20px 5px;">
[1] row='数字' 表示获取记录的条数（通用在某级栏目太多的时候使用，默认是 8） 
[2] type = top,sun/son,self 
type='top' 表示顶级栏目
type='son' 或 'sun' 表示下级栏目
type='self' 表示同级栏目 
其中后两个属性必须在列表模板中使用。 
</pre>
<strong>底层模板变量 </strong>
<pre style="border:0; background:white; padding:5px 20px 5px;">
ID,typename,typedir,typelink(仅表示栏目的网址) 
例：
{dede:channel type='top'}
<a href='[field:typelink /]'>[field:typename/]</a> 
{/dede:channel} 
注：在没有指定typeid的情况下，type标记与模板的环境有关，如，模板生成到栏目一，那么type='son'就表示栏目一的所有子类
</pre>


<strong style="color:#ad3d21;">【Type 标记】别名 onetype</strong> 

<strong>功能说明：</strong>表示指定的单个栏目的链接

<strong>适用范围：</strong>封面模板、列表模板、文档模板

<strong>语法 </strong>{dede:type typeid=''}{/dede:type}

<strong>属性 </strong>typeid='栏目ID'

<strong>底层模板变量: </strong>

typename,typelink(仅表示栏目的网址)

<strong style="color:#ad3d21;">【Autochannel 标记】</strong>

<strong>功能说明：</strong>表示指定排序位置的单个栏目的链接

<strong>适用范围：</strong>封面模板、列表模板、文档模板

<strong>语法 </strong>{dede:autochannel partsort=''}{/dede:autochannel}

<strong>属性 </strong>partsort='栏目所在的排序位置'

<strong>底层模板变量</strong> 

typename,typelink(仅表示栏目的网址)

<strong style="color:#ad3d21;">【Mytag 标记】</strong> 

<strong>功能说明：</strong>用于获取自定义宏标记的内容 

<strong>适用范围：</strong>封面模板、列表模板、文档模板 

<strong>基本语法 </strong>

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

<strong>属性</strong>
<pre style="border:0; background:white; padding:5px 20px 5px;">
[1] typeid = '数字' 表示栏目ID，默认为 0，在没有设定的栏目没有定义这个名称的标记，
    会按如下搜索方式来搜索“先向上查找父栏目 -> 通用标记（typeid=0）的同名标记”。 
[2] name = '' 标记名称。 
[3] ismake = yes|no 默认为 no 表示mytag里的内容不包含其它封面模板的标记，yes则表示标记内容含有其它封面模板标记。 
</pre>

<strong style="color:#ad3d21;">【Vote 标记】</strong>

<strong>功能说明：</strong>用于获取一组投票表单 

<strong>适用范围：</strong>封面模板 

<strong>基本语法</strong>
<pre style="border:0; background:white; padding:5px 20px 5px;">
{dede:vote id='投票ID' lineheight='22'
tablewidth='100%' titlebgcolor='#EDEDE2'
titlebackground='' tablebgcolor='#FFFFFF'}
{/dede:vote} 
</pre>
注：本标记直接生成投票的HTML表单，为了让你更方便修改其样式，建议在后台->投票管理的地方直接复制生成的[[HTML]]代码来使用。

<strong style="color:#ad3d21;">【Flink 标记】，等同 friendlink </strong>

<strong>功能说明：</strong>用于获取友情链接 

<strong>适用范围：</strong>封面模板 

<strong>基本语法</strong> 

{dede:flink type='' row='' col='' titlelen='' tablestyle=''}{/dede:flink}

<strong>属性</strong>

<pre style="padding:5px 20px 5px; border:0; background:white;">
 [1]type：链接类型，值：<br>
   a. textall 全部用文字显示<br>
   b. textimage 文字和图得混合排列<br>
   c. text 仅显示不带Logo的链接<br>
   d. image 仅显示带Logo的链接<br>
 [2]row：显示多少行，默认为4行<br>
 [3]col：显示多少列，默认为6列<br>
 [4]titlelen：站点文字的长度<br>
 [5]tablestyle： 表示 <table 这里的内容> 
</pre>

<strong style="color:#ad3d21;">【Mynews 标记】</strong>

<strong>功能说明：</strong>用于获取站内新闻 

<strong>适用范围：</strong>封面模板 

<strong>基本语法 </strong>

{dede:mynews row='条数' titlelen='标题长度'}Innertext{/dede:mynews}

<strong>属性</strong>
<p style="padding:5px 20px 5px;">
[1] row 新闻条数<br>
[2] titlelen 标题长度
</p>
<strong>底层模板变量</strong>
<p style="padding:5px 20px 5px;">
[field:title/]、[field:writer/]、<br>
[field:senddate function="strftime('%y-%m-%d %H:%M',@me)"/](时间)、[field:body/] 
</p>

<strong style="color:#ad3d21;">【LOOP 标记】</strong>

<strong>功能说明：</strong>用于调用任意表的数据，一般用于调用论坛贴子之类的操作

<strong>适用范围：</strong>所有模板

<strong>基本语法</strong>

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

底层模板

{dede:loop} 

<strong>属性</strong>

<p style="padding:5px 20px 5px;">
[1] table 表示查询的数据表<br>
[2] sort 用于排序的字段<br>
[3] row 返回结果的条数<br>
[4] if 查询条件
</p>
<strong>底层模板变量</strong>
<p style="padding:5px 20px 5px;">
这个标记的底层模板变量即是被查询表的所有字段<br>
例：获取Phpwind论坛的最新主题贴子<br>
	    {dede:loop table='pw_threads' sort='tid' row='8' if=''}<br>
	    <a href="/bbs/read.php?tid=[field:tid/]"> ·[field:subject function="cn_substr('@me',30)"/] <br>
	      ([field:lastpost function="date('m-d H:M','@me')"/])</a> <br/>
	    {dede:loop}
</p>

<strong style="color:#ad3d21;">【Channelartlist 标记】</strong>

<strong>功能说明：</strong>用于获取当前频道的下级栏目的内容列表 

<strong>适用范围：</strong>封面模板 

<strong>基本语法</strong>
<pre style="border:0; background:white; padding:5px 20px 5px;">
{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'>&nbsp;</div>
{/dede:channelArtlist} 
除了宏标记外，channelArtlist 是唯一一个可以直接嵌套其它标记的标记，不过仅限于嵌套 
{dede:type}{/dede:type} 和 {dede:arclist}{/dede:arclist} 两个标记。 
</pre>
<strong>属性</strong>
<p style="padding:5px 20px 5px;">
[1]typeid=0 频道ID,默认的情况下，嵌套的标记使用的是这个栏目ID的下级栏目，如果你想用特定的栏目，可以用","分开多个ID。<br>
[2]col=2 分多列显示 <br>
[3]tablewidth='100%' 外围表格的大小 
</p>

[[Category:织梦系统|Z]]