苹果cms教程

苹果CMS演员模块maccms:actor标签参数详解与调用示例

发布时间:2025-05-10共8人阅读

一、演员模块基础说明

演员模块用于完善影视站点艺人资料数据,丰富页面内容维度。2020及后续版本程序对演员数据实行分类化管理,所有演员模板文件、数据模型均独立部署,适配自定义开发。

  • 模板目录:html/actor/

  • 数据模型:model('Actor')

  • 模型ID:8,可通过 {$maccms.mid} 动态获取当前模型ID

  • 通用调用标签:{maccms:actor 参数="参数值"}...{/maccms:actor}

二、maccms:actor 完整标签参数详解

// 排序设置
order    排列方式,desc倒序、asc正序
by       排序字段,支持 id、time、time_add、score、hits、hits_day、hits_week、hits_month、up、down、level、rnd

// 数据数量与起始位置
start    数据读取起始条数
num      单次调取数据条数

// ID筛选
ids      精准指定演员ID,多ID以英文逗号分隔
not      排除指定ID,多ID逗号链接

// 分类与扩展筛选
type     主分类筛选,all为全部,也可指定多个分类ID
class    扩展分类筛选,支持多分类同时匹配
tag      标签筛选,多个标签使用英文逗号分隔
level    推荐等级筛选,支持多值匹配
rel      关联数据筛选,可填写ID或关联名称

// 时间筛选
timeadd  根据添加时间筛选(-1 day一天前、-1 week一周前、-1 month一月前、-1 hour一小时前)
timehits 根据点击时间筛选(时间规则同上)
time     根据更新时间筛选(时间规则同上)

// 点击数据区间筛选
hitsmonth  月点击量筛选,支持 gt大于、lt小于、between区间
hitsweek   周点击量筛选,支持 gt大于、lt小于、between区间
hitsday    日点击量筛选,支持 gt大于、lt小于、between区间
hits       总点击量筛选,支持 gt大于、lt小于、between区间

// 分页与缓存
paging   是否开启分页,yes开启、no关闭
pageurl  分页伪静态地址
cachetime 自定义缓存时长,单位:秒

三、演员标签标准调用示例

以下为通用循环调用代码,可直接用于演员列表页开发,循环内部字段统一以 $vo 开头调用。

{maccms:actor num="10" order="desc" by="time"}
<img src="{$vo.actor_pic|mac_url_img}"/>
<h5>{$vo.actor_name}</h5>
<!-- 更多演员字段均可通过 $vo.xxx 方式调用 -->
{/maccms:actor }