dede article 标签使用详解

航空

标签名称：arclist
3 Y1 Q& }% |! a& r. {4 D3 d( ~9 _# t标记简介：织梦常用标记，也称为自由列表标记，其中imglist、imginfolist、specart、coolart、autolist都是由该标记所定义的不同属性延伸出来的别名标记。
; |2 ?$ G' ~6 |, l/ y- }% l* q3 l功能说明：获取指定文档列表
适用范围：全局使用
- w$ K3 r( N# Y) [基本语法：
{dede:arclist flag='h' typeid='' row='' col='' titlelen='' infolen='' imgwidth='' imgheight='' listtype='' orderby='' keyword='' limit='0,1'}
; J! j) R' N1 [9 g1 J<a href='[field:arcurl/]'>[field:title/]</a>
( ?9 J: {0 O2 O( c% z{/dede:arclist}
+ D) S: j6 i9 v) F

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

orderby='sortrank' 文档排序方式 . c/ C6 V4 _0 ~9 _' L0 S* _§ orderby='hot' 或 orderby='click' 表示按点击数排列 ; j7 C$ T- Y$ G+ D§ orderby='sortrank' 或 orderby='pubdate' 按出版时间排列 0 d! J8 `( W6 _§ orderby='near' . X( P( R' o6 @/ R& ]§ orderby=='lastpost' 按最后评论时间 + ?; {9 s4 {; W. d§ orderby=='scores' 按得分排序 0 a: o& Q- \% E/ c5 z: `& e+ c2 z§ orderby='id' 按文章ID排序 § orderby='rand' 随机获得指定条件的文档列表

idlist ='' 提取特定文档（文档ID） 调用指定id文档 例子idlist ='4,45,78,237' ' i% Y2 E# V2 h+ hlimit='起始ID,记录数' （起始ID从0开始）表示限定的记录范围（如：limit='1,2' 表示从ID为1的记录开始，取2条记录） keyword='' 含有指定关键字的文档列表，多个关键字用","分 orderway='desc' 值为 desc 或 asc ，指定排序方式是降序还是顺向排序，默认为降序

使用实例
& d/ ^6 S) j1 x5 x调用推荐文章
( g5 l6 r0 ?& T$ J# O, _# `2 \

{dede:arclist flag="c" channelid='' row='10' titlelen='60' orderby=''} & |* p+ w6 q( P6 Z% v7 b: X( h            <li><a href='[field:arcurl /]' title="[field:fulltitle /]">[field:title /]</a></li> 4 f; [! b/ s  U7 M% X         {/dede:arclist}       row='10' 调用10条, titlelen='60'标题长度为30汉字 flag="c" 推荐文章 orderby='' 默认为按发布时间排序 : y: G& Z' k  O     flag = 'c' 自定义属性值：头条[h] 推荐[c] 图片[p] 幻灯[f] 滚动 跳转[j] 图文[a] 加粗

调用最新文章按发布时间排序
4 i& f0 d6 T) ~6 j7 q2 h3 J

{dede:arclist channelid='' row='10' titlelen='60'} # K9 s3 y% \! v7 @* x$ Q. g            <li><a href='[field:arcurl /]' title="[field:fulltitle /]">[field:title /]</a></li>          {/dede:arclist}        row='10' 调用10条, titlelen='60'标题长度为30汉字

5 X2 ]$ y& ~! [' E4 \- A按ID排序降序排列,从大到小

{dede:arclist channelid='' row='10' titlelen='60' orderby='id' }             <li><a href='[field:arcurl /]' title="[field:fulltitle /]">[field:title /]</a></li>          {/dede:arclist}        row='10' 调用10条, titlelen='60'标题长度为30汉字 orderby='id' 按ID,降序排列

按ID排序顺序排列,从小到大

{dede:arclist channelid='' row='10' titlelen='60' orderby='id' orderway='asc'  }             <li><a href='[field:arcurl /]' title="[field:fulltitle /]">[field:title /]</a></li> + k9 F! z5 p% T         {/dede:arclist}        row='10' 调用10条, titlelen='60'标题长度为30汉字 orderby='id' 按ID,orderway='desc' 值为 desc 或 asc ，指定排序方式是降序还是顺向排序，默认为降序 2 e& w. [0 c5 s7 L- ^

7 z' D) l7 R2 Y% V5 q' i4 P+ K, n1 z调用含有缩图的文档

{dede:arclist flag="p" row='10' titlelen='60'}             <li><a href="[field:arcurl /]"><img src="[field:litpic/]" border="0" alt="[field:fulltitle /]"></a>             <span><a href="[field:arcurl /]" title="[field:fulltitle /]">[field:title /]</a></span> 9 |9 i8 X7 P9 a' k, Z' O! q            </li>          {/dede:arclist}      flag = 'p' 自定义属性值：头条[h] 推荐[c] 图片[p] 幻灯[f] 滚动 跳转[j] 图文[a] 加粗

3 G5 z1 l' F' ?+ G9 O日期的各种格式

08                   [field:pubdate function=strftime('%d',@me)/] , }. N' i5 l) A, B( P08 日                 [field:pubdate function=strftime('%d日',@me)/] 0 W& O" x7 x3 }. n  K2 v06-08                 [field:pubdate function=strftime('%m-%d',@me)/] $ h6 |+ [' S/ M5 j06月08日              [field:pubdate function=strftime('%m月%d日',@me)/] 09-06-08              [field:pubdate function=strftime('%y-%m-%d',@me)/] : h" Q$ k! P: F3 o  a3 k2009-06-08            [field:pubdate function=strftime('%Y-%m-%d',@me)/] 09年06月08日          [field:pubdate function=strftime('%y年%m月%d日',@me)/] # B3 u7 i5 N" h! V" q5 f2009年06月08日        [field:pubdate function=strftime('%Y年%m月%d日',@me)/] 2009-06-08   13:28     [field:pubdate function=strftime('%Y-%m-%d %H:%M',@me)/]

底层字段

[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 /] 发布日期 ; p- b3 i- ^5 L9 N7 v. K9 l08              [field:pubdate function=strftime('%d',@me)/] 08 日            [field:pubdate function=strftime('%d日',@me)/] / @2 A( B8 X. m% d) m4 S# B& H06-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)/] : a* b0 k/ d* p: k2 ]. M, T% T09年06月08日     [field:pubdate function=strftime('%y年%m月%d日',@me)/] 8 {3 o, t$ g8 G3 G9 r* s2009年06月08日   [field:pubdate function=strftime('%Y年%m月%d日',@me)/] 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汉字 : ^$ B5 N+ H+ T' O  ^5 Q; T& Binfolen='160' 表示内容简介长度 等同于infolength（只控制infos，并不控制description的内容） * [field:info /] 简介 等同于 [field:description /] ,[field:infos /] & D% k8 c- V# q5 F- O  R, y字数控制 [field:info function="cn_substr(@me,120)"/] 60汉字 ; |7 O; u" l; minfolen='160' 表示内容简介长度 等同于infolength（只控制infos，并不控制description的内容） * [field:infos /] 简介 等同于 [field:info /] ,[field:description /] ; D) A7 ?! |: p6 y7 V" b, D' ^4 ^9 r字数控制 [field:infos   function="cn_substr(@me,120)"/] 60汉字 6 |7 s/ V* Y9 k; f3 b2 }infolen='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' 缩略图宽度 ! D4 ]7 @- ]4 ?0 E& bimgheight='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..... ' I+ p! {/ K* a' F  T! n( S' J可CSS控制可做成各种样式效果,比如隔行换色, 列表前加入1-10数字序号,每隔几行换行等等 $ C+ k  j+ a4 @4 l- g于PHP搭配,可制作出各种效果,为DEDE最重要代码之一 BY天工开物 www.dedevip.com

! b) z. k! N5 \2 P  f4 t
相关函数：
3 U% O/ p; q7 P6 C% b: r文件\include\taglib\arclist.lib.php第7行
. X% B2 d9 @( @function lib_arclist(&$ctag,&$refObj)
参数说明：
7 k3 g3 d  e. W' M; acol='' 分多少列显示（默认为单列），5.3版中本属性可以通过多种方式进行多行显示
如果col='1'要多列显示的可用div+css实现
  r) O' P: p; z! E/ K% `7 `以下为通过div+css实现多列的示例：
<style type=text/css>
. Y$ W! w2 _$ Ndiv{width:400px;float:left;}
" [8 `: D. f1 S% U, i+ R; `+ w</style>
{dede:arclist row='10' titlelen='24' orderby='pubdate' idlist='' col='2'}
•[field:textlink/]([field:pubdate function=MyDate('m-d',@me)/])<br/>
8 e! t: ?) q7 u( m0 F/ T( ^{/dede:arclist}
当col>1将使用原来的table多列方式显示
row='10' 返回文档列表总数
0 @" g+ ?0 t( ^6 s; u9 r& k+ ttypeid='' 栏目ID,在列表模板和档案模板中一般不需要指定，在首页模板中允许用","分开表示多个栏目；
getall='1' 在没有指定这属性的情况下,在栏目页、文章页模板,不会获取以","分开的多个栏目的下级子类
titlelen = '30' 标题长度 等同于titlelength
infolen='160' 表示内容简介长度 等同于infolength（只控制infos，并不控制description的内容）
imgwidth='120' 缩略图宽度
' a3 c# D; R5 K: {imgheight='90' 缩略图高度
listtype='all' 栏目类型 image含有缩略图 commend推荐
5 G; d" r* w, o$ Z4 Xorderby='sortrank' 文档排序方式
3 q5 a& ?- s% |3 w, V2 [4 Q§ orderby='hot' 或 orderby='click' 表示按点击数排列
§ orderby='sortrank' 或 orderby='pubdate' 按出版时间排列
§ orderby='near'
: d/ v% e1 P2 g8 A1 V6 \% ~% g§ orderby=='lastpost' 按最后评论时间
) o4 ~# w. B' N- D' {5 o) V; L§ orderby=='scores' 按得分排序
& `  A8 N; q- O& @3 v§ orderby='id' 按文章ID排序
: M5 `$ b7 v* \3 s/ o§ orderby='rand' 随机获得指定条件的文档列表
keyword='' 含有指定关键字的文档列表，多个关键字用","分
innertext = '' 单条记录样式
7 a+ ?8 X. D: @aid='' 指定文档ID
idlist ='' 提取特定文档（文档ID）
7 e( V  D1 q. _3 R% L8 pchannelid 频道ID
limit='起始ID,记录数' （起始ID从0开始）表示限定的记录范围（如：limit='1,2' 表示从ID为1的记录开始，取2条记录）
5 J8 [/ b/ l' ^9 c4 v2 [( s$ Gflag = 'h' 自定义属性值：头条[h]推荐[c]图片[p]幻灯[f]滚动跳转[j]图文[a]加粗
noflag = '' 同flag，但这里是表示不包含这些属性
orderway='desc' 值为 desc 或 asc ，指定排序方式是降序还是顺向排序，默认为降序
1 o, U0 X/ r$ _: k6 r$ m3 r! a; f" msubday='天数' 表示在多少天以内的文档
: h1 p6 G3 ^- j) w1 ~
* c: X! g8 X  k$ S4 z- ~, n- e; X用arclist调用于附加表字段的方法：

要获取附加表内容，必须符合两个条件
1、指定 channelid 属性
2、指定要获得的字段 addfields='字段1,字段'
1 d7 b. x% Z8 g2 r1 o如：
7 F" d- Z% u! b+ k( C( Y{dede:arclist addfields='filetype,language,softtype' row='8' channelid='3'}
0 T* X) o' s2 w( Q" _+ U8 ^[field:textlink /] - [field:softtype /]<br />
# N6 u, y* i2 d' l, D6 [{/dede:arclist}

# L" j2 v2 h2 }& o. Y. b底层模板字段：
ID(同 id),typeid,sortrank,flag,ismake,channel,arcrank,click,money,title,shorttitle,color,writer,
3 B+ j6 j- ~4 Y, Z0 ?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"格式)
其中：
, o4 _! i% w- R" k/ R/ @( o$ L0 Jtextlink = <a href='arcurl'>title</a>
& n! U/ ^1 X5 Z5 Btypelink = <a href='typeurl'>typename</a>
3 f, ^) x! ~: limglink = <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/]
) k. O8 z1 Z& ?" c% i/ X如：
- y2 U+ z# c' Z9 L; u3 f{dede:arclist infolen='100'}
+ [- p0 B, Q9 ?; E% b" G[field:textlink/]
! S# j- F( e# }' h<br>
[field:infos/]
. l* \5 d$ `. c; C<br>
{/dede:arclist}
2 ~: Q2 {' ^2 B注：底层模板里的Field实现也是织梦标记的一种形式，因此支持使用PHP语法，Function扩展等功能。
( ?* T/ `2 W: F1 R* k8 w/ U$ a如： 给当天发布的内容加上 (new) 标志
[field:senddate runphp='yes']
$ntime = time();
$oneday = 3600 * 24;
if(($ntime - @me)<$oneday) @me = "<font color='red'>(new)</font>";
0 D* z4 [: H4 y6 oelse @me = "";
% W: R' R& ^- y' q  z- z3 g" {[/field:senddate]