模组参考分类
分类字段
MacCMS V10 分类字段:字段类型、对象上下文与输出注意事项。
MacCMS V10 · 更新于 · MacCMS Club 编辑部 · 版本与验证范围
分类列表内使用 $vo,分类页的当前对象使用 $obj。字段不是全站全页面都有:把详情字段放到搜索页而没有对象,会出现空值。
两种上下文
<!-- 在 分类模板中 -->
<p>{$obj.type_name}</p>
<!-- 列表循环中 -->
{maccms:type num="10" order="desc" by="sort"}
{$vo.type_name}
{/maccms:type}字段类型与含义
下表来自本次版本的安装表结构。数据库字段与运行时追加对象不同;自定义表前缀不改变模板字段名。
| 字段 | 存储类型 | 说明 |
|---|---|---|
| type_id | smallint(6) | 分类id |
| type_name | varchar(60) | 名称 |
| type_en | varchar(60) | 别名 |
| type_sort | smallint(6) | 排序号 |
| type_mid | smallint(6) | 所属模块 |
| type_pid | smallint(6) | 上级id |
| type_status | tinyint(1) | 状态1开启0关闭 |
| type_tpl | varchar(30) | 分类页模板 |
| type_tpl_list | varchar(30) | 筛选页模板 |
| type_tpl_detail | varchar(30) | 详情页模板 |
| type_tpl_play | varchar(30) | 播放页模板 |
| type_tpl_down | varchar(30) | 下载页模板 |
| type_key | varchar(255) | 关键字 |
| type_des | varchar(255) | 描述信息 |
| type_title | varchar(255) | 标题 |
| type_union | varchar(255) | 参照后台同名数据项;本字段没有单独中文注释 |
| type_extend | text | 扩展配置json |
| type_logo | VARCHAR( | 分类图标 |
| type_pic | VARCHAR( | 分类封面 |
| type_jumpurl | VARCHAR( | 跳转url |
输出时注意
- 名称直接输出;图片路径通过 mac_url_img 转换,不要假设总是完整 URL。
- 时间字段通常是 Unix 时间戳,按需要格式化;先确认字段类型。
- 数组或 JSON 不能当作一段普通文本直接输出。
- 关联对象取决于控制器和模型,不在本页表结构内的对象需要查对应页面。
查看分类标签选择数据,再按页面约定输出。