CMS二次开发入门，模板标签基础教程：CMS二次开发入门
CMS 二次开发入门时，模板标签是最先要跨过的一道门槛。简单说，模板标签就是 CMS 留给模板作者的一套“占位符语法”，你写出类似 `{dede:arclist}`、`{php}` 或 `{{ $article.title }}` 的标记，CMS 在生成页面时会把它们替换成数据库里的真实内容。学会它，你就能在不改核心代码的前提下，控制列表、详情页、导航和自定义字段的显示方式。
## 先分清你用的是哪类标签体系
不同 CMS 的模板标签写法差异很大，动手前必须先确认版本和语法风格，否则照抄别人的代码一定报错。
- **标签解析型 CMS**：模板里写自定义标签，例如 `{dede:arclist}`、`{pc:content}`，由 CMS 内置解析器替换。
- **模板引擎型 CMS**：模板里写类似 `{$title}`、`{{ $article.title }}` 的变量语法，依赖 ThinkPHP、Twig 等模板引擎。
- **混合型**：既有自定义标签，又允许嵌入原生 PHP，例如 `{php}...{/php}`。
确认方法很直接：打开 CMS 安装目录下的模板文件夹，随便看一个 `.htm` 或 `.html` 文件，如果里面是 `{xxx:yyy}` 形式，就是标签解析型；如果是 `{$xxx}` 或 `{{ xxx }}`，就是模板引擎型。这一步判断错了，后面所有调试都会白费。
## 准备一个可以安全试错的模板环境
新手最容易犯的错，是直接在正式站上改模板。建议先在测试环境操作。
1. 备份当前模板目录，例如在宝塔面板进入“文件”，找到网站根目录，把 `templets` 或 `template` 文件夹压缩一份。
2. 复制一套默认模板，改名为 `test`，在后台“模板管理”里把测试模板设为当前模板。
3. 准备一个测试栏目和两三条测试内容，标题、缩略图、自定义字段都填上，方便验证标签是否取到数据。
如果是用宝塔搭建的站点，模板路径通常在 `/www/wwwroot/你的域名/templets/` 或 `/www/wwwroot/你的域名/template/`，后台一般在“系统”或“界面”菜单里切换模板。
## 从最短的标签开始理解取数逻辑
不要一上来就抄复杂的列表标签，先用单条内容标签跑通链路。以常见标签解析型 CMS 为例，在模板里写：
```html
{dede:field.title/}
```
保存后刷新页面，如果标题正常输出，说明模板解析和字段名都对。如果输出空白，按顺序检查：
- 字段名是否写错，比如把 `title` 写成 `titles`；
- 当前模板是否被正确指定给这个栏目；
- CMS 后台是否开启了模板缓存，改完模板需要在后台“更新缓存”或“生成更新”。
这里的关键结论是：**模板标签调试要遵循“单标签先通、再拼列表、最后加条件”的顺序**，一次改太多，报错时很难定位。
## 列表标签是二次开发的主战场
大部分二次开发需求，本质都是控制列表怎么取、取几条、按什么排序、显示哪些字段。典型写法如下：
```html
{dede:arclist typeid='1' row='5' orderby='pubdate'}
[field:title/]
{/dede:arclist}
```
几个参数要重点理解：
- `typeid` 指定栏目 ID，留空或写 `top` 表示按当前栏目取；
- `row` 控制输出条数，写太多会拖慢页面；
- `orderby` 决定排序字段，常见有 `pubdate`、`click`、`id`；
- `[field:xxx/]` 是字段调用，字段名必须和数据库字段对应。
改完后不要只看首页，要分别检查栏目页、内容页和搜索页，因为同一段标签在不同页面里取到的上下文可能不同。**列表标签的 typeid 和 row 是性能与效果的两个关键参数**，线上环境建议 row 不要盲目调大。
## 避坑指南：新手最常踩的几类问题
- **标签不解析，直接显示原文**：多半是模板文件后缀不对，或者 CMS 没开启该目录的模板解析。
- **页面报语法错误**：检查标签是否成对闭合，例如 `{dede:arclist}` 必须有 `{/dede:arclist}`。
- **改了没变化**：优先清缓存、更新模板、重新生成静态页，不要反复改代码。
- **后台能看，前台空白**：确认栏目是否有内容、是否有权限、是否被筛选条件过滤掉。
- **直接嵌 PHP 导致安全风险**：能不用 `{php}` 就不用，二次开发尽量走官方标签和模板引擎语法。
## 验证标签是否真正生效
每次改完模板，按这个清单走一遍：
1. 前台刷新对应页面，确认内容数量和排序符合预期；
2. 查看页面源代码，确认输出的是真实数据而不是标签原文；
3. 换一个栏目或换一条内容，确认不是写死了某条数据；
4. 在后台更新缓存或重新生成后，再刷新一次，确认结果稳定。
如果这四步都通过，说明这段模板标签已经可以进入二次开发的下一个阶段，比如加条件判断、调用自定义字段或做分页。
## 常见疑问
**模板标签和 HTML 有什么区别？**
HTML 决定页面结构和样式，模板标签负责把数据库内容填进 HTML。二次开发通常是在 HTML 骨架里插入标签。
**为什么同一个标签在首页正常，在内容页不正常？**
因为不同页面可用的上下文变量不同，内容页里当前文档 ID 是明确的，首页则往往需要显式指定栏目或排序条件。
**改模板标签需要懂数据库吗？**
入门阶段不需要写 SQL，但要能看懂字段名，知道 `title`、`pubdate`、`typeid` 这类字段大概对应什么内容。
**标签调用会不会影响网站速度？**
会。列表标签条数过多、嵌套过深、排序字段没有索引时，都可能拖慢生成速度。建议先用小 row 值测试，再按实际需要调整。
