苹果CMS中综艺内容标签的精准调用实操指南

前期准备

操作前需确认两个核心信息：综艺栏目的ID、苹果CMS模板标签的调用规则。

1. 获取综艺栏目ID

登录苹果CMS后台，进入「内容管理-栏目管理」，找到已创建的综艺栏目，将鼠标悬停在「编辑」按钮上，查看浏览器地址栏中的参数，cid=XX中的XX即为综艺栏目的ID（例如：cid=7，则综艺栏目的ID为7），务必准确记录该ID，后续调用需用到。

核心调用实操步骤

苹果CMS的标签调用采用mac标签语法，核心格式为：{:mac('list', [参数数组])}，具体操作如下：

1. 列表页调用综艺内容

将以下代码复制到模板的列表页（例如index.html、list.html）对应位置，替换cid参数为你刚才获取的综艺栏目ID即可生效：

``` {:mac('list', ['cid' => 5, 'num' => 10, 'order' => 'time desc'])}

{$vo.title}

{:/} ```

参数说明：cid：必填，指定要调用的综艺栏目ID；num：选填，指定显示的综艺数量（默认10）；order：选填，指定排序规则，time desc为按最新发布倒序，hits desc为按点击量倒序，score desc为按评分倒序。

2. 按标签名称调用综艺内容

若需调用带有特定标签的综艺内容（例如“美食综艺”“真人秀”），使用tag参数替换cid参数即可，代码如下：

``` {:mac('list', ['tag' => '美食综艺', 'num' => 8, 'order' => 'hits desc'])} {:/} ```

注意：tag参数值必须与后台添加的综艺标签完全一致，大小写需匹配，否则调用无结果。

常见问题快速解决

1. 调用后前端无内容显示

• 检查栏目ID或tag参数是否正确，核对后台数据；
• 确认后台该栏目或标签下已添加至少1条综艺内容；
• 检查内容权限设置，排除会员可见等限制。

2. 调用内容排序不符合预期

调整order参数值为以下认可的标识：time desc（最新发布）、hits desc（点击量最高）、score desc（评分最高），不可使用中文命名排序规则。

拓展调用技巧

1. 实现综艺内容分页

在list标签参数中添加page=true，即可开启分页功能，代码示例：

``` {:mac('list', ['cid' => 5, 'num' => 10, 'page' => true])} {:/} ```

前端会自动生成“上一页/下一页”分页按钮，无需额外编写分页逻辑。