模组参考角色
角色字段
MacCMS V10 角色字段：字段类型、对象上下文与输出注意事项。
MacCMS V10 · 更新于 · MacCMS Club 编辑部 · 版本与验证范围
角色列表内使用 $vo，详情页的当前对象使用 $obj。字段不是全站全页面都有：把详情字段放到搜索页而没有对象，会出现空值。
两种上下文
<!-- 在 详情模板中 -->
<p>{$obj.role_name}</p>
<!-- 列表循环中 -->
{maccms:role num="10" order="desc" by="time"}
{$vo.role_name}
{/maccms:role}字段类型与含义
下表来自本次版本的安装表结构。数据库字段与运行时追加对象不同；自定义表前缀不改变模板字段名。
| 字段 | 存储类型 | 说明 |
|---|---|---|
| role_id | int(10) | 角色id |
| role_rid | int(10) | 关联视频id |
| role_name | varchar(255) | 角色名 |
| role_en | varchar(255) | 拼音 |
| role_status | tinyint(1) | 状态 |
| role_lock | tinyint(1) | 锁定 |
| role_letter | char(1) | 首字母 |
| role_color | varchar(6) | 高亮颜色 |
| role_actor | varchar(255) | 演员名称 |
| role_remarks | varchar(100) | 备注 |
| role_pic | varchar(1024) | 图片 |
| role_sort | smallint(6) | 排序 |
| role_level | tinyint(1) | 推荐值 |
| role_time | int(10) | 更新时间 |
| role_time_add | int(10) | 添加时间 |
| role_time_hits | int(10) | 点击时间 |
| role_time_make | int(10) | 生成时间 |
| role_hits | mediumint(8) | 参照后台同名数据项；本字段没有单独中文注释 |
| role_hits_day | mediumint(8) | 参照后台同名数据项；本字段没有单独中文注释 |
| role_hits_week | mediumint(8) | 参照后台同名数据项；本字段没有单独中文注释 |
| role_hits_month | mediumint(8) | 参照后台同名数据项；本字段没有单独中文注释 |
| role_score | decimal(3 | 平均分 |
| role_score_all | mediumint(8) | 总评分 |
| role_score_num | mediumint(8) | 评分次数 |
| role_up | mediumint(8) | 顶数 |
| role_down | mediumint(8) | 踩数 |
| role_tpl | varchar(30) | 自定义模板 |
| role_jumpurl | varchar(150) | 跳转url |
| role_content | text | 详情 |
输出时注意
- 名称直接输出；图片路径通过 mac_url_img 转换，不要假设总是完整 URL。
- 时间字段通常是 Unix 时间戳，按需要格式化；先确认字段类型。
- 数组或 JSON 不能当作一段普通文本直接输出。
- 关联对象取决于控制器和模型，不在本页表结构内的对象需要查对应页面。
查看角色标签选择数据，再按页面约定输出。