Dedecms文档列表标签(arclist)使用教程

Dedecms标签的使用我们将都在HTML里以实例的方式讲解,同时在把Dedecms标签语法的参数说明也标注在HTML里,本次教程以文档列表标签arclist为例,arclist标签是Dedecms里使用最频繁的一个标签。

首先我们用Dreamweaver或其它编辑器打开index.htm模板文件,Dedecms的默认模板文件都在templetsdefault文件夹下面,然后删除里面的无用的代码,保留以下代码即可,全部删除里面的代码也没有关系。

<!DOCTYPE html PUBLIC “-//W3C//DTD XHTML 1.0 Transitional//EN” “http://www.zuola.net/TR/xhtml1/DTD/xhtml1-transitional.dtd”>

<html xmlns=”http://www.zuola.net/1999/xhtml”>

<head>

<meta http-equiv=”Content-Type” content=”text/html; charset={dede:global.cfg_soft_lang/}” />

<title>{dede:global.cfg_webname/}</title>

<meta name=”description” content=”{dede:global.cfg_description/}” />

<meta name=”keywords” content=”{dede:global.cfg_keywords/}” />

</head>

<body>

</body>

</html>

然后在

<body>

</body>

里添加如下arclist标签:

{dede:arclist}

<a href=’[field:arcurl/]‘>[field:title/]</a> <br />

{/dede:arclist}

然后打开首页你会看到如下图效果:

1

这既是arclist标签在不加任何参数下的调用效果,在不加任何参数的时候,arclist标签默认调用10条标题,每天标题为30个字符,同时调用所有栏目下的最新更新的文章标题。

下面是相应参数的解释:“<!– –>是HTML注释,这里面的内容不会在网页里显示。”

{dede:arclist}<!– arclist标签的开始 –>

<a href=’[field:arcurl/]‘>[field:title/]</a> <br /><!– <br />HTML换行标签 –>

<!– [field:arcurl/]是标题链接地址,[field:title/]是标题名称 –>

{/dede:arclist}<!– arclist标签的结束,Dedecms的标签和HTML代码一样都是需要闭合才能正常使用的 –>

下面我们加上一些常用的参数测试一下,如下:

{dede:arclist row=5 titlelen=50 typeid=1 infolen=’50′}<!– arclist标签的开始 –>

<!– row表示调用多少条标题,titlellen表示调用标题长度字符,typeid表示调用指定栏目ID,infolen表示调用摘要字符,这个要和下面的[field:info/]对应 –>

<a href=’[field:arcurl/]‘>[field:title/]</a> <br /><!– <br />HTML换行标签 –>

<!– [field:arcurl/]是标题链接地址,[field:title/]是标题名称 –>

[field:info/]…<br /><br />

<!– [field:info/]是调用文章摘要 –>

{/dede:arclist}<!– arclist标签的结束,Dedecms的标签和HTML代码一样都是需要闭合才能正常使用的 –>

效果如下:

2

arclist的标签参数有很多,下面是官方给出的一些参数说明:

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标签的使用了,当然我们上面的例子里只加了一个<br />的换行样式,看起来比较丑,如果想要达到更好的效果就需要使用Div+Css才行。如果有什么关于arclist标签的问题欢迎留言提问!