苹果CMS分类字段调用规则、场景区分与全字段对照表

一、分类字段调用场景与变量区分

苹果CMS所有分类字段数据统一存储在系统分类数据表中，不同页面场景的字段属性、功能完全一致，仅调用变量前缀存在区别。模板开发需严格匹配对应变量写法，避免出现字段不生效、数据读取失败等问题。

• 分类列表循环页面：通过 maccms:type 标签批量循环分类数据，所有分类字段统一使用 $vo 前缀，示例：{$vo.type_name}。

• 分类独立主页：影视、资讯、明星、网址等模块的单独分类页面，读取当前分类数据统一使用 $obj 前缀，示例：{$obj.type_name}。

二、苹果CMS完整分类可调用字段汇总

以下为系统原生全部分类字段，支持所有模块分类页面调用，包含基础信息、模板配置、拓展参数、链接生成等全覆盖字段。

{$obj.parent} 上级分类对象（二级分类专用，可调用一级分类所有字段，例：{$obj.parent.type_id}）
{$obj.type_id} 分类ID
{$obj.type_name} 分类名称
{$obj.type_en} 分类别名/拼音
{$obj.type_sort} 分类排序序号
{$obj.type_mid} 所属模块ID
{$obj.type_pid} 上级分类ID
{$obj.type_status} 分类状态（1=开启，0=关闭）
{$obj.type_tpl} 分类首页自定义模板
{$obj.type_tpl_list} 分类筛选列表页模板
{$obj.type_tpl_detail} 内容详情页模板
{$obj.type_tpl_play} 播放页专属模板
{$obj.type_tpl_down} 下载页专属模板
{$obj.type_key} 分类关键词
{$obj.type_des} 分类描述
{$obj.type_title} 分类自定义标题
{$obj.type_extend} 分类扩展配置（JSON格式数据）
{$obj.type_logo} 分类图标
{$obj.type_pic} 分类封面图片
{$obj.type_jumpurl} 分类外部跳转链接
{:mac_url_type($obj)} 自动生成分类标准访问链接

三、核心字段功能与使用技巧

• parent 上级分类字段：是多级分类开发的核心字段，主要用于二级、三级分类页面，可直接调用上级分类的所有数据字段，无需单独编写查询标签，简化多级分类模板开发流程。

• 自定义模板系列字段：支持为不同分类单独配置首页、列表页、详情页、播放页、下载页模板，可实现站点不同分类页面的差异化布局与样式，适配多样化站点设计需求。

• 分类链接函数：系统自带 {:mac_url_type($obj)} 链接生成方法，可自动适配网站伪静态、动态链接配置，无需手动修改路径，兼容性覆盖所有正版苹果CMS环境。

• 拓展配置字段：type_extend 以JSON格式存储分类拓展参数，可用于自定义分类额外属性，满足个性化功能开发需求。