文章列表

<!--{iCMS:article:list  loop      = "true"  user      = "true"  tags      = "true"  meta      = "true"  row       = "10"  cid       = "1"  cid      != "1"  sub       = "all|true"  pid       = "1"  startdate = ""  enddate   = ""  pic       = "true"  by        = "ASC|DESC"  orderby   = "hot"  keywords  = ""  id        = "1"  id       != "1"  cache     = "true"  time      = ""  cids      = ""  pids      = ""  tids      = ""  userid    = ""  ucid      = ""  weight    = ""  status    = ""  call      = "user|admin"  nopic     = "true"  where     = ""  tags = "true"  user = "true"  meta = "true"  as        = ""  start     = "0"  step      = ""  max       = ""}--><!--{$article_list|print_r}--><!--{iCMSelse}-->暂无数据<!--{/iCMS}-->

使用范围

• 所有模板

标签内部变量

*为系统变量

* <!--{$article_list.total}-->    总条数 等row的值* <!--{$article_list.prev}-->     上一条行号 (从1开始)* <!--{$article_list.next}-->     下一条行号 (从1开始)* <!--{$article_list.rownum}-->   行号 (从1开始)* <!--{$article_list.index}-->    索引号 (从0开始)* <!--{$article_list.first}-->    第一条为true 否则flase* <!--{$article_list.last}-->     最后一条为true 否则flase<!--{$article_list.title}-->        文章标题<!--{$article_list.url}-->          文章网址<!--{$article_list.description}-->  文章简介<!--{$article_list.pubdate}-->      文章发布时间戳<!--{$article_list.pubdate|date:'Y-m-d'}--><!--{$article_list.pic.url}-->      文章缩略图网址

<!--{$article_list|print_r}-->      查看所有内部变量

属性介绍

属性	可选值	说明
loop	true	循环标记
user	true	是否调用用户数据
tags	true	是否调用TAG数据
meta	true	是否调用扩展属性数据
sub	true	设置为true时将调用栏目下所有子栏目的文章
row	10	返回行数
cid	1｜1,2,3	栏目ID,多项请用,隔开
cid!	1｜1,2,3	排除的栏目ID,多项请用,隔开
pid	1｜1,2,3	属性ID,多项请用,隔开
startdate	20150101,-1,-15	指定开始时间 -1=1天前 -15=15天前 以此类推
enddate	20150101,1,15	指定结束时间 1=1天后 15=15天后 以此类推
pic	true	有缩略图的文章
by	ASC｜DESC	排序方式 默认值DESC ASC 从小到大 DESC从大到小
orderby	hot,week,month,comment,pubdate,sort,weight	排序方法 hot 总点击 week 周点击 month 月点击 comment 评论数 pubdate 发布时间 sort 文章的排序 weight 权重
keywords	关键词	在(title,keywords,description)搜索关键词,数据量大时 请使用 sphinx
id	文章ID	指定文章ID
id!	文章ID	排除文章ID
cache	true	启用缓存
time	3600	缓存时间
cids	栏目ID｜1,2,3	副栏目的ID,多项请用,隔开
pids	属性值｜1,2,3	属性值,多项请用,隔开
tids	标签ID｜1,2,3	标签ID,多项请用,隔开
userid	用户ID
call	user,admin	文章用户类型
weight	权重	文章的权重
nopic	true	无缩略图
where	SQL语句	如果你觉得上面的条件不够用,那自己写吧
tags	true	默认不调用标签 true 开启标签调用功能
user	true	默认不调用用户详细 true 开启用户详细调用功能
meta	true	默认不调用附加属性 true 开启附加属性调用功能
as	无	变量别名
start	0	开始索引号
step	1	步进值
max	无	最大索引值

• page = "true" 时 可调用分页标签

<!--{$iCMS.PAGE.NAV}-->

其它分页样式

试试要哪个

<!--{$iCMS.PAGES|method:'show(1)'}--><!--{$iCMS.PAGES|method:'show(2)'}--><!--{$iCMS.PAGES|method:'show(3)'}--><!--{$iCMS.PAGES|method:'show(4)'}--><!--{$iCMS.PAGES|method:'show(5)'}--><!--{$iCMS.PAGES|method:'show(6)'}--><!--{$iCMS.PAGES|method:'show(7)'}--><!--{$iCMS.PAGES|method:'show(8)'}--><!--{$iCMS.PAGES|method:'show(9)'}-->

常用示例

获取 栏目ID 为 1 按总点击 从大到小 排序的文章 10条

