苹果cms教程

苹果CMS maccms:actor演员列表标签参数详解与实战调用示例

发布时间：2026-03-09共16人阅读

一、演员模块基础调用配置

苹果CMS演员模块用于搭建站点演员资料体系，丰富影视站点内容结构，新版程序均采用分类化数据管理模式，依托专属标签可灵活完成演员数据的筛选、排序与列表渲染，适配全部演员相关页面开发场景。

  • 模板文件目录：html/actor/

  • 模块调用模型：model('Actor')

  • 模型ID：mid为8，模板中可通过 {$maccms.mid} 动态获取

  • 核心循环调用标签：{maccms:actor 参数="参数值"}内容{/maccms:actor}

二、maccms:actor标签全参数详细解析

maccms:actor标签内置丰富的配置参数，支持数据排序、精准筛选、时间过滤、分页、缓存自定义等功能，自由组合参数可实现最新、最热、指定分类、指定时段的演员数据展示效果，完整参数如下：

  • 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使用英文逗号分隔

  • 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（区间）判定

  • hitsweek：周点击量筛选，判定规则与hitsmonth一致

  • hitsday：日点击量筛选，判定规则与hitsmonth一致

  • hits：总点击量筛选，判定规则与hitsmonth一致

  • paging：分页功能开关，设置为yes即可开启列表分页

  • pageurl：自定义分页跳转路由地址，适配专属页面分页路径

  • cachetime：自定义数据缓存时长，单位为秒，可提升页面加载效率

三、演员标签基础实战调用示例

以下为通用基础调用代码，默认调取最新10条演员数据并完成基础内容渲染，循环范围内可搭配所有$vo前缀的演员字段，自由拓展头像、姓名、简介、评分等展示内容。

{maccms:actor num="10" order="desc" by="time"}
    <img src="{$vo.actor_pic|mac_url_img}"/>
    <h5>{$vo.actor_name}</h5>
    <!-- 更多内部标签字段请参考演员字段文档，以$vo.开头即可调用 -->
{/maccms:actor }
相关标签