苹果CMS maccms:type分类标签参数详解与嵌套调用教程

一、分类标签基础概述

maccms:type是苹果CMS系统通用分类调用标签，可读取后台所有模块的分类数据，不受页面模板限制，通用性极强。该标签支持视频、文章、演员、网址等多模块分类调取，是站点导航分类、分类列表、多级分类菜单开发的核心标签。

标签对应数据模型：model('Type')

标签适配模块对应mid参数：视频模块1、文章模块2、演员模块8、网址模块。

二、maccms:type标签完整参数说明

该标签支持排序、数据截取、精准筛选、数据排除、缓存自定义等多项配置，可灵活实现全站分类、指定分类、父子级分类等多样化展示效果，具体参数用法如下：

• order：数据排列方式，desc为倒序排列，asc为正序排列

• by：数据排序依据，支持id、sort两种排序规则

• start：数据读取起始位置，可跳过指定条数分类数据，实现截取展示效果

• num：单次调取分类数量，用于控制列表展示条数

• ids：分类精准筛选参数，all代表全部分类，parent调取一级分类，child调取子分类，也可自定义多分类ID，多ID以英文逗号分隔

• parent：父分类ID筛选，用于匹配指定父分类下的子分类数据

• mid：模块筛选参数，对应各业务模块ID，可单独调取某一模块分类数据

• not：分类ID排除参数，可指定需要过滤的分类ID，多ID逗号分隔

• cachetime：自定义数据缓存时长，单位为秒，有效提升页面访问速度

三、基础单层分类调用示例

基础调用代码可批量调取全站分类数据，按排序序号正序展示，循环内部将分类独立页面的 {$obj} 字段前缀替换为 {$vo} 即可正常调用所有分类字段。

{maccms:type num="10" order="asc" by="sort" ids="all"}
    <!-- 分类数据循环区域，可使用{$vo}前缀调用分类所有字段 -->
{/maccms:type}

四、一级二级嵌套分类调用示例

通过标签嵌套写法可实现多级分类联动展示，适合制作网站多级导航、分类菜单栏，精准匹配指定一级分类及其下属所有二级子分类。

{maccms:type ids="1,2,3,4" order="asc" by="sort" key="key1"}
    <!-- 输出一级分类名称 -->
    <div>一级分类：{$vo1.type_name}</div>
    <!-- 嵌套调取当前一级分类下的二级子分类 -->
    {maccms:type parent="'.$vo1['type_id'].'" order="asc" by="sort" key="key2"}
        <div>二级分类：{$vo2.type_name}</div>
    {/maccms:type}
    <br>
{/maccms:type}

五、标签调用注意事项

• 单层分类循环统一使用 {$vo} 字段前缀，嵌套循环需搭配自定义key值，区分不同层级分类变量，避免数据错乱。

• 通过mid参数可隔离不同模块分类数据，避免视频、演员、文章分类数据混杂展示。

• 多级分类调用依靠parent参数绑定父子级关系，精准匹配上下级分类数据，适配各类多级菜单开发场景。