iCMS文章标签文档

文章信息

<!--{$article}-->

使用范围

文章模板

/template/default/article.htm

/template/mobile/article.htm

数据结构

Array(    

[id]       => 文章ID    

[cid]      => 栏目ID    

[scid]     => 副栏目ID    

[ucid]     => 用户分类ID    

[pid]      => 自定义属性值    

[ordernum] => 排序    

[title]    => 标题    

[stitle]   => 短标题    

[clink]    => 自定义链接    

[url]      => 链接    

[source]   => 出处    

[author]   => 作者    

[editor]   => 编辑    

[userid]   => 编辑/用户ID    

[haspic]   => 是否有图    

[pic]      => Array(            

[src]    => 图片地址 2021/10/ed29c2163a7cd9335b96b515beeee864.jpg            

[url]    => 图片网址 http://www.xx.com/res/2021/ed29c2163a7cd9335b96b515beeee864.jpg            

[width]  => 图片宽            

[height] => 图片高    

)    

[mpic]        => 同 pic    

[spic]        => 同 pic    

[keywords]    => 关键字    

[tags]        => 标签    

[description] => 简介    

[related]     => 相关    

[meta]        => 附加内容    

[pubdate]     => 发布时间    

[postime]     => 提交时间    

[tpl]         => 模板    

[hits]        => Array(        

[script] => 点击统计脚本 http://www.xx.com/public/api.php?app=article&amp;do=hits&amp;cid=1&amp;id=1        

[count]  => 总点击        

[today]  => 今天点击        

[yday]   => 昨天点击        

[week]   => 周点击

[month]  => 月点击    

)    

[hits_today] => 今天点击    

[hits_yday]  => 昨天点击    

[hits_week]  => 周点击    

[hits_month] => 月点击

[favorite] => 收藏数    

[comments] => 评论数    

[good]     => 支持    

[bad]      => 反对    

[creative] => 文章类型 1原创 0转贴    

[weight]   => 权重    

[mobile]   => 是否手机发布    

[postype]  => 用户类型 1管理 0用户    

[status]   => 状态    

[appid]    => 应用ID    

[link]     => 文章链接    

[body]     => 正文    

[subtitle] =>副标题    

[taoke]    => 是否有淘宝链接    

[page]     => Array ( 分页            

[total]   => 总页数            

[count]   => 实际页数            

[current] => 当前页            

[num]     => 分页数字代码            

[text]    => 文本代码            

[nav]     => 分页代码            

[prev]    => 上一页URL            

[next]    => 下一页URL            

[last]    => 是否最后一页            

[end]     => 是否最后一页 一般使用这个    

)    

[tags_fname] => 第一个TAG    

[tags_array] => Array( TAG信息        

[0] =>Array(            

[name] => TAG

[url]  => TAG URL            

[link] => TAG链接        

)    

)    

[tags_link] => TAG链接    

[user] => Array( 用户信息            

[uid]    => 编辑/用户ID            

[name]   => #iCMS.V6 (#开头管理 @开头用户)            

[url]    => javascript:; 管理无链接 用户为主页链接            

[avatar] => about:blank 头像            

[link]   => #iCMS.V6 用户链接            

[at]     => #iCMS.V6 用户链接    

)    

[comment] => Array (        

[url]   => 评论页URL http://www.xx.com/public/api.php?app=article&amp;do=comment&amp;appid=1&amp;iid=1&amp;cid=1        

[count] => 评论数    

)

);

以上只是列出常用属性

查看所有属性

<!--{$article|print_r}-->

调用方式

文章名称:<!--{$article.title}-->

文章URL:<!--{$article.url}-->

文章link

<!--{$article.link}-->

等价于

<a href="<!--{$article.url}-->" target="_blank"><!--{$article.title}--></a>

文章缩略图：<!--{$article.pic.url}-->,<!--{$article.mpic.url}-->,<!--{$article.spic.url}-->

文章附加属性:<!--{$article.meta.自定义KEY}-->

文章分页：<!--{$article.page.nav}-->

文章正文：<!--{$article.body}-->

文章标签：

<!--{$article.tags_link}-->

等价于

<!--{foreach key="key" value="atag" from="$article.tags_array"}-->

<a href="<!--{$atag.url}-->"><!--{$atag.name}--></a>

<!--{/foreach}-->

文章列表

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

属性介绍

orderby属性参数

hot（总点击），week（周点击），month（月点击），comment（评论数），pubdate（发布时间），sort（文章的排序），weight（权重）

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>

文章正文

<!--{iCMS:article:data aid="文章ID"}-->