海洋 CMS 如何配置网站推荐影片模块

结论：海洋 CMS 的"推荐影片"不是后台一个开关就完事，而是两步——先在「影片管理」里把影片标记为"推荐"，再在模板首页文件里用推荐标签把带标记的影片读出来。只做第一步，前台什么都不显示；只改模板不标数据，列表永远是空的。

海洋CMS推荐影片模块的工作原理是什么

结论：推荐影片就是数据库里给影片打的一个标记字段，模板再按这个标记去筛选记录。

海洋 CMS 把每部影片的基本信息都存在影片表里，其中有一个"是否推荐"的字段。后台勾选推荐，改的是这个字段的值；前台模板里的标签，读的是这个字段。所以"配置推荐模块"的本质是：让被标记的影片能被模板取出来并按你想要的顺序、数量渲染。

想清楚这一点，后面所有报错都好排查——前台不显示，要么是没标记，要么是模板没读对。

第一步：在海洋CMS后台把影片标记成"推荐"

结论：批量勾选比一部一部改快得多，20 部以上的推荐位一律走批量操作。

具体步骤：

1. 登录后台，进入「影片管理 → 影片列表」；
2. 用顶部的分类筛选或关键词搜索，把候选影片筛出来；
3. 勾选每行左侧的复选框（表头那个框可以全选当前页）；
4. 拉到列表底部（部分版本在顶部）的批量操作下拉框，选择"推荐"或"设为推荐"，点执行；
5. 只想改一部时，点该影片右侧的「编辑」，在基本信息里找到"推荐"下拉，选"推荐"后保存。

注意两点：一是列表默认分页，每页 20 条左右，跨页的影片要翻页后再勾选；二是影片状态必须是"已审核/显示"，状态为隐藏的影片即使标了推荐，前台也不会出现。

第二步：模板里怎么调用推荐影片

结论：在首页模板里插入 {seacms:list} 标签，用 typeid 控制分类、num 控制条数、order 控制排序。

模板文件在 /template/你的模板目录/index.html，启用的是哪套模板可以在后台「模板管理」里看到。典型写法：

{seacms:list typeid=0 num=8 order=commend}
<a href="[list:link]">
  <img src="[list:pic]" alt="[list:title]">
  <p>[list:title]</p>
</a>
{/seacms:list}

typeid=0 表示不限分类，全站取；num=8 是取 8 条；[list:xxx] 是循环体里的字段，常用的有 title、link、pic（封面图）、actor、score。改完模板，回后台点一次「更新缓存」，否则前台还是旧页面。

排序参数的写法各版本略有差异：有的版本推荐排序写成 order=commend，如果前台报参数错误或列表为空，把 order 换成 recommend，或者先删掉 order 参数跑一次，能出来影片说明标签本身没问题，只是排序关键字不对。最稳的核对方式是打开后台的模板标签说明页，或直接看你模板目录里已有的 index.html 是怎么写的，照抄它的参数格式。

前台不显示推荐影片，先查这5个地方

结论：90% 的"配置了没效果"都是缓存和状态问题，不是标签写错。

按顺序排查：

1. 影片状态是否为已审核、未隐藏；
2. 后台是否点过「更新缓存」；
3. 你改的模板文件，是不是后台当前启用的那套模板；
4. 首页如果开启了 HTML 静态生成，要重新生成一次首页；
5. 标签的 num 是否写成了 0，或 typeid 指到了一个没有推荐影片的分类。

另外，如果推荐影片只在首页显示、分类页不显示，这是正常的：{seacms:list} 是首页/自定义页用的，分类页通常在分类模板里另有标签。

推荐位放几部、图片做多大合适

结论：首页推荐位取 6、8、12 条，图片统一竖版 200×280，是最省事的组合。

6/8/12 都是 3 的倍数，用三列或四列栅格排版不会出现半行留白。封面统一成竖版 200×280（或 240×320）能避免列表高度参差；做横向轮播就用 300×200。数量上限建议不超过 12 条——首屏之外的推荐位点击率会明显下滑，把位置留给"最新更新"更划算。

总结一下：后台「影片列表」勾选 → 批量设为推荐，是数据来源；首页模板 {seacms:list} 加 num、order 参数，是展示出口；改完必点「更新缓存」，是让改动生效的最后一步。三件事都做完，推荐模块就通了。