苹果CMS首页轮播/列表数据标签调用手把手实操指南

前置准备

本文基于苹果CMSv10官方版本操作，无需额外插件。首先找到首页模板文件：进入苹果CMS安装目录，路径为template/default/index.html；若通过FTP管理，先将该文件下载到本地，用VSCode或Notepad++打开编辑。

核心标签实操（完整代码直接复制）

1. 首页轮播图调用

轮播图调用对应后台添加的幻灯片内容，代码如下，参数可直接按需修改：

{:maccms:slide num="5" type="index" return="vo"}

{:vo.title}

{/maccms:slide}

参数说明：num="5" 表示调用5张轮播图，如需6张改为num="6"；type="index" 固定为首页，不可修改；return="vo" 是轮播项的变量名，请勿修改。

2. 首页电影分类列表调用

调用后台所有顶级分类及对应下的10个内容，代码如下：

{:maccms:type num="8" pid="0" return="typevo"}

• {:typevo.type_name}

  {:maccms:vod num="10" type="typevo.type_id" order="updatetime desc" return="vodvo"}
  • {:vodvo.title}
  {/maccms:vod}
{/maccms:type}

参数说明：num="8" 表示调用8个顶级分类，如需减少/增加分类数调整；pid="0" 指调用顶级分类，若需子分类改为对应父分类ID；type="typevo.type_id" 绑定当前分类的内容，这里需对应后台分类ID（后台→内容管理→分类管理，每个分类后的数字即为ID）；order="updatetime desc" 按更新时间倒序排列，如需按热度改为order="hits desc"。

3. 首页最新更新视频调用

调用指定分类下的最新20条视频内容，代码如下：

{:maccms:vod num="20" type="1,2,3" order="updatetime desc" return="newvo"}

{:newvo.title}

{:newvo.remarks}

{/maccms:vod}

参数说明：type="1,2,3" 指调用分类ID为1、2、3的内容，需替换为自己后台的分类ID；num="20" 表示调用20条视频，按需调整。

生效配置与测试（必做）

修改模板后必须清空缓存才能生效，操作步骤：

• 进入苹果CMS后台，路径为：你的域名/admin.php
• 登录后台后，点击「系统设置」→「清除缓存」
• 勾选「模板缓存」，点击「确认清空」按钮（务必勾选模板缓存，否则修改不显示）

最后刷新浏览器首页，即可看到调用的数据。若出现不显示的情况，按以下顺序排查：

• 检查分类ID是否正确（对照后台分类管理）
• 检查标签语法是否闭合：所有{:maccms:xxx}开头的标签，必须对应{/maccms:xxx}结尾，比如轮播标签的结尾是{/maccms:slide}，切勿遗漏
• 检查后台是否添加了对应内容：轮播图需在后台「内容管理」→「幻灯片管理」添加，视频需在「内容管理」→「视频管理」添加