# 目录
[TOC]
# 角色
角色功能针对影视剧里面虚构人物信息进行收集整理，配合影视资料可丰富站点内容！
* 目录`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 多个逗号连接
* `not`不抱含id 多个逗号链接
* `rid`指定关联视频id
* `role`指定演员名 支持多个 例如 刘德华,成龙
* `name`指定角色名 支持多个 例如 花千骨,黑山老妖
* `letter`指定首字母
* `level`指定推荐值 支持多个 1,2
* `area`指定地区 支持多个 大陆,香港
* `timeadd`添加时间 一天前 -1 day，一周前-1 week，一月前-1 month，一小时前-1 hour
* `timehits`点击时间 一天前 -1 day，一周前-1 week，一月前-1 month，一小时前-1 hour
* `time`更新时间 一天前 -1 day，一周前-1 week，一月前-1 month，一小时前-1 hour
* `hitsmonth`月点击量 大于一千 gt 1000, 小于一千 lt 1000，区间一千二千之间 between 1000,2000
* `hitsweek`周点击量 大于一千 gt 1000, 小于一千 lt 1000，区间一千二千之间 between 1000,2000
* `hitsday`日点击量 大于一千 gt 1000, 小于一千 lt 1000，区间一千二千之间 between 1000,2000
* `hits`总点击量 大于一千 gt 1000, 小于一千 lt 1000，区间一千二千之间 between 1000,2000
* `paging`是否分页yes
* `pageurl`分页地址
* `cachetime`自定义缓存时间单位秒
**标签使用示例**
~~~
{maccms:role num="10" paging="no" rid="'.$obj['vod_id'].'" order="asc" by="sort"}
<!-- 内部同下方角色字段，{$obj.改为{$vo.开头即可 -->
{/maccms:role}
~~~
## 角色字段
使用差异
* 在`maccms:role`内部使用字段默认以`$vo`开头, 如角色名称`{$vo.vod_name}`
* 在 详情页使用`$obj`开头，如角色名称`{$obj.vod_name}`
~~~
{maccms:role num="10" paging="no" rid="'.$obj['vod_id'].'" order="asc" by="sort"}
内部同下方，{$obj.改为{$vo.开头即可
{/maccms:role}
=======角色内容页独有标签=======
{$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} 跳转url
{$obj.role_content} 详情
{$obj|mac_url_role_detail} 获取角色详情页链接
~~~
## 角色首页
随意布局,可有可无，一般情况很少用到！
* 文件目录`html/role/index.html`
* 页面aid值`90`
## 角色搜索
* 文件目录`html/role/search.html`
* 页面aid值`93`**演员搜索表单**
~~~
<form id="search" name="search" method="get" action="{:mac_url('role/search')}" onSubmit="return qrsearch();">
<input type="text" name="wd" class="mac_wd" value="{$param.wd}" placeholder="人物名称" />
<input type="submit" class="mac_search" value="搜索人物" />
</form>
~~~
**演员搜索结果列表**
~~~
{maccms:role num="10" paging="yes" pageurl="role/search" order="desc" by="time"}
<li><a class="play-img" href="{:mac_url_role_detail($vo)}">
<img src="{:mac_url_img($vo.role_pic)}" alt="{$vo.role_name}" /></a>
<h2><a href="{:mac_url_role_detail($vo)}">{$vo.role_name}</a></h2>
<dl><dt>演员名称：</dt><dd>{$vo.role_actor}</dd></dl>
</li>
{/maccms:role}
~~~
## 角色详情
* 文件目录`html/role/detail.html`
* 页面aid值`94`
* 角色信息(数组)`$obj`