<!--{iCMS:article:list loop="true" row="10" orderby="hot" cid="1"}-->  <a href="<!--{$article_list.url}-->"><!--{$article_list.title}--></a><!--{/iCMS}-->

获取 [$category.cid] 变量为栏目ID 按周点击 从大到小 排序的文章 10条

<!--{iCMS:article:list loop="true" row="10" orderby="week" cid="$category.cid"}-->  <a href="<!--{$article_list.url}-->"><!--{$article_list.title}--></a><!--{/iCMS}-->

获取 10个分类下 每个分类最新的10篇文章

<!--{iCMS:category:list loop="true" row="10"}--> <a href="<!--{$category_list.url}-->"><!--{$category_list.title}--></a>  <!--{iCMS:article:list loop="true" row="10" cid="$category_list.cid"}-->    <a href="<!--{$article_list.url}-->"><!--{$article_list.title}--></a>  <!--{/iCMS}--><!--{/iCMS}-->

获取 5个顶分类 下10个子分类 每个分类最新的10篇文章

<!--{iCMS:category:list loop="true" row="5" stype="top"}--> <h3>顶级分类[<!--{$category_list.cid}-->]:<a href="<!--{$category_list.url}-->"><!--{$category_list.name}--></a></h3>  <!--{iCMS:category:list loop="true" row="10" stype="sub" cid="$category_list.cid" as="cate"}-->    <h4>子分类[<!--{$cate.cid}-->]:<a href="<!--{$cate.url}-->"><!--{$cate.name}--></a></h4>    <b>子分类文章列表</b>    <!--{iCMS:article:list loop="true" row="10" cid="$cate.cid"}-->      <p><a href="<!--{$article_list.url}-->"><!--{$article_list.title}--></a></p>    <!--{/iCMS}-->    <hr />  <!--{/iCMS}-->  <hr /><!--{/iCMS}-->

由于 iCMS:category:list 返回的数据默认赋值给 $category_list
嵌套循环时要使用 as 属性来改变嵌套里的变量赋值,赋值给$cate
所以子分类的数据调用变成了 $cate.title , $cate.cid

不使用 loop="true" 情况

以下属特殊调用示例 正常情况请使用上面的方法

• 最新 10条 有缩略图的文章

<!--{iCMS:article:list pic="true" row="10"}--><!--{$article_list|print_r}--> 可以查看数据结构<!--{$article_list[0].title}--> 第一条标题<!--{$article_list[1].title}--> 第二条标题 以些类推

• 不使用 loop="true" 搭配 foreach 使用

全部循环<!--{iCMS:article:list pic="true" row="10"}--><!--{foreach value=alist from="$article_list"}-->    <a href="<!--{$alist.url}-->"><!--{$alist.title}--></a><!--{/foreach}-->从第二条开始<!--{foreach value=alist from="$article_list" start="2"}-->    <a href="<!--{$alist.url}-->"><!--{$alist.title}--></a><!--{/foreach}-->从第三条开始 第六条结束<!--{foreach value=alist from="$article_list" start="3" end="6"}-->    <a href="<!--{$alist.url}-->"><!--{$alist.title}--></a><!--{/foreach}-->到第六条结束<!--{foreach value=alist from="$article_list" end="6"}-->    <a href="<!--{$alist.url}-->"><!--{$alist.title}--></a><!--{/foreach}-->

• 调用文章总条数
  需要 page="true" 参数
  标签只能在<!--{iCMS:article:list page="true" 之后使用

  <!--{$iCMS.PAGE.COUNT}--> 或者 <!--{$article_list_total}-->

  如何在写在数据调用之前
  

可在数据调用后,使用JS操作

如果不想用JS操作

只能将数据调用写到总条数标签之前
示例

<!--{iCMS:article:list page="true" 其它条件}--><title>总共<!--{$iCMS.PAGE.COUNT}-->条</title><body>结果循环<!--{foreach value=alist from="$article_list"}-->    <a href="<!--{$alist.url}-->"><!--{$alist.title}--></a><!--{/foreach}--></body>

希望以上内容对你有所帮助！如果还有其他问题，请随时提问。 各类知识收集 拥有多年CMS企业建站经验，对 iCMS， Fastadmin， ClassCMS， LeCMS， PbootCMS， PHPCMS， 易优CMS， YzmCMS， 讯睿CMS， 极致CMS， Wordpress， HkCMS， YznCMS， WellCMS， ThinkCMF， 等各类cms的相互转化，程序开发，网站制作，bug修复，程序杀毒，插件定制都可以提供最佳解决方案。