dede article 标签使用详解

航空

标签名称：arclist
' Z" B0 M; W8 d/ F5 K: J标记简介：织梦常用标记，也称为自由列表标记，其中imglist、imginfolist、specart、coolart、autolist都是由该标记所定义的不同属性延伸出来的别名标记。
8 L7 C' R( N7 ?功能说明：获取指定文档列表
适用范围：全局使用
- R; x7 r0 E$ l5 w% Z  ?基本语法：
{dede:arclist flag='h' typeid='' row='' col='' titlelen='' infolen='' imgwidth='' imgheight='' listtype='' orderby='' keyword='' limit='0,1'}
; |0 n7 g7 }3 V1 @# b! A$ O/ U<a href='[field:arcurl/]'>[field:title/]</a>
1 \) K$ `7 d' N4 i/ h{/dede:arclist}
" e2 H( c" G. u2 o0 i2 C* \3 V

typeid='' 栏目ID,在列表模板和档案模板中一般不需要指定，在首页模板中允许用","分开表示多个栏目；

, z- g  ]) R- \4 v

orderby='sortrank' 文档排序方式 § orderby='hot' 或 orderby='click' 表示按点击数排列 * h# z2 N, P* w6 T0 M§ orderby='sortrank' 或 orderby='pubdate' 按出版时间排列 6 s" q9 F3 M! R$ P( b0 |0 v§ orderby='near' 0 R  |* n/ E* \- J! h1 U- Y& {§ orderby=='lastpost' 按最后评论时间 § orderby=='scores' 按得分排序 § orderby='id' 按文章ID排序 ' j7 W! m* p& j2 l) A: Z5 z§ orderby='rand' 随机获得指定条件的文档列表

- Y3 U2 b* B% T; x

idlist ='' 提取特定文档（文档ID） 调用指定id文档 例子idlist ='4,45,78,237' limit='起始ID,记录数' （起始ID从0开始）表示限定的记录范围（如：limit='1,2' 表示从ID为1的记录开始，取2条记录） 5 t; y* P3 m% b: c2 Tkeyword='' 含有指定关键字的文档列表，多个关键字用","分 / d8 Q$ {. V4 porderway='desc' 值为 desc 或 asc ，指定排序方式是降序还是顺向排序，默认为降序

& V4 R, k) N8 }9 p8 P+ J2 e使用实例
调用推荐文章

{dede:arclist flag="c" channelid='' row='10' titlelen='60' orderby=''} " o/ a* j0 O! D- {            <li><a href='[field:arcurl /]' title="[field:fulltitle /]">[field:title /]</a></li>          {/dede:arclist}       row='10' 调用10条, titlelen='60'标题长度为30汉字 flag="c" 推荐文章 orderby='' 默认为按发布时间排序      flag = 'c' 自定义属性值：头条[h] 推荐[c] 图片[p] 幻灯[f] 滚动 跳转[j] 图文[a] 加粗

调用最新文章按发布时间排序
3 C2 R6 C% {" l* k1 k: S8 e

{dede:arclist channelid='' row='10' titlelen='60'}             <li><a href='[field:arcurl /]' title="[field:fulltitle /]">[field:title /]</a></li> 8 L1 s/ W* k. S6 G8 \         {/dede:arclist}        row='10' 调用10条, titlelen='60'标题长度为30汉字

按ID排序降序排列,从大到小
& t. u6 m$ l! j- f- ?# F2 @

{dede:arclist channelid='' row='10' titlelen='60' orderby='id' } / ?7 K2 ~4 O! q: C4 ~            <li><a href='[field:arcurl /]' title="[field:fulltitle /]">[field:title /]</a></li> 2 K. ?$ U/ X2 i         {/dede:arclist}        row='10' 调用10条, titlelen='60'标题长度为30汉字 orderby='id' 按ID,降序排列

+ Q: z% t+ M$ ?3 y按ID排序顺序排列,从小到大
1 F0 X' i$ l6 |2 J# c7 l4 ^

{dede:arclist channelid='' row='10' titlelen='60' orderby='id' orderway='asc'  } ; B2 v3 @5 H7 S' m" Q4 |0 J/ L            <li><a href='[field:arcurl /]' title="[field:fulltitle /]">[field:title /]</a></li>          {/dede:arclist}        row='10' 调用10条, titlelen='60'标题长度为30汉字 orderby='id' 按ID,orderway='desc' 值为 desc 或 asc ，指定排序方式是降序还是顺向排序，默认为降序 # \7 O0 X' n  _

调用含有缩图的文档
7 x' D- B, p, ^) B

{dede:arclist flag="p" row='10' titlelen='60'} 7 i! Z# p; e$ A% j9 N            <li><a href="[field:arcurl /]"><img src="[field:litpic/]" border="0" alt="[field:fulltitle /]"></a> 2 m5 L7 a9 Y  \; V- \) z) |& U( }            <span><a href="[field:arcurl /]" title="[field:fulltitle /]">[field:title /]</a></span> 3 z- r4 L7 w: x+ r  z! T            </li> 7 J# I/ l1 [( C7 h; P         {/dede:arclist}      flag = 'p' 自定义属性值：头条[h] 推荐[c] 图片[p] 幻灯[f] 滚动 跳转[j] 图文[a] 加粗

日期的各种格式
1 _, w5 L! d- R0 |0 N2 u

08                   [field:pubdate function=strftime('%d',@me)/] # _# q( ~% v! O$ L! {08 日                 [field:pubdate function=strftime('%d日',@me)/] 06-08                 [field:pubdate function=strftime('%m-%d',@me)/] 06月08日              [field:pubdate function=strftime('%m月%d日',@me)/] 09-06-08              [field:pubdate function=strftime('%y-%m-%d',@me)/] 2009-06-08            [field:pubdate function=strftime('%Y-%m-%d',@me)/] 09年06月08日          [field:pubdate function=strftime('%y年%m月%d日',@me)/] 2009年06月08日        [field:pubdate function=strftime('%Y年%m月%d日',@me)/] ; ?* f. s5 X  `  k. I2009-06-08   13:28     [field:pubdate function=strftime('%Y-%m-%d %H:%M',@me)/]

