苹果CMS演员模组完整使用教程（参数详解+调用示例）

一、演员模组基础功能介绍

在苹果cms搭建影视网站的过程里，演员模组是很实用的配套功能，主要用来完善网站的影视相关资料，补齐每部影片对应的参演演员信息，丰富页面整体内容，既能优化用户的浏览体验，也对搜索引擎收录有着正向帮助。

影视站长圈在这里提醒各位站长，程序2020版本之后针对演员模块做出了硬性调整，所有演员相关数据必须依托分类进行归类管理，不能零散随意录入，规整的数据结构也会让后续的数据调取、后台管理更加省心。

二、演员模组基础配置信息

想要在模板当中正常调取演员数据，先要理清该模块对应的文件路径、数据模型以及专属ID，这是模板二次开发的基础前提。

三、actor调取标签全部参数详细说明

这套演员调取标签内置了大量可控参数，站长可以按照自身页面的布局需求，自由完成数据排序、条件筛选、数量限制等操作，适配演员榜单、影片详情关联演员、分类艺人展示等各类场景。

1、基础排序、数量控制参数

order：设定数据的排列方式，desc为倒序展示，asc为正序展示，大部分场景下都会选用倒序优先展示最新数据。

by：选定排序参照依据，可选id、time、time_add、score、hits、hits_day、hits_week、hits_month、up、down、level、rnd随机排序。

start：设定数据读取的起始位置，能够跳过前面若干条数据，做出错位排版的效果。

num：单次循环调取的演员数据条数，依据页面布局灵活填写数字即可。

2、ID、分类、标签定向筛选参数

ids：精准锁定指定ID的演员，多个ID使用英文逗号隔开填写。

not：排除指定ID的演员数据，多个ID同样用英文逗号分隔。

type：演员基础分类筛选，填写all调取全部分类数据，填入对应分类ID即可只读取指定分类内容。

class：扩展分类筛选，支持同时填写多个扩展分类ID。

tag：按照自定义TAG标签筛选演员，多个标签之间用英文逗号分隔。

level：依据推荐等级筛选数据，可同时填入多个等级数值。

rel：关联影片筛选，填入影片ID或者影片名称，就能抓取这部影片对应的参演演员。

3、时间维度筛选参数

timeadd：按照演员资料添加时间筛选，可选-1 hour一小时前、-1 day一天前、-1 week一周前、-1 month一月前。

timehits：按照用户访问点击的时间范围筛选热门演员，时间格式和上面保持一致。

time：按照演员资料最后一次更新时间筛选，抓取近期维护更新的数据。

4、点击量条件筛选参数

hitsmonth：月度总点击量筛选，gt代表大于指定数值，lt代表小于指定数值，between用来设置数值区间，例between 1000,2000。

hitsweek：周点击量筛选，判断规则、书写格式和月点击量完全一致。

hitsday：单日点击量筛选，用法同上。

hits：全站累计总点击量筛选，适合制作全站人气演员排行榜。

5、分页、缓存优化相关参数

paging：开启分页功能，填写yes即可启用分页，适合长列表样式的演员页面。

pageurl：自定义分页跳转链接地址，适配不同页面的路由结构。

cachetime：单独设置当前标签的缓存时长，计量单位为秒，合理设置能够降低服务器查询压力，加快页面加载速度。

四、标签实际调用示范代码

下面是日常开发里使用率很高的基础调用代码，直接复制粘贴到对应模板文件内就能使用，适合首页演员推荐栏、侧边艺人卡片等位置。

{maccms:actor num="10" order="desc" by="time"}
   <img src="{$vo.actor_pic|mac_url_img}"/>
   <h5>{$vo.actor_name}</h5>
    <!-- 其余演员字段统一以$vo.开头调用，参照视频、文章字段调用方式即可 -->
{/maccms:actor }

五、整体使用总结

苹果cms演员模组是影视站点必不可少的配套模块，依托多样化的标签参数可以灵活搭建各类演员展示板块，把网站内容做的更加饱满丰富。配合后台分类化管理模式，站点数据条理清晰，也更利于搜索引擎抓取收录，新手站长直接套用示例代码就能快速完成基础的模板开发工作。