苹果CMS推荐内容标签调用教程：新手也能快速搞定首页/专题页个性化推荐位

不少用苹果CMS搭建影视站、资源站的新手，都会卡在推荐位配置这一步：要么调用的内容不符合预期，要么推荐位迟迟不更新，甚至拉取内容为空直接影响站点观感。今天就给大家拆解从基础语法到高频场景的全流程实操，不用精通PHP代码，照搬模板就能快速实现不同页面的个性化推荐效果，还能适配搜索引擎收录规则，提升站点内容曝光率。

苹果CMS推荐内容标签调用基础语法说明

搞懂基础语法是搞定苹果CMS推荐内容标签调用的第一步，哪怕你完全没接触过二次开发，记牢几个核心参数就能覆盖90%的常用场景。目前主流的苹果CMS V10版本，推荐内容统一用{maccms:list}作为标签开头，{/maccms:list}作为闭合标签，中间写内容展示的HTML结构即可。

给大家放一个最基础的调用示例，是调用全分类下最新更新的10条置顶内容：

``` {maccms:list num="10" order="time desc" type="all" flag="top"}

{$vo.name}

{/maccms:list} ```

其中几个核心参数很好记：num代表调用内容的数量，order代表排序规则，type代表要调用的分类ID，flag代表内容标识，常用的有top（置顶）、hot（热门）、recommend（推荐）三种。如果是图片类推荐位，一定要加pic="1"参数过滤无封面内容，避免出现空白图影响用户体验。

3个高频使用的调用场景模板

下面这3个高频场景的苹果CMS推荐内容标签调用模板，大家可以直接复制到自己的模板文件里修改参数即可。

首页轮播推荐位调用

首页轮播一般要展示高清封面、高热度的置顶内容，排序可以按评分从高到低，只调用近30天内更新的内容，避免老内容占着轮播位影响新鲜感：

``` {maccms:list num="5" order="score desc" type="all" flag="top" time="30" pic="1"} {/maccms:list} ```

这里的time="30"就是限定只调取30天内更新的内容，大家可以根据自己站点的更新频率调整参数。

详情页相关推荐调用

详情页的相关推荐要尽量和当前内容的分类匹配，还要排除当前正在查看的内容，避免出现重复推荐的尴尬情况：

``` {maccms:list num="8" order="hits desc" type="$info.type_id" id="!$info.id" pic="1"} {/maccms:list} ```

其中type="$info.type_id"就是自动匹配当前内容的分类，id="!$info.id"就是排除当前内容的ID，推荐的精准度会高很多。

移动端热门推荐调用

移动端屏幕空间有限，推荐内容要少而精，优先调取近7天点击量最高的热门内容，不用放太多冗余信息：

``` {maccms:list num="6" order="hits desc" type="all" time="7" flag="hot"} {/maccms:list} ```

调用时容易踩的2个常见坑

很多新手改完标签发现前台没变化，大概率是踩了这两个坑：第一个是参数拼写错误，比如把num写成number，把flag写成flog，参数写错自然拉不到想要的内容；第二个是缓存没清理，苹果CMS默认会开启页面缓存，修改完调用标签后一定要先清空全站静态缓存再预览效果。

大家调试苹果CMS推荐内容标签调用的时候，可以先在后台开启调试模式，就能看到标签拉取的原始数据，快速定位问题出在参数还是缓存，不用反复改代码瞎试。

我自己折腾过七八个苹果CMS的站点，最深的感受就是推荐位是站点留客的核心入口，不用盲目跟风别人的调用规则，结合自己的用户画像调整筛选条件，比如做动漫站就优先调更新时间近的，做老电影站就优先调评分高的，反而能拿到更好的留存和转化，比瞎优化SEO关键词有用多了。