苹果CMS模板标签调用大全？

学完这篇，你能看懂苹果CMS V10 模板文件里那些 {maccms:xxx} 到底在干什么，并且能自己动手改一处列表调用、换一栏数据。

第一步：先认清标签的固定长相

苹果CMS 的模板标签全部写在 .html 模板文件里，语法只有两种形态：单标签 {$变量}，和成对标签 {maccms:标签名 参数="值"} ... {/maccms:标签名}。成对标签中间写 HTML 和 {$vo.字段}，它会按参数查出数据后循环输出。

看一个最小例子：

{maccms:vod num="8" type="1" order="desc" by="time"}
  <li><a href="{$vo.vod_name}">{$vo.vod_name}</a></li>
{/maccms:vod}

这段话意思是：取 1 号分类下最新 8 条视频，每条输出一个 <li>。

注意：标签里的引号必须是英文半角，中文引号会让整块内容直接不渲染，页面上什么都不显示。

第二步：找到模板文件在哪

登录后台（默认 /admin.php），左侧菜单点「系统」→「模板管理」，这里能看到当前启用的模板目录名。对应文件在服务器上的路径是：

/template/模板目录名/html/

常用文件：index.html（首页）、vod/index.html（视频列表页）、vod/detail.html（视频详情页）、vod/search.html（搜索页）、public/head.html（公共头部）。

改之前先复制一份原文件，改坏了能立刻还原。

第三步：调用分类 {maccms:type}

首页导航、分类筛选都用它。常用参数：ids（指定分类 ID，多个用逗号）、parent（父级 ID）、num（数量）、order+by（排序，如 by="sort"）。

{maccms:type parent="0" num="10" order="asc" by="sort"}
  <a href="{$vo.type_link}">{$vo.type_name}</a>
{/maccms:type}

第四步：调用视频列表 {maccms:vod}（用得最多）

这一步要做什么：把任意一栏视频数据拉到页面上。最常用的参数：

• num="10"：取多少条
• type="1,2,3"：指定分类 ID；写 type="current" 表示当前分类，写 type="parent" 表示当前分类的父级
• order="desc"：倒序；by="time" 按时间，by="hits" 按点击，by="score" 按评分，by="id" 按 ID
• start="5"：跳过前 5 条
• ids="12,15"：只取指定 ID 的这几条
• level="9"：按推荐等级筛选

按点击排行的写法：

{maccms:vod num="10" type="current" order="desc" by="hits"}
  <a href="{$vo.vod_name}">{$vo.vod_name}</a>
{/maccms:vod}

注意：type="current" 只能在列表页和详情页用，放到首页会取不到数据，首页必须写具体的分类 ID。

第五步：输出字段就用 {$vo.xxx}

循环体里所有数据都挂在 $vo 上，常用字段：vod_id、vod_name、vod_pic（封面）、vod_actor、vod_director、vod_year、vod_area、vod_lang、vod_remarks（更新至第几集）、vod_score、vod_hits、vod_time、vod_content（简介）、type_name（分类名）。图片记得加判断，缺图时给默认图，否则页面会出现空白块。

第六步：播放地址、分页、友情链接

详情页的播放列表用 {maccms:play}，它会自动把 vod_play_url 字段拆成一组「集数名 + 播放地址」：

{maccms:play name="play" url="vod_play_url"}
  <a href="{$vo.url}">{$vo.name}</a>
{/maccms:play}

分页标签写在 {maccms:vod} 标签的外面，并且 vod 标签要带上 paging="yes"：

{maccms:vod num="20" type="current" order="desc" by="time" paging="yes" pageurl="vod/type"}
  ...
{/maccms:vod}
{maccms:pages len="5"}
  <a href="{$vo.page_link}">{$vo.page_name}</a>
{/maccms:pages}

友情链接用 {maccms:link num="10"}，循环里输出 {$vo.link_name} 和 {$vo.link_url}。

注意：分页和播放标签各版本字段名有细微差别，如果套上去不显示，打开 template/default/html/public/ 下的默认模板文件对照一眼，以你本机默认模板的写法为准。

第七步：加条件判断和调试

想「只有评分大于 8 才显示推荐标」，用 {if}：

{if $vo.vod_score gt 8}<span>高分</span>{/if}

页面空白或标签原样显示在浏览器上，说明标签没被解析，检查这三处：文件是否放在 html/ 目录内、标签是否成对闭合、后台「系统」→「缓存管理」里清一次缓存。

小结

• 标签两类：{$变量} 取值，{maccms:标签 参数}...{/maccms:标签} 循环。
• 视频列表记住四个参数就够用：num、type、order、by。
• 循环体内数据全部通过 $vo.字段名 输出，字段名和数据库字段一致。
• type="current" 只能用在列表页和详情页。
• 改模板前先备份，改完清缓存，出现问题直接拿默认模板对照。