苹果CMS角色内容页全套调用标签与使用规范教程

一、角色标签调用场景差异说明

苹果CMS角色内容标签在不同页面场景拥有不同变量前缀，混用会导致数据无法正常读取，制作模板时需严格区分。

在 maccms:role 列表循环 内部，所有角色字段统一以 $vo 作为变量前缀。

在 视频详情页、角色独立详情页 单独调用角色字段时，统一以 $obj 作为变量前缀。

示例：角色名称调用，列表循环使用 {$vo.vod_name}，详情页独立调用使用 {$obj.vod_name}。

角色列表循环标准代码

{maccms:role num="10" paging="no" rid="'.$obj['vod_id'].'" order="asc" by="sort"}
// 循环内所有字段将 {$obj. 替换为 {$vo. 即可正常调用
{/maccms:role}

二、角色详情页完整专属标签汇总

以下为角色独立页面支持的全部原生字段，可直接用于模板开发，覆盖ID、基础信息、图片、数据统计、时间、内容详情及链接跳转等功能。

{$obj.role_id} 角色ID
{$obj.role_rid} 关联视频ID
{$obj.role_name} 角色名称
{$obj.role_en} 角色拼音
{$obj.role_status} 状态参数
{$obj.role_lock} 锁定状态
{$obj.role_letter} 名称首字母
{$obj.role_color} 高亮颜色
{$obj.role_actor} 关联演员名称
{$obj.role_remarks} 备注信息
{$obj.role_pic} 角色图片地址
{$obj.role_sort} 排序数值
{$obj.role_level} 推荐权重值
{$obj.role_up} 点赞顶数
{$obj.role_down} 点踩数量
{$obj.role_score} 平均评分
{$obj.role_score_all} 累计总评分
{$obj.role_score_num} 参与评分次数
{$obj.role_time} 更新时间
{$obj.role_time_add} 创建添加时间
{$obj.role_time_hits} 点击记录时间
{$obj.role_time_make} 静态生成时间
{$obj.role_tpl} 自定义绑定模板
{$obj.role_jumpurl} 自定义跳转链接
{$obj.role_content} 角色详细介绍内容
{$obj|mac_url_role_detail} 角色详情页链接地址