海洋 CMS 模板开发需要掌握哪些基础代码

结论：海洋CMS（SeaCMS，一套 PHP + MySQL 的影视/资讯建站系统）模板开发需要掌握的基础代码只有四类——模板标签 {seacms:xxx}、字段变量 [field:xxx]、条件与循环控制、以及模板文件的目录与引入规则。四类吃透之后，剩下的工作就是把它们按页面类型排列组合。

海洋CMS 模板文件放在哪个目录，命名有什么规则？

结论：模板放在 /template/模板名/ 目录下，页面文件用 .html 后缀，靠文件名对应前台页面类型。

典型的一套模板至少包含这几个文件：index.html（首页）、list.html（栏目列表页）、show.html 或 detail.html（内容详情页）、play.html（影视播放页）、search.html（搜索结果页）。公共片段拆成 head.html、foot.html、left.html 等，用引入标签拼装。

后台「模板管理」里可以切换当前启用模板、在线编辑模板文件，也可以直接写模板配置让用户在后台改颜色、改栏目。改模板前先复制一份原模板目录改名备份，这是唯一不会后悔的操作。

{seacms:xxx} 标签的语法结构是怎样的？

结论：海洋CMS 标签统一写成 {seacms:标签名 参数="值"}...{/seacms:标签名} 的成对形式，参数写在标签名后面，多个参数用空格分隔。

数据类标签都靠参数取数，常见参数包括：type（栏目 ID）、num（取几条）、order（排序字段）、start（从第几条开始）、time（时间范围）、letter（首字母）。例如取某栏目最新 10 条就是「栏目 ID + 条数 + 排序」三个参数的组合。

标签名本身决定取哪张表的数据：影视、文章、专题、友情链接、分类、地区、年份、字母索引各有各的标签。**注意：不同大版本的海洋CMS标签名和参数有差异，务必以你所装版本后台的「模板标签说明」页为准**，照搬网上旧教程的参数是最常见的报错来源。

列表标签内部怎么输出字段？

结论：在成对标签的内部，用 [field:字段名] 输出当前这条记录的字段值。

写法和用法的关键有三点：

1. [field:xxx] 只在对应的成对标签内部生效，写到标签外面不解析。
2. 字段名对应数据库表字段，影视类常见的有 ID、标题、缩略图、主演、导演、年份、地区、评分、更新时间、播放地址等；具体字段以标签说明页列出的为准。
3. 图片、链接这类字段需要自己补 HTML 结构，比如把缩略图字段塞进 <img src="...">，再把标题字段塞进 <a href="...">。

条件判断和循环怎么写？

结论：条件用 {seacms:if 条件}...{seacms:else}...{/seacms:if}，循环用 {seacms:loop} 系列标签，二者语法风格与常见模板引擎接近。

条件判断最实用的场景是「有缩略图才显示图片、没缩略图显示占位图」和「第一条加特殊样式」，能省掉大量重复 HTML。循环用于输出年份、地区、字母筛选栏这类固定集合。

分页输出用分页标签（不同版本写作 {seacms:page} 或 {$page}），它只写在列表页和搜索页，写进详情页不会有输出。

全局变量和站点信息怎么调用？

结论：站点名称、网址、模板路径、当前栏目等站点级信息，用全局标签直接输出，不需要传参数。

这类标签的作用是让模板不写死文字——换域名、换站名时只改后台设置，模板文件一行都不用动。头部导航、底部版权、搜索框这些跨页面重复的内容，建议全部收进 head.html 和 foot.html，再用引入标签 {seacms:load 文件名.html} 引用，改一处全局生效。

改海洋CMS 模板最容易踩的坑是什么？

结论：90% 的"模板不生效"来自三件事——标签没成对闭合、[field:xxx] 写到了标签外、以及缓存没清。

排查顺序建议固定下来：先确认后台「模板管理」里启用的确实是你改的那个模板目录；再检查标签是否成对、参数引号是否配对；然后清一次系统缓存；最后才怀疑字段名写错。开启 PHP 错误提示能看到具体报错行号，比反复刷新猜测快得多。

把上面这些串起来：**目录结构决定文件放哪儿，{seacms:xxx} 决定取什么数据，[field:xxx] 决定输出什么内容，if/loop 决定怎么排版，全局标签和引入标签决定怎么复用。** 这五件事会了，任何一套海洋CMS 模板你都能拆开改。