Dedecms是一款广泛使用的开源内容管理系统,其模板标签功能非常强大。arclist
标签是用于获取和展示指定文档列表的常用标签,本文将详细介绍arclist
标签的使用方法,包括基本语法、参数说明以及一些实际使用示例,通过这些内容,读者可以更好地理解和运用arclist
标签来实现各种复杂的文档列表展示需求。
一、基本语法和参数说明
1. 基本语法
{dede:arclist} <a href="[field:arcurl/]">[field:title/]</a> {/dede:arclist}
2. 参数说明
参数名 | 描述 | 默认值 |
flag | 自定义属性值:头条[h]、推荐[c]、图片[p]、幻灯[f]、滚动[s]、跳转[j]、图文[a]、加粗[b]。 | |
typeid | 栏目ID,在列表模板和档案模板中一般不需要指定,在首页模板中允许用”,”分开表示多个栏目。 | |
row | 每页显示记录数。 | |
col | 分多少列显示。 | |
titlelen | 标题长度。 | |
infolen | 内容简介长度。 | |
imgwidth | 缩略图宽度。 | |
imgheight | 缩略图高度。 | |
listtype | 栏目类型:all(所有)、image(含有缩略图)、commend(推荐)。 | all |
orderby | 排序方式:sortrank(排序)、hot(点击数)、click(点击数)、pubdate(出版时间)、near(最近更新)、lastpost(最后评论时间)、scores(得分)、id(文章ID)、rand(随机)。 | id |
keyword | 含有指定关键字的文档列表,多个关键字用”,”分隔。 | |
limit | 限定的记录范围(起始ID,记录数),如limit=’1,2’表示从ID为1的记录开始,取2条记录。 | |
orderway | 排序方式:desc(降序)或asc(升序),默认为降序。 | desc |
channelid | 频道ID,指定要调用的附加表字段。 | |
addfields | 要获得的附加表字段,多个字段用”,”分隔。 | |
idlist | 提取特定文档(文档ID),调用指定id文档,例如idlist=’4,45,78,237’。 | |
innertext | 单条记录样式。 | |
subdays | 表示在多少天以内的文档。 | |
type | 内容类型,在列表模板和档案模板中一般不需要指定,在首页模板中允许用”,”分开表示多个栏目。 |
二、实际使用示例
1. 调用推荐文章
{dede:arclist flag="c" row="10" titlelen="60" orderby=""} <li><a href="[field:arcurl/]" title="[field:fulltitle/]">[field:title/]</a></li> {/dede:arclist}
解释:调用10条推荐文章,每条文章标题长度为60个字符。
2. 调用最新文章并按发布时间排序
{dede:arclist row="10" titlelen="60"} <li><a href="[field:arcurl/]" title="[field:fulltitle/]">[field:title/]</a></li> {/dede:arclist}
解释:调用10条最新文章并按发布时间排序,每条文章标题长度为60个字符。
3. 按ID排序降序排列
{dede:arclist row="10" titlelen="60" orderby="id"} <li><a href="[field:arcurl/]" title="[field:fulltitle/]">[field:title/]</a></li> {/dede:arclist}
解释:调用10条文章,按文章ID降序排列,每条文章标题长度为60个字符。
4. 调用含有缩图的文档
{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></li> {/dede:arclist}
解释:调用10条含有缩图的文档,每条文档标题长度为60个字符。
5. 日期格式示例
08 [field:pubdate function=strftime('%d',@me)/]<br/> 08 日 [field:pubdate function=strftime('%d日',@me)/]<br/> 0608 [field:pubdate function=strftime('%m%d',@me)/]<br/> 06月08日 [field:pubdate function=strftime('%m月%d日',@me)/]<br/> 090608 [field:pubdate function=strftime('%y%m%d',@me)/]<br/> 20090608 [field:pubdate function=strftime('%Y%m%d',@me)/]<br/> 09年06月08日 [field:pubdate function=strftime('%y年%m月%d日',@me)/]<br/> 2009年06月08日 [field:pubdate function=strftime('%Y年%m月%d日',@me)/]<br/>
解释:不同日期格式的展示方法,可以根据需要选择适合的日期格式函数。
三、FAQs
Q1:如何在arclist
标签中调用附加表字段?
A1:要在arclist
标签中调用附加表字段,必须符合以下两个条件:
1、指定channelid
属性(注意:channelid
不是栏目id,而是自定义模型的id)。
2、指定要获得的从表字段,使用addfields
属性。
{dede:arclist addfields='video_description,video_id' row='8' channelid='3'} [field:video_description /] – [field:video_id /] {/dede:arclist}
其中addfields='video_description,video_id'
是附加表中的两个字段,除指定的附加表字段外,其它底层字段如arcurl
,title
,infos
等均能正常调用。
Q2:如何在arclist
标签中实现多列显示?
A2:在5.3版中,可以通过多种方式实现多列显示,如果col='1'
要多列显示,可以使用div+css实现。
{dede:arclist row='10' titlelen='24' orderby='pubdate' idlist='' col='2'} bull; [field:textlink/]([field:pubdate function=MyDate('md',@me)/]) {/dede:arclist}
当col>1
时,将使用原来的table多列方式显示。
原创文章,作者:未希,如若转载,请注明出处:https://www.kdun.com/ask/1242961.html
本网站发布或转载的文章及图片均来自网络,其原创性以及文中表达的观点和判断不代表本网站。如有问题,请联系客服处理。
发表回复