DedeCMS教程 文档列表标签arclist 的讲解,下面我们来学习第一个重要标签——文档列表标签。
arclist标签主有讲下面几个内容
-
标签含义及作用
-
标签适用范围
-
标签参数列表
-
标签底层模板
一,标签参数列表
本标签的参数列表非常多参数,说明它的功能强大,自由拓展性很大,学好了之后作用不小。
二,标签含义及作用
本标签是织梦(DedeCMS)系统所有标签中最常用,最重要的标签之一。它的名称叫「文档列表标签」,标签名为 arclist ,主要用于调用系统的文档,并将其以列表的形式展示出来。
三,标签的适用范围
文档列表标签(arclist)在织梦系统中的适用范围为全局使用。简单的说,就是全局使用;复杂点说,就是在前台的任何页面都可用,比如首页、列表、内容页等这样的页面。
但是,在一些杂项功能页面中是无法使用的,这是由于杂项功能页的模板解析机制不同。您不需要问我为什么,您只需要将它记住即可。
----常用参数
row 返回几条记录 例:row = '19'
typeid 设定调用的目标栏目 例:typeid='2,5'
titlelen 设定标题显示的最大字符数 例:titlelen='34'
infolen 设定简介的最大字符数 例:infolen='106'
flag 限定自定义文档属性 例:flag='a,f'
noflag 设定不包含该自定义文档属性的文档,同上相反
orderby 设定文档的排序的字段
hot与 click 按文档点击数排序
sortrank 与pubdate 按文档更新时间排序
id 按照文档的ID排序
lastpost 按最后表态排序
scores 按文档总积分排序
googpost 按好评数排序
badpost 按差评数排序
rand 按随机排序
----高级参数
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标签中,字段名的取值范围为主表及附加表的所有字段。
但希望大家注意的是,附加表字段是不能直接获取的,需要用高级参数进行配合实现,详见上述参数列表。
标签调用实例
调用全站最新更新10篇文档
{dede:arclist row='10'} [field:title/] {/dede:arclist}
调用栏目ID为2的15篇推荐文章
{dede:arclist row='15' typeid='2' flag='c'} [field:title/] {/dede:arclist}
随机调用的全站15篇软件文档
{dede:arclist row='15' orderby='rand' channelid='3'} [field:title/] {/dede:arclist}