苹果CMS开发

苹果CMS分类标签maccms:type调用教程

2025-03-16 共人阅读

苹果CMS的分类标签 {maccms:type}{/maccms:type} 可以用于调用后台的分类数据。该标签并不局限于某一种模板页面，可以根据实际需求在不同模板中调用分类信息。

目前分类数据主要对应视频、文章、明星、网址等模块，站长可以通过分类标签获取不同模块下的分类，并结合模板循环输出分类名称、分类链接、分类图片等信息。

该标签对应的模型为 model('Type')，由于使用范围比较广，因此可以单独作为通用分类标签进行使用。

maccms:type标签参数

  • order：排列顺序，desc 为倒序，asc 为正序。

  • by：排序依据，可使用 id、sort 等字段。

  • start：从第几条分类数据开始获取。

  • num：获取分类数据的数量。

  • ids：指定分类范围，可使用 all 获取全部分类，也可以指定分类ID；parent 用于获取一级分类，child 用于获取子分类。

  • parent：指定父分类ID，用于获取指定一级分类下的子分类。

  • mid：指定所属模块，例如视频为 1、文章为 2、明星为 8，其他模块以当前程序版本的实际定义为准。

  • not：排除指定分类ID。

  • cachetime：自定义缓存时间，单位为秒。

maccms:type基本使用示例

下面示例可以按照排序字段正序获取10条分类数据：

{maccms:type num="10" order="asc" by="sort" ids="all"}
   <!-- 标签内部可以使用分类页相关字段，只需将 {$obj.字段} 改为 {$vo.字段} -->
{/maccms:type}

在 maccms:type 标签循环内部，分类数据对象通常使用 $vo 开头进行调用，例如：

{$vo.type_id}
{$vo.type_name}
{$vo.type_en}

嵌套标签获取一级和二级分类

如果需要同时调用一级分类和对应的二级分类，可以在 maccms:type 标签内部继续嵌套分类标签。外层循环获取一级分类，内层根据一级分类ID获取对应的子分类。

{maccms:type ids="1,2,3,4" order="asc" by="sort" id="vo1" key="key1"}
  <!-- 一级分类：{$vo1.type_name} -->
  {maccms:type parent="&#x27;.$vo1[&#x27;type_id&#x27;].&#x27;" order="asc" by="sort" id="vo2" key="key2"}
     <!-- 二级分类：{$vo2.type_name} -->
  {/maccms:type}
  <br>
{/maccms:type}

分类标签字段调用区别

使用 maccms:type 标签循环调用分类数据时，字段通常以 $vo 开头。例如分类名称可以使用 {$vo.type_name}。

而在影片、资讯、明星、网址等模块的分类页面中，当前分类对象通常以 $obj 开头。例如当前分类名称可以使用 {$obj.type_name}。

分类对象常用字段

<!-- 分类字段 -->
{$obj.parent} 当前分类的父分类对象
{$obj.parent.type_id} 一级分类ID

{$obj.type_id} 分类ID
{$obj.type_name} 分类名称
{$obj.type_en} 分类别名
{$obj.type_sort} 排序号
{$obj.type_mid} 所属模块
{$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} 跳转URL

{:mac_url_type($obj)} 分类链接

分类标签使用注意事项

  • $vo 主要用于 maccms:type 标签循环内部的分类数据。

  • $obj 主要用于影片、文章、明星、网址等模块的分类页面对象。

  • 不同苹果CMS版本或二次开发版本可能存在字段及模块定义差异，实际使用时应以当前程序版本为准。

  • 调用分类链接时，可以使用 mac_url_type($obj) 根据当前分类对象生成对应的分类URL。

总结

苹果CMS maccms:type 是一个通用的分类调用标签，可以用于获取视频、文章、明星、网址等模块的分类数据。通过 order、by、ids、parent、mid 等参数，可以灵活控制分类的范围、排序和层级关系，并结合分类字段实现一级、二级分类菜单及分类列表等页面效果。

标签：分类调用