底层字段
" O6 g! C4 K. m

[field:id /] 文章的ID,对应dede_archives 的ID字段 [field:typeid /] 文章所在栏目的ID * [field:title/] 文章标题(控制条件包括titlelen=''字节数,后台发布文档时所选的标题颜色,加粗) * [field:fulltitle/] 文章标题(标题完整,无样式) * [field:click /] 点击数 [field:shorttitle /] 短标题 * [field:writer /] 作者 * [field:source /] 来源 * [field:litpic /] 缩图地址 与 [field:picname /]相同 [field:picname /] 缩图地址 与[field:litpic /]相同 * [field:pubdate /] 发布日期 / z) \$ I; Z0 ]. T: b2 e( X$ `' N08              [field:pubdate function=strftime('%d',@me)/] 08 日            [field:pubdate function=strftime('%d日',@me)/] 06-08            [field:pubdate function=strftime('%m-%d',@me)/] 06月08日         [field:pubdate function=strftime('%m月%d日',@me)/] % G# h& v( F+ H# f& g09-06-08         [field:pubdate function=strftime('%y-%m-%d',@me)/] 2009-06-08       [field:pubdate function=strftime('%Y-%m-%d',@me)/] 09年06月08日     [field:pubdate function=strftime('%y年%m月%d日',@me)/] 2009年06月08日   [field:pubdate function=strftime('%Y年%m月%d日',@me)/] 6 y1 x3 G' C2 _2009-06-08   13:28[field:pubdate function=strftime('%Y-%m-%d %H:%M',@me)/] [field:lastpost /] 最后评论时间 用法同 [field:pubdate /] [field:scores /] 评论得分 [field:goodpost /] 好评 [field:badpost/] 差评 * [field:description /] 简介 等同于 [field:info /] ,[field:infos /] 字数控制 [field:description   function="cn_substr(@me,120)"/] 60汉字 infolen='160' 表示内容简介长度 等同于infolength（只控制infos，并不控制description的内容） * [field:info /] 简介 等同于 [field:description /] ,[field:infos /] % f  o4 ?6 ]* x2 p3 I/ n9 u字数控制 [field:info function="cn_substr(@me,120)"/] 60汉字 infolen='160' 表示内容简介长度 等同于infolength（只控制infos，并不控制description的内容） * [field:infos /] 简介 等同于 [field:info /] ,[field:description /] 字数控制 [field:infos   function="cn_substr(@me,120)"/] 60汉字 ! ?! B+ S- H- D0 n0 D2 |  }" sinfolen='160' 表示内容简介长度 等同于infolength（只控制infos，并不控制description的内容） [field:filename /] 文章连接地址 等同于[field:arcurl /] * [field:arcurl /] 文章链接地址 等同于[field:filename /] * [field:textlink /] 文章标题+地址 等同于<a href='[field:arcurl /] '>[field:title/]</a> * [field:litpic /] 缩图地址 等同于   [field:picname /] * [field:picname /] 缩图地址 等同于   [field:litpic /] * [field:image /] 等同于 <img src='[field:litpic /]' border='0' width='imgwidth' height='imgheight' alt='[field:fulltitle /]'> imgwidth='120' 缩略图宽度 + G5 S8 Q9 X6 n$ C* aimgheight='90' 缩略图高度 * [field:imglink /] 等同于imglink = <a href=' [field:arcurl /]'>[field:image /]</a> * [field:typename /]   栏目标题 * [field:typeurl /] 栏目地址 * [field:typelink /] 等同于   <a href='[field:typeurl /]'>[field:typename /]</a> [field:plusurl /]   pius文件夹地址 等同于 [field:global name=plusurl/] [field:memberurl /]   会员文件夹地址 等同于 [field:global name=memberurl/] [field:templeturl /]    模板文文件夹地址 等同于 [field:global name=templeturl /] * [field:global name=autoindex/] 最常用的底层标签,生成顺序数字1,2,3,4,5,6,7..... 0 h: P$ f  `1 ?& d  x# f可CSS控制可做成各种样式效果,比如隔行换色, 列表前加入1-10数字序号,每隔几行换行等等 于PHP搭配,可制作出各种效果,为DEDE最重要代码之一 BY天工开物 www.dedevip.com 4 F. p1 Z3 ]+ M6 \

+ u8 E/ I$ s3 o5 ^6 [' p. B( I6 W
& p7 e- n# W% C相关函数：
; x; Y- `0 R7 S+ l$ K4 e& k6 d文件\include\taglib\arclist.lib.php第7行
% A+ E  F$ E$ a- @# Ofunction lib_arclist(&$ctag,&$refObj)
' k4 D+ h9 F7 S% c) D( Y参数说明：
5 I& x7 x6 L' Wcol='' 分多少列显示（默认为单列），5.3版中本属性可以通过多种方式进行多行显示
7 |; W! C  c: k; t, A; o  i如果col='1'要多列显示的可用div+css实现
+ W5 U( {+ R: `  X3 ?9 S. U以下为通过div+css实现多列的示例：
0 t) f: r2 Y0 s( r$ L) k" n& G- o<style type=text/css>
# L! f% }5 t8 J( {" Y) P5 o" j8 gdiv{width:400px;float:left;}
, ^) Z* n3 C4 |- o( M4 q8 _! V</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多列方式显示
  V# H# e+ D- C8 ?% Yrow='10' 返回文档列表总数
( }( w: K) h# i- H- ftypeid='' 栏目ID,在列表模板和档案模板中一般不需要指定，在首页模板中允许用","分开表示多个栏目；
getall='1' 在没有指定这属性的情况下,在栏目页、文章页模板,不会获取以","分开的多个栏目的下级子类
" ^3 ]+ L# w! Etitlelen = '30' 标题长度 等同于titlelength
% ~& t4 s5 c9 V; Ninfolen='160' 表示内容简介长度 等同于infolength（只控制infos，并不控制description的内容）
imgwidth='120' 缩略图宽度
imgheight='90' 缩略图高度
- C: \$ F) c+ V+ a/ E7 ^6 v6 jlisttype='all' 栏目类型 image含有缩略图 commend推荐
orderby='sortrank' 文档排序方式
§ orderby='hot' 或 orderby='click' 表示按点击数排列
& k( m& ?9 R3 n! |7 z. }& k  S§ orderby='sortrank' 或 orderby='pubdate' 按出版时间排列
0 w5 K1 s5 V4 @& W7 U) q/ ^§ orderby='near'
§ orderby=='lastpost' 按最后评论时间
§ orderby=='scores' 按得分排序
2 p8 z' ]3 O/ {5 q9 ^5 K§ orderby='id' 按文章ID排序
§ orderby='rand' 随机获得指定条件的文档列表
keyword='' 含有指定关键字的文档列表，多个关键字用","分
innertext = '' 单条记录样式
aid='' 指定文档ID
& p' _' q4 E) Zidlist ='' 提取特定文档（文档ID）
channelid 频道ID
limit='起始ID,记录数' （起始ID从0开始）表示限定的记录范围（如：limit='1,2' 表示从ID为1的记录开始，取2条记录）
( m9 P$ w5 Z. K2 u. _flag = 'h' 自定义属性值：头条[h]推荐[c]图片[p]幻灯[f]滚动跳转[j]图文[a]加粗
noflag = '' 同flag，但这里是表示不包含这些属性
orderway='desc' 值为 desc 或 asc ，指定排序方式是降序还是顺向排序，默认为降序
subday='天数' 表示在多少天以内的文档
' J& a& f1 ?* i, x3 c# p- I
用arclist调用于附加表字段的方法：
2 s4 u2 m1 L3 e9 c

要获取附加表内容，必须符合两个条件
1、指定 channelid 属性
2、指定要获得的字段 addfields='字段1,字段'
4 z3 P- }0 Q( C3 }' ^如：
% k% `7 G4 l& u% f& {, e' O  L5 H6 _{dede:arclist addfields='filetype,language,softtype' row='8' channelid='3'}
* A( `9 n" Q9 q; _4 `[field:textlink /] - [field:softtype /]<br />
' x$ @2 b2 G& Z6 o7 ^4 S8 L" z{/dede:arclist}

