海洋 CMS 模板首页模块如何自定义调整

海洋CMS（SeaCMS，一套 PHP + MySQL 的影视/文章建站系统）首页模块的自定义调整，说到底只动一个文件：当前启用模板目录里的 index.html。模块的增删靠标签调用块，显示顺序靠 HTML 位置，调取条数与来源靠标签参数，改完清一次缓存就生效。

海洋CMS 首页模板是哪个文件？

结论：首页所有模块都写在 templets/当前模板目录/index.html 里。

后台「模板」→「模板管理」可以看到当前启用的模板目录名，例如 default、mix 这类。站点根目录下的 templets/ 文件夹里存放着各套模板，一套模板一个文件夹，首页文件固定叫 index.html，列表页、内容页则是 list.html、detail.html。改首页只碰 index.html 这一个文件。

编辑方式有两种：一是在后台模板管理里点开 index.html 在线编辑保存；二是用 FTP/SFTP 下载到本地改完再覆盖上传。做大改推荐第二种，本地编辑器有语法高亮和缩进，不容易漏掉标签闭合。

首页模块怎么增删、怎么调顺序？

结论：一个模块 = 一个 {seacms:...} 调用块 + 包住它的 HTML 结构；把 HTML 块整体剪切到别处就是换位置，整块删掉就是删除模块。

调顺序时，在 index.html 里找到对应块（注释或 class 名里带「最新更新」「热播推荐」字样），整段剪切到目标位置粘贴。注意标签在海洋CMS里是成对出现的，{seacms:videolist ...} 开头、{/seacms:videolist} 结尾，只搬一半会导致模板报错。

调数量和来源靠标签属性：num 控制调用条数，type 指定分类 ID（0 表示不限分类），order 控制排序（time 按时间、hits 按点击）。

{seacms:videolist num=12 type=1 order=time}
  <a href="[videolist:link]">[videolist:name]</a>
{/seacms:videolist}

把 num=12 改成 num=6，这个模块立刻从 12 条变 6 条；把 type=1 改成 type=5，调取来源就切到 ID 为 5 的分类，分类 ID 在后台分类管理里能直接看到。

最稳的改法是：复制模板里已经跑通的一个标签块，只改 num 和 type，不动结构。字段名（[videolist:name]、[videolist:link] 这类）以模板里现成写法为准，不要凭记忆手写。

改完模板为什么前台没变化？

结论：先查缓存，再查标签。

海洋CMS 会把模板标签编译成 PHP 缓存文件，模板改了而缓存还是旧的，前台自然显示老样子。按这个顺序排查：

1. 后台执行一次「清除缓存」，如果有「更新模板缓存」选项一并执行。
2. 浏览器按 Ctrl+F5 强制刷新，或者开无痕窗口再看。
3. 仍不生效，检查标签是否成对闭合、type 指向的分类 ID 是否存在、该模板是否被设为当前使用模板。
4. 还不行，把刚加的那块先注释掉，确认问题出在代码还是缓存。

改之前必须做哪一步？

结论：改 index.html 前先复制一份 index.html.bak，出问题直接改名覆盖回滚。

备份时把扩展名改掉，不要留 .html 后缀，避免被模板系统扫成一套可用模板。做较大改动前，把整个模板目录打包一份更保险。

总结一句：海洋CMS 首页模块自定义就是三件事——找对 templets/模板名/index.html、按块搬 HTML 并调 num/type/order 参数、改完清缓存。掌握这套逻辑，换模块顺序、改调用数量、加新分类入口都不需要动核心程序。