模组参考视频
视频标签参数
MacCMS V10 视频标签参数：当前支持参数、最小调用示例和无结果排查。
MacCMS V10 · 更新于 · MacCMS Club 编辑部 · 版本与验证范围
使用 maccms:vod 在模板中输出视频列表。本模型 mid 为 1。
使用前
先在后台建立一条已启用的视频数据，并记下它的 ID。分类相关页面还需要属于此模型的分类；未审核或无访问权限的数据不一定会显示。 示例放在当前模板的 HTML 文件中，不是粘贴到浏览器控制台或 PHP 文件。
最小列表
{maccms:vod num="10" order="desc" by="time"}
<a href="{:mac_url_vod_detail($vo)}">{$vo.vod_name}</a>
{/maccms:vod}循环内部的 $vo 是当前一条视频。示例会生成最多 10 个名称链接；只有 3 条可见数据时只显示 3 条。
当前标签支持的参数
以下参数名按当前标签定义核对。没有写预设值的参数，示例应显式填写；不要把其他模型的参数直接套用。
| 参数 | 用法 |
|---|---|
| order | 排序方向：asc 升序，desc 降序 |
| by | 排序字段；示例 time，分类使用 sort |
| start | 开始位置；使用前确认期望跳过的数据 |
| num | 本次取多少条，例如 10 |
| id | 循环变量名，例如 vo；不是内容 ID |
| ids | 指定数据 ID，例如 1,2,3 |
| not | 排除的数据 ID |
| paging | yes 开启分页；no 不分页 |
| pageurl | 分页动作，例如 vod/search |
| type | 分类范围，例如 all、current 或具体分类 ID |
| typenot | 排除分类 ID |
| class | 扩展分类，值应与内容中保存的分类文字一致 |
| tag | 标签文字 |
| area | 地区，使用后台保存的文字 |
| lang | 语言，使用后台保存的文字 |
| year | 年份，例如 2026 |
| level | 推荐等级，例如 1 |
| letter | 首字母，例如 A |
| half | 分页条显示的页码窗口大小；分页函数空值默认按5处理 |
| rel | 关联内容条件；配合当前数据的关联设置 |
| version | 资源版本；不要与程序版本混淆 |
| state | 资源类别；不是审核状态 |
| tv | 电视台筛选 |
| weekday | 更新星期 |
| timeadd | 添加时间条件，例如 -1 day |
| timehits | 点击时间条件，例如 -1 week |
| time | 更新时间条件，例如 -1 day |
| hitsmonth | 月点击条件，例如 gt 1000 |
| hitsweek | 周点击条件，例如 gt 1000 |
| hitsday | 日点击条件，例如 gt 1000 |
| hits | 总点击条件，例如 gt 1000 |
| isend | 是否完结：0 或 1 |
| cachetime | 缓存时间，单位秒；改数据后可能要等待失效 |
常见问题
- 无结果：先移除筛选条件，再核对后台状态和分类。
- 改数据仍是旧结果：检查 cachetime 与本站缓存。
- 嵌套循环：外层和内层使用不同 id，例如 outer 和 inner，避免覆盖 $vo。