底层模板字段：
( x2 r# Q( x, E4 R) o* PID(同 id),typeid,sortrank,flag,ismake,channel,arcrank,click,money,title,shorttitle,color,writer,
) b% M6 t2 z+ r' g& g8 Nsource,litpic(同picname),pubdate,senddate,mid, lastpost,scores,goodpost,badpost,notpost,
' S' v- Q! M( [; Z! X; fdescription(同infos),filename, image, imglink, fulltitle, textlink, typelink,plusurl, memberurl, templeturl,
! _8 e2 A) P& y  ^stime(pubdate 的"0000-00-00"格式)
其中：
- ~0 U4 c1 s8 @% D4 Atextlink = <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’>
% x; `- Y& P3 t9 ]! ?字段调用方法：[field:varname/]
/ ^1 A: g9 g, D" C. A3 E3 d如：
{dede:arclist infolen='100'}
[field:textlink/]
: y, P2 I  W7 w& @$ Q( K<br>
1 E5 X% M; _; c3 o4 B[field:infos/]
4 ]; Q1 r3 d6 p+ ^5 W7 p6 h: G<br>
8 \, ~3 V1 L0 R% k8 k& \+ x{/dede:arclist}
注：底层模板里的Field实现也是织梦标记的一种形式，因此支持使用PHP语法，Function扩展等功能。
. _7 n# G7 D8 {! e如： 给当天发布的内容加上 (new) 标志
$ k0 o# o8 m8 T& q, M  N[field:senddate runphp='yes']
$ntime = time();
$oneday = 3600 * 24;
! F! h. W5 v3 k  Sif(($ntime - @me)<$oneday) @me = "<font color='red'>(new)</font>";
" f$ k- Z% v7 I) l. Kelse @me = "";
& c3 `2 {. f$ q, S[/field:senddate]
0 V  H( I3 i$ Z) |8 t/ ^' |# @$ U, q2 r  \