苹果CMS实现置顶内容标签调用的实操步骤全指南

前置准备

1. 确认已安装苹果CMS V10稳定版（当前主流兼容所有场景的版本）；2. 后台内容管理中，已给需置顶的内容勾选「置顶」选项（单条/批量均可）；3. 提前备份对应主题模板文件，路径：/app/themes/你的主题名称/，修改前备份可避免代码错误后无法恢复，务必执行此步。

核心实操步骤

1. 定位目标列表页模板

根据你需要显示置顶内容的位置，找到对应模板文件：若调用首页列表，找index.html；若调用某分类页（如电影分类）列表，找category_分类ID.html；若调用自定义页面，找对应页面模板。绝对不要修改非目标列表的模板文件，避免无关内容显示异常。

2. 替换列表调用代码为置顶标签

打开目标模板文件，找到原有列表调用的{sdk:lists}标签块，删除原有列表代码，粘贴以下置顶调用代码（以带图片的内容列表为例，符合80%使用场景）：

``` {sdk:lists flag='top' row='5' catid='0'}

{$vo.title}

{/sdk:lists} ```

代码参数说明（按需修改，错误参数会导致调用失败）：

• flag='top'：固定参数，仅调用标记为「置顶」的内容，不可修改；
• row='5'：控制显示置顶内容的数量，可改为1/10/20等数字，最大不超过后台设置的单页最大条数；
• catid='0'：调用全站所有分类的置顶内容，若需限制某分类（如电影分类ID为2），改为catid='2'；
• loading='lazy'：可选，开启图片懒加载，减少服务器压力，不需要可删除；
• 标签内的img/title部分可根据你原模板的样式调整，仅替换列表调用的{sdk:lists}块即可。

核心注意：所有引号必须是英文半角引号，中文引号会导致代码直接失效，不要用中文输入法输入符号。

3. 上传文件并清空缓存

将修改后的模板文件，通过FTP或服务器文件管理工具上传，覆盖原服务器路径的对应文件。之后必须清空苹果CMS缓存，否则前端页面不会更新：

• 后台快捷方式：登录苹果CMS后台→系统设置→点击「清空缓存」按钮→确认操作；
• 手动方式：删除服务器路径/app/runtime/cache/下的所有文件（仅删除此目录，不要动其他目录）。

清空缓存是必做步骤，90%的调用失败都是因为没有清空缓存。

4. 测试与问题排查

打开前端对应页面，查看目标位置是否显示你标记的置顶内容：

• 若显示：操作成功，无需其他调整；
• 若未显示，按以下顺序排查：
  • 检查后台对应内容是否已勾选「置顶」选项，是否发布状态为「已审核」；
  • 检查模板路径是否正确，是否修改了错误的文件（比如把index.html改成了category_1.html）；
  • 重新核对代码参数：flag是否为top、引号是否为英文半角、分类ID是否正确；
  • 再次执行清空缓存，硬刷新前端页面（按Ctrl+F5）查看。

细节优化与扩展

若需要调整置顶内容的样式，可直接在模板文件中修改对应标签的CSS类（如.title的字体大小、颜色），或在后台主题设置中调整全局样式，不影响标签调用逻辑；若需实现置顶内容的不同排序，可在{sdk:lists}中加入order参数，order='desc'为按置顶时间倒序，order='asc'为正序，按需选择即可。