苹果CMS演员模块字段调用规则与全字段对照表

一、演员模块字段调用核心规则

苹果CMS演员模块的所有数据统一存储在mac_actor数据表中，模块下所有页面均可调取完整字段内容。不同页面场景仅变量前缀不同，字段属性、功能、用法完全一致，可灵活适配各类自定义演员模板开发需求。

二、列表页与详情页调用变量区分

演员模块字段根据页面渲染方式分为两种调用前缀，区分规则清晰，避免模板字段失效、数据不显示问题。

• 演员列表循环页面：使用 maccms:actor 标签批量循环数据，所有字段统一采用 $vo 前缀调用。

• 演员独立详情页面：单条演员数据独立渲染，所有字段统一采用 $obj 前缀调用。

统一字段调用示例：列表页演员名称 {$vo.actor_name}，详情页演员名称 {$obj.actor_name}。

三、演员模块完整可调用字段汇总

{$obj.actor_id} 演员ID
{$obj.type_id} 二级分类ID
{$obj.type_id_1} 一级分类ID
{$obj.actor_name} 演员姓名
{$obj.actor_en} 拼音别名
{$obj.actor_alias} 艺人别名
{$obj.actor_status} 数据状态
{$obj.actor_lock} 锁定状态
{$obj.actor_letter} 名称首字母
{$obj.actor_sex} 演员性别
{$obj.actor_color} 标题高亮颜色
{$obj.actor_pic} 演员封面图片
{$obj.actor_blurb} 简短简介
{$obj.actor_remarks} 备注信息
{$obj.actor_tag} TAG标签
{$obj.actor_class} 扩展分类
{$obj.actor_area} 所属地区
{$obj.actor_height} 身高
{$obj.actor_weight} 体重
{$obj.actor_birthday} 出生日期
{$obj.actor_birtharea} 出生地
{$obj.actor_blood} 血型
{$obj.actor_starsign} 星座
{$obj.actor_school} 毕业院校
{$obj.actor_works} 主要作品（多作品逗号分隔）
{$obj.actor_level} 推荐权重值
{$obj.actor_up} 点赞顶数
{$obj.actor_down} 踩评数量
{$obj.actor_score} 平均评分
{$obj.actor_score_all} 总评分
{$obj.actor_score_num} 评分次数
{$obj.actor_time} 更新时间
{$obj.actor_time_add} 数据添加时间
{$obj.actor_time_hits} 点击统计时间
{$obj.actor_time_make} 页面生成时间
{$obj.actor_tpl} 独立自定义模板
{$obj.actor_jumpurl} 外部跳转链接
{$obj.actor_content} 演员详细介绍内容
{$obj|mac_url_actor_detail} 演员详情页链接

四、字段通用使用规范

所有演员字段兼容演员首页、分类列表、筛选结果页、详情页等模块内全部页面。多作品字段以英文逗号作为数据分隔标识，可借助系统拆分函数实现多作品遍历展示。演员详情链接为系统内置函数，可自动适配站点伪静态与动态链接模式，无需手动修改路径参数，兼容性更强。