首页>苹果CMS教程>苹果CMS演员模块使用教程:选项详解与调取示例

苹果CMS演员模块使用教程:选项详解与调取示例

小编兔妹 2026-08-10 苹果CMS教程 21 浏览

这篇苹果cms教程聚焦演员模块:从选项含义到调取示例,把这套很实用的配套功能讲透。

①演员模块基础功能介绍

在苹果cms架设影视网站的过程里,演员模块是很实用的配套功能,重点用来完善网站的影视有关资料;补齐每部影片对应的参演演员信息,多样页面总体信息,既能调优用户的浏览感受,也对搜索引擎收录有着正向协助。

影视资源坊在此处提醒各位站长,程序2020版本之后针对演员组件做出了硬性调整,所有演员有关数据务必依托栏目进行归类管理,不能零散随意录入;规整的数据结构也会让后续的数据调取,后台管理更为省心。

②演员模块基础设置信息

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

模板文件存放目录html/actor/
对应数据模型model('Actor')
模型mid数值8,页面内调用变量:{$maccms.mid}
数据循环调取标签{maccms:actor}{/maccms:actor}

③actor调取标签所有选项详细说明

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

①基础排序、数量控制选项

order:设定数据的排列方式,desc为倒序展现,asc为正序展现,大部分场景下都会选用倒序优先展现全新数据。

by,选定排序参照根据;可选id、time、time_add、scorehits、hits_day、hits_week、hits_month、up、downlevel、rnd随机排序。

start,设定数据读取的起始位置;可以跳过前面一些条数据,做出错位排版的效果。

num,单次循环调取的演员数据条数,根据页面布局灵活填写数字就能。

②ID、栏目、标签定向筛选选项

ids:精准锁定指定ID的演员,数个ID使用英文逗号隔开填写;

not:排除指定ID的演员数据,数个ID同样用英文逗号分隔;

type:演员基础栏目筛选,填写all调取所有栏目数据,填入对应栏目ID就能只读取指定栏目信息。

class:拓展栏目筛选,兼容与此同时填写数个拓展栏目ID。

tag:按照自定义TAG标签筛选演员,数个标签之间用英文逗号分隔;

level:根据推荐等级筛选数据,可与此同时填入数个等级数值。

rel,关联影片筛选,填入影片ID要么影片名字,就能抓取这部影片对应的参演演员。

③时间维度筛选选项

timeadd:按照演员资料加入时间筛选,可选-1 hour一小时前,-1 day一天前,-1 week一周前,-1 month一月前。

timehits:按照用户浏览点击的时间范围筛选走俏演员,时间格式和上面保持一致;

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

④点击量条件筛选选项

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

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

hitsday:单日点击量筛选,用法同上;

hits:全站累计总点击量筛选,契合制作全站人气演员排行榜。

⑤分页、缓存调优有关选项

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 }
prepreprepreprepreprepreprepreprepreprepre

⑤总体使用总结

苹果cms,演员模块是影视网站必不可少的配套组件,依托多样化的标签选项可以灵活架设各种演员展现板块,把网站信息做的更为饱满多样。配合后台栏目化管理模式,网站数据条理清楚,也更利于搜索引擎抓取收录,入门站长直接套用示例代码就能快速完成基础的模板开发工作。

整套苹果cms教程里,演员模块属于上手成本最低的一块,把资料补齐后详情页的信息量会明显上一个台阶。