苹果CMS演员模块完整使用教程（标签参数、筛选、搜索、详情）

一、模块基础概述

苹果cms演员模块属于影视站点重要的原生辅助模块，用来完善影片对应的演员资料，扩充网站内容。2020及更新版本要求演员数据必须做分类管理，模块完整包含列表、筛选、搜索、详情整套页面逻辑。

整套模块拥有独立模板目录、数据模型与模板标签，参数配置灵活，开发者可以根据自己模板风格自由改造页面布局与交互逻辑。

二、模块基础配置信息

开发前需要熟记基础参数，模板标签调用、页面功能开发都依赖这些基础设置。

模板存放目录：html/actor，演员相关所有模板文件都放在该文件夹内。

对应数据模型：model('Actor')

模型mid编号：2，模板中可以直接使用{$maccms.mid}获取该数值。

核心循环标签：{maccms:actor}{/maccms:actor}

数据表来源：mac_actor，循环内可以读取数据表内全部字段。

三、模块功能特点

1、参数组合丰富，支持排序、时间区间、点击量、ID过滤、标签、分类等多种条件自由搭配调取数据。

2、自带多维度筛选，性别、地区、星座、血型、拼音首字母都可以直接通过URL参数实现筛选，不用额外写SQL语句。

3、内置演员搜索能力，通过关键词快速匹配演员名称，搜索结果支持分页展示。

4、数据联动能力强，演员详情页可以直接调取该人物参演的全部影视内容，做到演员与影片互相跳转。

5、支持自定义缓存时长，合理设置缓存能够降低数据库查询压力，提升网站访问速度。

6、各个页面分配独立aid标识，筛选页aid82、搜索页aid83、详情页aid84，方便模板做差异化处理。

四、模块部署使用说明

演员模块是系统原生内置，不需要额外安装源码，只需要部署模板文件并完成后台数据配置。

第一步：放置模板文件

确认网站html目录下存在actor文件夹，把show.html模板文件上传到html/actor/目录下。

第二步：后台数据配置

登录网站后台，进入演员管理，新建演员分类，录入演员资料并且绑定对应分类，新版系统要求演员必须归属分类。

第三步：清理网站缓存

模板上传完成之后，后台清除全部缓存，避免旧模板缓存干扰页面显示。

第四步：功能验证测试

分别访问演员筛选页、搜索页面、演员详情，检查列表展示、筛选切换、搜索提交、分页跳转、影片关联调用是否正常运行。

五、{maccms:actor}标签参数详解

该标签是读取演员数据的核心，不同参数组合可以实现首页演员推荐、分类列表、筛选结果、搜索结果等各类数据展示。

排序相关

order设置正序asc或者倒序desc；by指定排序字段，id、time、time_add、score、hits、hits_day、hits_week、hits_month、up、down、level、rnd随机排序都支持。

数量与偏移

num控制读取多少条演员数据；start设置从第几条数据开始输出，常用于做分栏错开展示。

ID、分类、标签过滤

ids指定读取部分演员ID；not用来排除部分ID；type用于演员分类筛选；class扩展分类；tag标签筛选；level筛选推荐等级；rel实现关联数据调取。

时间条件

timeadd添加时间、timehits点击时间、time更新时间，支持-1 day、-1 week、-1 month、-1 hour时间表达式。

访问量条件

hitsmonth、hitsweek、hitsday、hits分别对应月、周、日、总点击，支持gt大于、lt小于、between区间判断。

分页缓存

paging="yes"开启分页；pageurl填写分页路由；cachetime自定义缓存，单位秒。

六、三个核心页面开发要点

6.1 演员筛选页面

文件路径html/actor/show.html，页面aid等于82。生成筛选页面链接标签为{:mac_url_type(['type_id'=>2],['by'=>'hits'],'show')}。

页面依靠URL传参实现条件过滤，id分类ID为必填，sex性别、blood血型、starsign星座、letter首字母、area地区属于可选筛选条件，同时可以切换排序方式。页面内循环标签开启paging即可实现分页列表。

6.2 演员搜索页面

复用show.html模板，页面aid等于83。生成搜索链接{:mac_url_search(['wd'=>'刘德华'],'actor')}。

通过表单get提交wd关键词，系统自动匹配演员名称，搜索结果同样使用{maccms:actor}循环输出列表，开启分页参数实现多页浏览。

6.3 演员详情页面

同样使用show.html模板，页面aid等于84。生成详情链接标签{mac_url_actor_detail($vo)}，传入演员数组或者actor_id都可以。

页面内$obj保存当前演员完整信息，直接调用$obj.xxx字段输出内容。最常用的功能就是通过vod标签，调取当前演员出演的所有视频数据。调试的时候可以写入{:print_r($obj)}打印全部字段查看。

七、常用代码片段参考

基础演员列表调用示例：

{maccms:actor num="10" order="desc" by="time"}
   <img src="{$vo.actor_pic|mac_url_img}"/>
   <h5>{$vo.actor_name}</h5>
{/maccms:actor }

详情页调取演员参演影片：

{maccms:vod num="35" actor="'.$obj['actor_name'].'" paging="yes" pageurl="actor/detail"  order="desc" by="time"}
    <li><a href="{:mac_url_vod_detail($vo)}" title="{$vo.vod_name}">
      <img src="{:mac_url_img($vo.vod_pic)}" alt="{$vo.vod_name}"/>
      <h2>{$vo.vod_name}</h2>
      <p>{$vo.vod_actor}</p>
   </a></li>
{/maccms:vod}

八、总结

演员模块是影视网站很实用的原生组件，不需要额外安装程序，只需要配置模板与后台数据。掌握标签参数、筛选传参规则、详情页数据联动，就能够搭建完整的演员体系，丰富网站内容同时改善用户浏览体验。开发时可以根据自己模板的UI风格修改HTML布局，保留标签逻辑不变即可。