苹果CMSv10文章列表标签大全
苹果CMS V10提供了较为完善的文章数据调用标签，可以用于文章列表、文章分类、相关文章以及文章与视频关联内容的调用。下面整理文章列表常用参数、文章详情页字段以及关联内容调用示例，方便模板开发时直接参考。
一、文章列表标签参数
苹果CMS V10可以通过 {maccms:art} 标签调用文章列表数据，并通过不同参数控制排序、数量、分类、标签以及时间范围等。
{maccms:art num="10" paging="no" type="all" order="asc" by="sort"}
{$vo.art_name}
{/maccms:art}常用参数说明如下：
order：排列顺序，desc为倒序，asc为正序 by：排序依据，例如time、sort等 start：从第几条数据开始获取 num：获取数据条数 ids：指定文章ID，例如1,2,3 type：指定分类，all表示全部，也可以指定分类ID，例如1,2,3 class：指定扩展分类，支持多个 tag：指定Tag标签，支持多个，例如aaa,xxx level：指定推荐值，支持多个 rel：指定关联数据，例如1,2,3或关键词 timeadd：按添加时间筛选，例如-1 day、-1 week、-1 month、-1 hour timehits：按点击时间筛选，例如-1 day、-1 week、-1 month、-1 hour time：按更新时间筛选，例如-1 day、-1 week、-1 month、-1 hour hitsmonth：按月点击量筛选 hitsweek：按周点击量筛选 hitsday：按日点击量筛选 hits：按总点击量筛选 paging：是否启用分页，yes表示开启 pageurl：指定分页地址
二、文章列表标签示例
例如调用10篇文章，并按照排序字段正序排列：
{maccms:art num="10" paging="no" type="all" order="asc" by="sort"}{$vo.art_name}{/maccms:art}在 {maccms:art} 循环内部，文章数据通常使用 $vo 进行调用。例如：
{$vo.art_name}
{$vo.art_pic}
{$vo.art_blurb}
{$vo.art_author}
{$vo.art_time}文章详情页面则主要使用 $obj 调用当前文章的数据。
三、文章详情页字段大全
在苹果CMS V10文章详情页中，可以通过 $obj 获取当前文章的详细数据。常用字段如下：
| 字段 | 说明 |
|---|---|
{$obj.art_id} | 文章ID |
{$obj.type_id} | 分类ID |
{$obj.type_id_1} | 一级分类ID |
{$obj.type} | 二级分类对象 |
{$obj.type_1} | 一级分类对象 |
{$obj.group_id} | 用户组ID |
{$obj.art_name} | 文章标题 |
{$obj.art_sub} | 副标题 |
{$obj.art_en} | 文章别名 |
{$obj.art_status} | 文章状态，0未审，1已审 |
{$obj.art_letter} | 首字母 |
{$obj.art_color} | 标题颜色 |
{$obj.art_from} | 文章来源 |
{$obj.art_author} | 文章作者 |
{$obj.art_tag} | 文章Tag标签 |
{$obj.art_class} | 扩展分类 |
{$obj.art_pic} | 文章主图 |
{$obj.art_pic_thumb} | 文章缩略图 |
{$obj.art_pic_slide} | 文章幻灯图 |
{$obj.art_blurb} | 文章简介 |
{$obj.art_remarks} | 文章备注 |
{$obj.art_jumpurl} | 跳转URL |
{$obj.art_tpl} | 独立模板 |
{$obj.art_level} | 推荐等级 |
{$obj.art_lock} | 锁定状态 |
{$obj.art_up} | 顶数 |
{$obj.art_down} | 踩数 |
{$obj.art_hits} | 总点击量 |
{$obj.art_hits_day} | 日点击量 |
{$obj.art_hits_week} | 周点击量 |
{$obj.art_hits_month} | 月点击量 |
{$obj.art_time} | 更新时间 |
{$obj.art_time_add} | 添加时间 |
{$obj.art_time_hits} | 点击时间 |
{$obj.art_time_make} | 生成时间 |
{$obj.art_score} | 平均评分 |
{$obj.art_score_all} | 总评分 |
{$obj.art_score_num} | 评分次数 |
{$obj.art_rel_art} | 关联文章 |
{$obj.art_rel_vod} | 关联视频 |
{$obj.art_title} | 页面标题 |
{$obj.art_note} | 页面备注 |
{$obj.art_content} | 文章详细内容 |
{:mac_url_art_detail($obj)} | 文章详情页链接 |
四、文章详情页链接调用
在文章列表中，可以使用 mac_url_art_detail() 获取文章详情页地址：
{$vo.art_name}在文章详情页面中，则可以直接使用当前文章对象：
{:mac_url_art_detail($obj)}五、调用与当前文章关联的视频
如果当前文章设置了关联视频，可以通过 art_rel_vod 获取关联视频ID，并使用 {maccms:vod} 调用对应的视频数据。
<h2>与<strong>“{$obj.art_name}”</strong>关联的视频</h2>
<ul class="img-list dis">
{maccms:vod num="6" ids="' .$obj['art_rel_vod']. '" order="desc" by="time"}
<li>
<a href="{:mac_url_vod_detail($vo)}" title="{$vo.vod_name}">
<img src="{:mac_url_img($vo.vod_pic)}" alt="{$vo.vod_name}">
<h2>{$vo.vod_name}</h2>
<p></p>
<i>{$vo.vod_version}</i>
<em></em>
</a>
</li>
{/maccms:vod}
</ul>这里需要注意，$obj.art_rel_vod保存的是当前文章关联的视频数据，循环调用视频后使用 $vo 获取视频字段，例如 {$vo.vod_name}、{$vo.vod_pic}。
六、调用与当前文章关联的文章
如果文章设置了关联文章，可以通过 art_rel_art 调用相关内容：
<h2>与<strong>“{$obj.art_name}”</strong>关联的文章</h2>
<ul class="img-list dis">
{maccms:art num="6" ids="' .$obj['art_rel_art']. '" order="desc" by="time"}
<li>
<a href="{:mac_url_art_detail($vo)}" title="{$vo.art_name}">
<img src="{:mac_url_img($vo.art_pic)}" alt="{$vo.art_name}">
<h2>{$vo.art_name}</h2>
<p></p>
<i>{$vo.art_from}</i>
<em></em>
</a>
</li>
{/maccms:art}
</ul>七、文章列表标签使用注意事项
1. 列表循环使用 $vo
在 {maccms:art} 标签循环内部，当前文章数据一般使用 $vo，例如：
{$vo.art_name}
{$vo.art_pic}
{$vo.art_blurb}2. 文章详情页使用 $obj
文章详情页获取当前文章数据时使用 $obj，例如：
{$obj.art_name}
{$obj.art_content}
{$obj.art_author}
{$obj.art_time}3. 关联数据重新进入列表循环
通过 {maccms:vod} 或 {maccms:art} 调用关联数据后，循环内部重新使用 $vo 获取对应的视频或文章数据。
4. 图片建议使用图片处理函数
{:mac_url_img($vo.art_pic)}这样可以按照苹果CMS当前图片配置生成对应的图片地址。
八、总结
苹果CMS V10文章标签主要可以分为文章列表调用和文章详情页字段两部分。列表页面使用 {maccms:art} 获取文章数据，循环内部通过 $vo 调用字段；文章详情页面则通过 $obj 获取当前文章的完整数据。
在模板开发过程中，还可以利用 art_rel_vod 和 art_rel_art 调用当前文章关联的视频和文章，从而实现相关文章、相关推荐等功能。掌握 $vo 与 $obj 的使用区别后，可以更加方便地开发苹果CMS V10文章列表页和文章详情页模板。