苹果cms教程

苹果CMS文章maccms:art标签参数详解与调用示例

发布时间：2025-03-29共10人阅读

一、文章模块基础属性

苹果CMS文章资讯模块拥有独立目录与模型标识，模板开发调用需遵循对应模型参数，基础配置如下：

  • 模块模板目录：html/art

  • 所属模型名称：model('Art')

  • 模型MID标识：2，可通过 {$maccms.mid} 动态获取当前模型ID

  • 核心调用标签：{maccms:art}{/maccms:art}

二、maccms:art标签完整参数说明

文章标签支持排序、数量、分类、筛选、时间、分页、缓存等多种参数组合，可灵活实现不同资讯列表展示效果，所有参数用法如下：

  • order：数据排列方式，desc 倒序、asc 正序

  • by：排序依据，支持 id、time、time_add、score、hits、hits_day、hits_week、hits_month、up、down、level、rnd 随机排序

  • start：数据读取起始位置，可跳过指定条数数据

  • num：单次读取数据条数，控制列表展示数量

  • ids：指定读取文章ID，多ID使用英文逗号分隔，例如 1,2,3

  • not：排除指定文章ID，多ID逗号拼接过滤多条数据

  • type：分类筛选，all 读取全部分类数据，自定义填写分类ID可指定单一或多个分类

  • class：按文章扩展分类筛选，支持多个扩展分类同时匹配

  • tag：按文章TAG标签筛选，多标签用英文逗号分隔

  • level：按文章推荐等级筛选，支持多个等级数值匹配

  • rel：关联数据筛选，可填写关联ID或关键词匹配对应文章

  • timeadd：按文章添加时间筛选，支持 -1 day（一天前）、-1 week（一周前）、-1 month（一月前）、-1 hour（一小时前）

  • timehits：按文章点击时间筛选，时间格式与timeadd参数一致

  • time：按文章更新时间筛选，时间格式与timeadd参数一致

  • hitsmonth：月点击量筛选，gt数值（大于）、lt数值（小于）、between数值1,数值2（区间范围）

  • hitsweek：周点击量筛选，语法规则同hitsmonth

  • hitsday：日点击量筛选，语法规则同hitsmonth

  • hits：总点击量筛选，语法规则同hitsmonth

  • paging：分页开关，填写yes开启分页功能

  • pageurl：自定义分页跳转地址，适配不同页面分页路由

  • cachetime：自定义标签缓存时间，单位为秒，可提升站点访问速度

三、文章标签基础调用示例

以下为通用文章列表循环代码，默认读取全站最新10条文章，按更新时间倒序排列，可直接用于首页、栏目页资讯展示。

{maccms:art type="all" by="time" num="10" order="desc"}
    <img src="{$vo.art_pic|mac_url_img}"/>
    <h5>{$vo.art_name}</h5>
    <!-- 更多内部标签字段请参考文章字段，以$vo.开头即可调用 -->
{/maccms:art}
相关标签