模组参考演员
演员字段
MacCMS V10 演员字段：字段类型、对象上下文与输出注意事项。
MacCMS V10 · 更新于 · MacCMS Club 编辑部 · 版本与验证范围
演员列表内使用 $vo，详情页的当前对象使用 $obj。字段不是全站全页面都有：把详情字段放到搜索页而没有对象，会出现空值。
两种上下文
<!-- 在 详情模板中 -->
<p>{$obj.actor_name}</p>
<!-- 列表循环中 -->
{maccms:actor num="10" order="desc" by="time"}
{$vo.actor_name}
{/maccms:actor}字段类型与含义
下表来自本次版本的安装表结构。数据库字段与运行时追加对象不同；自定义表前缀不改变模板字段名。
| 字段 | 存储类型 | 说明 |
|---|---|---|
| actor_id | int(10) | 演员id |
| type_id | smallint(6) | 分类id |
| type_id_1 | smallint(6) | 一级分类id |
| actor_name | varchar(255) | 姓名 |
| actor_en | varchar(255) | 拼音 |
| actor_alias | varchar(255) | 别名 |
| actor_status | tinyint(1) | 状态 |
| actor_lock | tinyint(1) | 锁定 |
| actor_letter | char(1) | 首字母 |
| actor_sex | char(1) | 性别 |
| actor_color | varchar(6) | 高亮颜色 |
| actor_pic | varchar(1024) | 图片 |
| actor_blurb | varchar(255) | 简介 |
| actor_remarks | varchar(100) | 备注 |
| actor_area | varchar(20) | 地区 |
| actor_height | varchar(10) | 身高 |
| actor_weight | varchar(10) | 体重 |
| actor_birthday | varchar(10) | 生日 |
| actor_birtharea | varchar(20) | 出生地 |
| actor_blood | varchar(10) | 血型 |
| actor_starsign | varchar(10) | 星座 |
| actor_school | varchar(20) | 毕业院校 |
| actor_works | varchar(255) | 主要作品多个逗号相连 |
| actor_tag | varchar(255) | tags |
| actor_class | varchar(255) | 扩展分类 |
| actor_level | tinyint(1) | 推荐值 |
| actor_time | int(10) | 更新时间 |
| actor_time_add | int(10) | 添加时间 |
| actor_time_hits | int(10) | 点击时间 |
| actor_time_make | int(10) | 生成时间 |
| actor_hits | mediumint(8) | 参照后台同名数据项；本字段没有单独中文注释 |
| actor_hits_day | mediumint(8) | 参照后台同名数据项；本字段没有单独中文注释 |
| actor_hits_week | mediumint(8) | 参照后台同名数据项；本字段没有单独中文注释 |
| actor_hits_month | mediumint(8) | 参照后台同名数据项；本字段没有单独中文注释 |
| actor_score | decimal(3 | 平均分 |
| actor_score_all | mediumint(8) | 总评分 |
| actor_score_num | mediumint(8) | 评分次数 |
| actor_up | mediumint(8) | 顶数 |
| actor_down | mediumint(8) | 踩数 |
| actor_tpl | varchar(30) | 自定义模板 |
| actor_jumpurl | varchar(150) | 跳转url |
| actor_content | text | 详情 |
输出时注意
- 名称直接输出；图片路径通过 mac_url_img 转换，不要假设总是完整 URL。
- 时间字段通常是 Unix 时间戳，按需要格式化；先确认字段类型。
- 数组或 JSON 不能当作一段普通文本直接输出。
- 关联对象取决于控制器和模型，不在本页表结构内的对象需要查对应页面。
查看演员标签选择数据，再按页面约定输出。