苹果cms教程

苹果CMS专题maccms:topic标签参数与调用示例教程

发布时间：2025-04-18共14人阅读

一、专题模块基础属性

苹果CMS内置专题模块，支持整合视频、文章内容聚合生成专题页面，实现内容归类展示。专题模块拥有固定的文件目录与模型参数，是专题标签正常调用的基础配置。

  • 模板目录：html/topic

  • 调用模型：model('Topic')

  • 模型ID：mid为3，可通过 {$maccms.mid} 标签实时获取当前专题模型ID值

专题内容列表统一通过系统专属标签实现渲染，标准标签结构为 {maccms:topic 参数="参数值"}内容渲染代码{/maccms:topic}。

二、maccms:topic标签完整参数详解

1. 排序控制参数

  • order：控制数据排列方式，desc 为倒序排列，asc 为正序排列

  • by：指定排序依据，支持多种字段排序，可选值包含 id、time、time_add、score、hits、hits_day、hits_week、hits_month、up、down、level、rnd

2. 数据筛选与数量参数

  • start：设置数据读取起始位置，可实现跳过指定条数数据的展示效果

  • num：限定单次调用获取的专题数据条数

  • ids：精准指定专题ID，支持多个ID逗号分隔，格式如 ids="1,2,3"，填写all则读取全部专题

3. 时间筛选参数

支持自定义时间范围筛选专题数据，统一适配时分日周月时间规则。

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

  • timehits：按专题点击时间筛选，时间规则与timeadd一致

  • time：按专题更新时间筛选，时间规则与timeadd一致

4. 点击数据筛选参数

可根据不同维度的点击数据精准筛选专题，支持大于、小于、区间三种筛选模式。

  • hits：总点击量筛选，gt代表大于、lt代表小于、between代表区间范围

  • hitsday：日点击量筛选，适配数值对比与区间筛选

  • hitsweek：周点击量筛选，适配数值对比与区间筛选

  • hitsmonth：月点击量筛选，适配数值对比与区间筛选

5. 分页参数

  • paging：控制是否开启分页功能，赋值 yes 开启分页，默认关闭

三、专题标签实战调用示例

以下为通用专题列表调用代码，可直接用于专题首页、侧边栏专题推荐等场景，通过自定义参数适配不同展示需求，内部可调用所有专题 $vo 系列字段。

{maccms:topic num="10" paging="no" order="asc" by="sort" ids="all"}
    <img src="{$vo.topic_pic|mac_url_img}"/>
    <h5>{$vo.topic_name}</h5>
    <!-- 内部为专题全字段，$vo.开头 -->
{/maccms:topic}

四、代码使用说明

示例代码默认读取10条全部专题数据，按排序号正序展示且关闭分页。开发者可根据页面需求自由修改展示条数、排序规则、数据筛选条件，标签循环内部支持所有专题字段调用，可自主拓展图片、简介、点击量、评分等数据展示模块。

相关标签