在网站建设与内容管理中，DedeCMS 是一款非常流行的开源内容管理系统。本文将详细介绍 DedeCMS 中一个重要的标签——文档列表标签（arclist），帮助您更好地理解和使用它。

文档列表标签 arclist 是 DedeCMS 系统中最常用、最重要的标签之一。
它的主要功能是调用系统中的文档，并以列表形式展示出来。

一、标签参数列表

arclist 标签拥有众多参数，这些参数赋予了它强大的功能和高度的灵活性。以下是一些常用的参数：

  • row: 返回记录的数量，例如：row='19'
  • typeid: 设定目标栏目的 ID，例如：typeid='2,5'
  • titlelen: 设定标题的最大字符数，例如：titlelen='34'
  • infolen: 设定简介的最大字符数，例如：infolen='106'
  • flag: 限定自定义文档属性，例如：flag='a,f'
  • noflag: 排除特定属性的文档
  • orderby: 设定文档排序字段，例如：hot/click 按点击数排序，sortrank/pubdate 按更新时间排序

二、标签含义及作用

arclist 标签主要用于在网站的各个页面上展示文档列表。通过合理配置参数，可以实现对文档的灵活调用和排序。

三、标签适用范围

文档列表标签（arclist）可以在 DedeCMS 的任何前台页面中使用，包括首页、列表页和内容页等。然而，在一些特殊的功能页面中可能无法使用，因为这些页面的模板解析机制不同。

四、高级参数

除了基本参数外，arclist 还支持一些高级参数：

  • channelid: 设定内容模型，例如：channelid='1'
  • addfields: 调用附加表字段，例如：addfields='字段名1,字段名2'

五、其它参数

还有其他一些参数可以帮助您更精细地控制文档的显示方式：

  • col: 设定按几列显示
  • imgwidth: 缩略图宽度
  • imgheight: 缩略图高度
  • listtype: 设定调用文档的类型
  • idlist: 设定调用的文档 ID 列表
  • aid: 设定调用的文档 ID
  • limit: 设定调用开始和结束位置，例如：limit='2,5'
  • orderway: 设定排序方式，asc 表示正序，desc 表示倒序（默认）

六、标签底层模板

在 DedeCMS 系统中，底层模板的获取方式为 [field:字段名/]。对于 arclist 标签，字段名可以取主表及附加表的所有字段。但需要注意的是，附加表字段不能直接获取，需要配合高级参数使用。

七、标签调用实例

以下是几个 arclist 标签的调用实例：

1. 调用全站最新更新的 10 篇文档：


{dede:arclist row='10'} [field:title/] {/dede:arclist}

2. 调用栏目 ID 为 2 的 15 篇推荐文章：


{dede:arclist row='15' typeid='2' flag='c'} [field:title/] {/dede:arclist}

3. 随机调用全站 15 篇软件文档：


{dede:arclist row='15' orderby='rand' channelid='3'} [field:title/] {/dede:arclist}

通过以上介绍，您可以根据实际需求灵活运用 arclist 标签，从而实现更加丰富的内容展示效果。