AKCMS官方网站 » 使用手册 » 模板函数getitems
getitems函数是AKCMS中使用最广泛的函数,可以这么说,把这个函数弄明白了,就掌握了80%的AKCMS的使用。
公用参数(get***系列函数都支持的参数)
start 从第几篇文章开始,start="3"表示,抛弃符合条件的前2篇文章,从第3篇开始取,默认值为1
num 取出的文章数,默认值是10
colspan 子循环的次数,默认是没有子循环
overflow 子循环结束后插入的内容,与colspan结合可以实现很多效果,比如:共显示20篇文章每5行中间插入一根线就这样写:num="20" colspan="5" overflow="<hr />"
expire 缓存有效期,单位秒,expire="3600"表示缓存1小时,1小时内相同属性的标签不再查询数据库
length 题目长度限制,单位字节,比如:length="20"代表题目截取10个汉字或20个字母,如果是半个汉字将被舍弃
strip 题目被截取后显示的字符,比如可以指定strip="..."就表示如果题目被截断了就加上个省略号
bandindex 绑定分页,分页列表页的主内容区域必须指定bandindex="1"才能正常使用分页功能
emptymessage 如果什么内容也没有取到,则显示这个值,emptymessage="未找到符合条件的文章"
year 可以取得某年的文章
month 可以取得某年某月的文章,如果year为空则此属性无效
day 可以取得某年某月某日的文章,如果year或month为空则此属性无效
参数
id 指定ID,可以是多个,比如:id="1,6,7",只取1,6,7这三篇文章
skip 跳过指定ID,可以是多个,比如:skip="2,3",则跳过2,3这两篇文章
category 栏目ID,可以是多个,比如:category="1,2,3,4"代表从1,2,3,4栏目取内容
skipcategory 跳过的栏目ID,可以是多个,比如:skipcategory="2,3"代表跳过栏目2,3的内容
includesubcategory 是否取下级栏目的数据,如果为1则表示下级栏目的内容也会被列出来,默认为0
section 主题ID,可以是多个,比如:section="1,5,6"代表从1,5,6主题取内容
skipsection 跳过的主题ID,可以是多个,比如:skipsection="4,5"代表不取4和5这两个主题的内容
orderby 排序方式(可选值:id(序号),orderby(排序值),time(时间),pv(页面浏览量),random(随机)(SQLite版random不生效),默认是从小到大的顺序,如果想从大到小,则在后面加上一个_reverse,比如:orderby="orderby_reverse"按照排序值从大到小排列,orderby="pv_reverse"按照访问量从大到小排列)也支持多个排序方式,中间用逗号分开,比如:orderby="orderby_reverse,id"意思是先按排序值从大到小排列,如果排序值相同则按ID从小到大排列。
template 显示模板(默认:"[title]<br>")
page 显示第一页,当这个参数指定的时候,start参数就失效
last 限制取大于此值的文章(用于上一篇下一篇功能),比如有ID有1,2,3,4,5等文章,last="3"则会取出4,5这两篇文章
next 限制取小于此值的文章,比如有ID有1,2,3,4,5等文章,last="3"则会取出1,2这两篇文章
where 指定的条件将附到查询语句的最后,比如:where="id>100",则只有ID号大于100的才会被显示出来。这是高级功能,仅供对数据库比较熟悉的用户使用
newinseconds 指定只选出几秒内新建的文章,比如:newinseconds="3600"则只取最近一小时录入的文章
editinseconds 指定只选出几秒内修改的文章,比如:editinseconds="3600"则只取最近一小时修改过的文章
timelimit 是否显示“未来”的文章,比如现在是2010年1月24日10:27:00,默认的2010年2月的文章也会显示出来,如果此属性设置为1,则不显示“未来”的文章
keywords 只显示包含指定词的文章,比如:keywords="google"则将题目或关键字字段中包含google的文章
order 选取排序值字段大于等于指定值的文章,比如:order=5,则只显示排序值大于等于5的文章
picture 选取文章是否包含缩略图,1包含,-1不包含,0忽略
nopicture 默认图片,当获取某篇未指定缩略图的文章的缩略图时,会获得这个默认图片的地址
head 截取正文头部的字数,通过[texthead]获取(2.7正式版新增参数)
模板标签(template参数中可以使用以下标签,最终会被替换为对应内容,下同)
[title]题目
以下是发表时间的格式
[y]年
[m]月
[d]日
[h]时
[i]分
[s]秒
[sy]短格式年,如2007年则显示为07
[sm]短格式月,如05月则显示为5
[sd]短格式日,如08日则显示为8
[last_y]最新编辑年
[last_m]最新编辑月
[last_d]最新编辑日
[last_h]最新编辑时
[last_i]最新编辑分
[last_s]最新编辑秒
[last_sy]最新编辑短格式年
[last_sm]最新编辑短格式月
[last_sd]最新编辑短格式日
[url]url地址
[texttitle]无样式题目
[textshorttitle]无样式短题目
[title]题目
[shorttitle]短题目
[aimurl]目标地址
[pv]访问量
[categoryid]栏目id
[category]栏目名
[sectionid]主题id
[section]主题名
[categorypath]栏目的文件夹名
[categoryhomepath]已经计算好的栏目路径
[categoryup]父栏目的ID
[itemid]文章ID号
[id]序号,1-N
[picture]缩略图地址
[digest] 摘要
[text]正文内容
[texthead]正文的头部截取(2.7正式版新增标签)
本文URL:http://www.akcms.com/manual/getitems.htm
● 兼容性好,对主机要求低
● 体积小巧(220KB),精简高效
● 灵活自定义,适于SEO
● 超强负载能力,可支持百万PV
可免费使用,页面显示AKCMS的支持信息:powered by akcms
