苹果CMS V10文章列表与详情页标签模板制作全套调用教程

发布时间：2024-11-27共16人阅读

一、文章列表全局调用参数说明

苹果CMS文章列表通过 maccms:art 标签实现数据调取，支持排序、筛选、时间区间、点击量区间、分页等丰富参数，可自由组合实现最新文章、热门文章、指定分类、指定标签等列表样式。

order：排序方式，desc倒序、asc正序
by：自定义排序字段
start：数据起始条数，用于偏移调取
num：单次调取数据条数
ids：指定文章ID，多个ID用英文逗号分隔
type：分类筛选，all代表全部分类，支持填写指定分类ID
class：筛选扩展分类，支持多值
tag：筛选TAG标签，多标签用英文逗号分隔
level：筛选推荐等级，支持多等级匹配
rel：关联内容筛选，支持ID或名称匹配
timeadd：发布时间筛选（-1 day一天前、-1 week一周前、-1 month一月前、-1 hour一小时前）
timehits：点击时间筛选，参数格式同上
time：更新时间筛选，参数格式同上
hitsmonth：月点击量筛选（gt大于、lt小于、between区间）
hitsweek：周点击量筛选
hitsday：日点击量筛选
hits：总点击量筛选
paging：是否开启分页，yes开启、no关闭
pageurl：分页路由地址，文章列表固定 art/type

基础文章列表调用示例，无分页、调取全站最新10条文章数据：

{maccms:art num="10" paging="no" type="all" order="asc" by="sort"}
    // 内部循环字段使用 {$vo.xxx} 调用
{/maccms:art}

二、文章详情页专属字段标签大全

以下标签仅适用于文章内容详情页，覆盖文章基础信息、图文资源、数据统计、状态属性、链接地址等全部字段，是制作文章详情模板的核心标签。

{$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}           跳转链接
{$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}           关联文章ID集
{$obj.art_rel_vod}           关联视频ID集
{$obj.art_title}             页面SEO标题
{$obj.art_note}              页面SEO备注
{$obj.art_content}           文章详细内容
{:mac_url_art_detail($obj)}  文章详情页链接

三、详情页关联内容调取代码

利用文章自带关联ID字段，自动调取当前文章绑定的关联视频、关联文章，实现详情页相关推荐功能，提升页面内容丰富度。

1. 关联视频推荐列表

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

2. 关联文章推荐列表

<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.vod_from}</i><em></em></a></li>
    {/maccms:art}
</ul>

四、模板开发使用要点

文章列表循环内部统一使用 $vo 字段调用，文章详情页面统一使用 $obj 字段调用，字段不可混用。分页场景需开启 paging="yes" 并配置 pageurl="art/type"，避免分页链接失效。所有参数可自由组合，适配资讯站图文列表、新闻更新、内容推荐、详情关联模块等各类模板场景。

苹果cms教程