苹果CMS角色标签参数详解与模板调用教程

一、角色功能模组基础介绍

苹果CMS角色模组主要用于整理、展示影视剧中的虚构人物、演员及角色信息，能够有效丰富影视站点的内容维度，搭配影视主数据使用，可提升页面内容丰富度与展示效果。该模组拥有独立的模板目录与数据模型，适配各类影视模板的二次开发。

• 模板目录：html/role/

• 数据模型：model('Role')

• 模型MID值：9，可通过 {$maccms.mid} 标签动态获取当前模型MID

• 核心调用标签：{maccms:role 参数="参数值"}...{/maccms:role}

二、角色标签完整参数说明

角色标签支持排序、筛选、数量、分页、缓存等多项自定义参数，可精准筛选匹配所需的角色数据，适配不同页面的展示需求，全部可用参数及释义如下：

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使用逗号连接
rid指定关联对应视频ID
role指定演员名称，支持多个名称筛选，例：刘德华,成龙
name指定角色名称，支持多个名称筛选，例：花千骨,黑山老妖
letter指定名称首字母筛选
level指定推荐等级，支持多等级筛选，例：1,2
area指定地区筛选，支持多个地区，例：大陆,香港
timeadd按数据添加时间筛选（-1 day一天前、-1 week一周前、-1 month一月前、-1 hour一小时前）
timehits按点击时间筛选（支持天、周、月、小时时间规则）
time按数据更新时间筛选（支持天、周、月、小时时间规则）
hitsmonth月点击量筛选（gt 1000大于一千、lt 1000小于一千、between 1000,2000区间筛选）
hitsweek周点击量筛选（支持大于、小于、区间三种筛选规则）
hitsday日点击量筛选（支持大于、小于、区间三种筛选规则）
hits总点击量筛选（支持大于、小于、区间三种筛选规则）
paging是否开启分页，可选参数yes/no
pageurl自定义分页跳转地址
cachetime自定义缓存时间，单位为秒

三、角色标签实战调用示例

可通过角色标签关联当前视频ID，调取对应影片的参演角色、演员数据，通过参数控制数据条数、排序规则，基础实战代码如下：

{maccms:role num="10" paging="no" rid="'.$obj['vod_id'].'" order="asc" by="sort"}
<!-- 内部输出字段统一使用{$vo.}开头调用角色对应数据字段 -->
{/maccms:role}

该示例可单页调取10条当前影片关联角色数据，关闭分页功能，按正序规则排序，适用于影视详情页角色演员列表展示场景。