苹果CMS V10视频调用标签完整参数与实战用法

一、视频调用模组基础信息

苹果CMS视频数据专属调用模组为站点影视内容核心渲染模块，模板开发调用视频列表数据时需严格对应模组路径与模型参数。

• 模板目录：html/vod

• 所属模型：model('Vod')

• 模型ID：mid1

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

二、maccms:vod 全部参数详解

order 排序方式：desc倒序、asc正序
by 排序字段：id、time、time_add、score、hits、hits_day、hits_week、hits_month、up、down、level、rnd（随机）
start 数据起始行数，可跳过前N条数据
num 单次调用数据条数
ids 精准指定视频ID，多ID使用英文逗号分隔
not 排除指定视频ID，多ID逗号链接
type 分类筛选：all全部、指定分类ID（1,2,3）
class 扩展分类筛选，支持多分类匹配
tag 标签筛选，多个标签英文逗号分隔
level 推荐等级筛选，适配不同层级推荐内容
area 影视地区筛选，支持多地区同时匹配
lang 影视语言筛选，可自定义国语、粤语等参数
year 上映年代筛选，精准调取指定年份影视
state 资源类型筛选：高清版、剧场版、抢先版等
version 资源版本筛选：正片、预告片等
weekday 更新周期筛选，适配周更剧集
rel 关联数据筛选，支持ID或名称匹配
timeadd 数据添加时间筛选：-1 day一天前、-1 week一周前、-1 month一月前、-1 hour一小时前
timehits 点击时间筛选，时间规则同上
time 更新时间筛选，时间规则同上
hitsmonth 月点击量筛选：gt大于、lt小于、between区间
hitsweek 周点击量筛选，匹配规则同上
hitsday 日点击量筛选，匹配规则同上
hits 总点击量筛选，匹配规则同上
paging 分页开关：yes开启分页
pageurl 自定义分页地址
cachetime 自定义缓存时长，单位秒
isend 完结状态筛选：0未完结、1已完结
plot 分集剧情字段调用：0关闭、1开启

三、视频标签实战调用示例

以下为通用最新视频列表调用代码，可直接用于首页、侧边栏、专题页面，调用全站最新10条影视资源，按发布时间倒序展示，适配绝大多数模板布局。

{maccms:vod type="all" by="time" num="10" order="desc"}
   <img src="{$vo.vod_pic|mac_url_img}"/>
   <h5>{$vo.vod_name}</h5>
   <!-- 更多视频字段均可通过 $vo.xxx 方式调用 -->
{/maccms:vod}

四、调用使用说明

所有视频自定义字段、原生字段均可通过 $vo.字段名 方式循环输出，根据模板布局自由搭配封面图、标题、年份、地区、评分、播放量等数据。通过组合上方筛选参数，可实现热门视频、最新更新、随机推荐、指定分类、高点击影视等各类数据调取效果。