模组参考分类
分类标签参数
MacCMS V10 分类标签参数：当前支持参数、最小调用示例和无结果排查。
MacCMS V10 · 更新于 · MacCMS Club 编辑部 · 版本与验证范围
使用 maccms:type 在模板中输出分类列表。分类可以跨内容模型使用；用 mid 缩小范围。
使用前
先在后台建立一条已启用的分类数据，并记下它的 ID。分类相关页面还需要属于此模型的分类；未审核或无访问权限的数据不一定会显示。 示例放在当前模板的 HTML 文件中，不是粘贴到浏览器控制台或 PHP 文件。
最小列表
{maccms:type num="10" mid="1" order="desc" by="sort"}
<a href="{:mac_url_type($vo)}">{$vo.type_name}</a>
{/maccms:type}循环内部的 $vo 是当前一条分类。示例会生成最多 10 个名称链接；只有 3 条可见数据时只显示 3 条。
当前标签支持的参数
以下参数名按当前标签定义核对。没有写预设值的参数，示例应显式填写；不要把其他模型的参数直接套用。
| 参数 | 用法 |
|---|---|
| order | 排序方向：asc 升序，desc 降序 |
| by | 排序字段；示例 time，分类使用 sort |
| start | 开始位置；使用前确认期望跳过的数据 |
| num | 本次取多少条，例如 10 |
| id | 循环变量名，例如 vo；不是内容 ID |
| ids | 指定数据 ID，例如 1,2,3 |
| names | 指定分类名称 |
| not | 排除的数据 ID |
| parent | 上级分类 ID |
| flag | 分类查询标志，需结合分类标签解析逻辑使用 |
| mid | 模型编号：视频1、文章2、演员8、网址11、漫画12 |
| format | 分类输出格式参数 |
| cachetime | 缓存时间，单位秒；改数据后可能要等待失效 |
常见问题
- 无结果：先移除筛选条件，再核对后台状态和分类。
- 改数据仍是旧结果：检查 cachetime 与本站缓存。
- 嵌套循环：外层和内层使用不同 id，例如 outer 和 inner，避免覆盖 $vo。