文章列表

<!--{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}-->      查看所有内部变量

属性介绍

• 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>