系统模板升级公告:动态模板模块 v2.0 —— 接入列表页导航标签,静态页一键生成
发布日期:2026-10-30
适用模块:系统模板管理(dynamic_templates)
升级类型:功能增强 + 安全加固(向后兼容,无需改动现有模板)
一、这次升级解决了什么问题?
过去,系统模板管理只能"存文件"——你在后台录入一段 HTML/PHP 内容,它就原样写到指定路径。对于纯静态页面(比如"关于我们"、"联系方式")足够用,但当你想做一个网站地图时,就不得不手动去数据库里把栏目名、栏目链接一个个抄出来,写死在模板里。
栏目一增删,页面就得重写一遍。维护成本高,还容易出错。
这次 v2.0 升级,让"系统模板"真正具备了动态渲染能力:
- 在模板内容里写
list_generator.php支持的导航标签([n:map],以及配套的{$[classurl]}、{$[classname]}变量),保存时自动从数据库读取数据并渲染成 HTML; - 一个"网站地图"模板,5 秒建好,栏目变更后再点一次"保存"就同步更新;
- 同时完整保留原有的"教程/说明文档"制作能力——标签可以原样保留,用于写帮助文档、模板标签说明书。
一句话:同一套模板系统,既能生成动态数据页,也能写教程文档,还能存 PHP 动态脚本。
二、新增的三大能力
能力 1:接入 list_generator.php 导航标签体系(核心)
在"添加模板/编辑模板"的模板内容里,可以直接使用 list_generator.php 提供的导航标签。这意味着系统模板和"栏目列表页"共享同一套标签语法,你在列表页里能用的导航标签,在这里都能用。
导航标签(成对出现,[n:map={参数}]...[/n:map])
| 标签 | 作用 | 典型场景 |
|---|---|---|
[n:map] |
输出栏目导航(全站地图、顶级栏目、子栏目) | 网站地图 |
配套变量标签(在区块内使用)
| 标签 | 作用 |
|---|---|
{$[classurl]} |
栏目链接 |
{$[classname]} |
栏目名称 |
说明:以上标签与你现有的"栏目列表页(generate_list.php)"完全一致,参数含义也一样。会写列表页模板,就会写系统模板。
典型用法:建一个网站地图
- 后台 → 系统模板管理 → 添加模板
- 文件路径填:
/map/sitemap.html - 模板内容填(见下方代码块)
- 保存
<!DOCTYPE html>
<html lang="zh-CN">
<head>
<meta charset="utf-8">
<title>网站地图</title>
<style>
body{font-family:"Microsoft YaHei",Arial,sans-serif;max-width:1000px;margin:40px auto;padding:0 20px;}
ul.sitemap{list-style:none;padding:0;display:flex;flex-wrap:wrap;gap:10px 30px;}
ul.sitemap li a{color:#4285f4;text-decoration:none;}
</style>
</head>
<body>
<h1>网站地图</h1>
<ul class="sitemap">
[n:map={1,500,0,1,1}]
<li><a href="{$[classurl]}">{$[classname]}</a></li>
[/n:map]
</ul>
</body>
</html>
结果:/map/sitemap.html 立刻生成,里面是真实的栏目链接列表,不是 [n:map=...] 原文。栏目增删后,回到后台点一次"保存"即可刷新。
能力 2:静态/动态双模式(按后缀自动判断)
系统根据文件后缀自动决定处理方式:
| 文件后缀 | 处理方式 | 适用场景 |
|---|---|---|
.html / .htm / .shtml / .shtm / .xhtml |
保存时渲染全部标签,写入最终 HTML | 静态导航页、网站地图 |
.php / .txt / .md / 其他 |
原样保存,不渲染 | 动态 PHP 页、说明文档、配置片段 |
举例:
/map/sitemap.html→ 保存时渲染成静态 HTML(秒开,SEO 友好,不占用 PHP 资源)/map/sitemap.php→ 原样保存,你可以自己在 PHP 里写<?php ... ?>逻辑,运行时动态输出
一个模板,两种用法,按需选择。
能力 3:教程文档模式(保留标签不解析)
写帮助文档时,你需要在页面上展示 [n:map=...]、{$[classname]} 这样的标签语法给用户看,而不是把它们渲染掉。
为此新增了"保留标签不解析(教程/说明文档专用)"复选框:
- 勾选后,不论什么后缀,所有标签全部原样保存,一个字符都不动;
- 不勾选(默认),
.html等静态后缀会正常渲染。
典型用法:写一篇模板标签教程
- 添加模板,文件路径:
/tutorial/tags.html - 勾选"保留标签不解析"
- 模板内容里写(见下方代码块)
- 保存 → 打开
/tutorial/tags.html,看到的就是标签原文,教程效果完美。
<h2>如何使用导航标签</h2>
<p>在模板内容中输入:</p>
<pre>[n:map={1,500,0,1,1}]
<li><a href="{$[classurl]}">{$[classname]}</a></li>
[/n:map]</pre>
注意:教程模式是"全局开关"——勾选后所有标签都不渲染。如果你需要"一部分标签渲染、一部分标签展示",可以在渲染完成后手动把需要展示的标签用 HTML 实体(< >)转义后再写入,或分两个文件处理。
三、升级带来的实际收益
对站长/运营:维护成本大幅降低
以前做一个网站地图:需要进数据库抄栏目、手写 HTML、每次栏目变更都重来。
现在:写一次模板,以后栏目变更只需点一次"保存"。从 30 分钟缩短到 5 秒。
对开发者:同一套系统覆盖三种场景
- 静态导航页 / 网站地图 →
.html+ 不勾选 - 动态 PHP 页 →
.php+ 不勾选 - 模板教程文档 → 任意后缀 + 勾选
不需要装两套系统,不需要切换工具。
对 SEO:静态页面秒开
.html 生成的是纯静态文件,不经过 PHP 解析,首字节时间(TTFB)比动态页低一个数量级。对搜索引擎爬虫友好,对服务器压力小。
四、七条写路径全部安全(重点)
模板文件的"写入"有 7 个入口,本次升级确保每一条都尊重"保留标签"设置,不会误渲染教程文件:
| # | 操作 | 行为 |
|---|---|---|
| 1 | 添加模板 | 按勾选状态处理 |
| 2 | 编辑模板 | 按勾选状态处理 |
| 3 | 列表"保存"按钮 | 按数据库里存的勾选状态处理 |
| 4 | 列表"加载"按钮(从文件读回数据库) | 只写数据库,不反向覆盖文件 |
| 5 | 历史记录"还原此版本" | 同上,只写库 |
| 6 | 列表"复制"按钮 | 副本继承原模板的勾选状态 |
| 7 | "刷新文件" | 按数据库里的勾选状态处理 |
一句话:教程文件在任何操作下都不会被意外渲染破坏。
五、升级还顺手修了几个"历史遗留问题"
1. 导出模板现在能导出全部
以前"导出模板"只导出第一页 10 条(分页 bug)。现在导出全部,导出的 JSON 带 keep_raw_tags 字段,导入时一并还原。
2. 导入模板后物理文件真实生成
以前导入只写数据库,磁盘上没有文件。现在导入时会真实落盘,且尊重"保留标签"设置。
3. 编辑时改路径自动清理旧文件
编辑模板时如果修改了文件路径(例如从 /map/index.html 改成 /map2/index.html),保存后旧路径对应的文件会自动删除,无需登录服务器手动清理。编辑界面的文件路径标签旁有红色提示,显示当前旧路径,避免误改。
4. 删除模板更安全
删除模板时先删物理文件再删数据库记录,全部包在事务里。文件删不掉(权限等)不会阻断数据库删除,只记日志。
六、升级须知(务必阅读)
1. 数据库需要执行一条 SQL
本次新增了 keep_raw_tags 字段,请先执行:
ALTER TABLE `你的前缀_dynamic_templates` ADD COLUMN `keep_raw_tags` TINYINT(1) NOT NULL DEFAULT 0 COMMENT '是否保留标签不解析(教程专用)' AFTER `is_system`;
不执行会怎样:新增/编辑模板时报 Unknown column 'keep_raw_tags'。务必先执行。
2. 确认 list_generator.php 已就位
标签渲染依赖 list_generator.php(列表页模块的核心库)。确认它与 dynamic_templates.php 在同一目录。
如果不在同目录,修改 dynamic_templates.php 顶部的:
$listGenPath = __DIR__ . '/list_generator.php';
改为实际路径。
3. 确认模型标识
$GLOBALS['__CG_DEFAULT_TITLEID'] = 'news';
如果你的栏目表是 {DB_PREFIX}news_class,保持 'news' 不变。若是 article_class 等,改成对应标识。
改错的后果:所有 [n:map] 标签查不到数据,生成的页面是空列表(不报错,但结果是空的)。升级后请先建一个测试模板验证。
4. 编辑模板改路径时会自动删除旧文件
如果编辑模板时改了文件路径(例如从 /map/index.html 改成 /map2/index.html),旧文件会被自动删除,无需登录服务器手动清理。
编辑界面的文件路径标签旁会有红色提示,显示当前旧路径,避免误改。
如果只是改内容不改路径,旧文件会被新内容覆盖,不会删除。
七、快速上手(3 步)
第 1 步:执行 SQL 加字段
(见上文"升级须知 1")
第 2 步:上传新的 dynamic_templates.php
覆盖原文件。
第 3 步:验证
测试 1:静态页基本功能
- 后台 → 系统模板管理 → 添加模板
- 文件路径:
/test/hello.html - 内容:
<h1>Hello</h1> - 不勾选"保留标签"
- 保存 → 访问
/test/hello.html,看到 "Hello"
测试 2:导航标签渲染
- 文件路径:
/test/map.html - 内容:
[n:map={1,100,0,1,1}]<a href="{$[classurl]}">{$[classname]}</a>[/n:map] - 保存 → 访问
/test/map.html,看到真实的栏目链接列表
测试 3:教程模式
- 文件路径:
/test/tutorial.html - 内容:
[n:map={1,100,0,1,1}]...[/n:map] - 勾选"保留标签不解析"
- 保存 → 访问
/test/tutorial.html,看到标签原文而非渲染结果
三项验证通过,升级完成。
八、向后兼容性说明
| 现有使用方式 | 升级后 |
|---|---|
存纯 PHP 文件(.php) |
原样保存,完全不受影响 |
存纯 HTML 静态页(.html,无标签) |
没有标签可渲染,输出与原来一致 |
存纯文本说明(.txt/.md) |
原样保存,不受影响 |
| 导入旧版导出的 JSON | keep_raw_tags 缺失时自动兜底为 0(按普通模板处理),不报错 |
| 已有的历史记录 | 全部保留,正常显示和还原 |
没有任何现有模板需要手动迁移,升级即用。
九、常见问题(FAQ)
Q:我以前的 .html 模板里有 [n:map] 标签,升级后会怎样?
A:如果文件后缀是 .html 且 keep_raw_tags=0(默认),下次点击"保存/刷新文件"时会被渲染。这通常是你想要的效果。如果你原来是把标签当作文本展示(教程用途),请编辑该模板,勾选"保留标签不解析"后保存,文件会恢复原样。建议升级前先扫一眼现有的 .html 模板,确认哪些是教程、哪些是静态页。
Q:list_generator.php 里的哪些导航标签能用?
A:本次升级接入的是导航标签,包括区块标签 [n:map],以及配套变量 {$[classurl]}、{$[classname]}。参数含义与列表页完全一致,会写列表页模板就会写系统模板。其他标签类型不在本次说明范围内。
Q:PHP 文件里的 [n:map] 标签会被渲染吗?
A:不会。.php 后缀永远原样保存。若你想在 PHP 里动态输出导航,需要自己在 PHP 代码里调用 process_custom_tags(),或在 PHP 里引入 list_generator.php。
Q:编辑时改路径,旧文件真的会被删吗?会不会误删别的文件?
A:只删这个模板原来的 file_path 对应的那一个文件,且删除前做了路径安全校验(必须位于网站根目录内、路径合法)。不会误删其他文件。删除失败(如权限问题)只记日志,不影响保存。
Q:我改路径时填错了,旧文件被删了怎么办?
A:历史记录里保存着模板内容,可以点"还原此版本"恢复数据库记录。但物理文件不会自动恢复——需要手动把路径改回正确值再点"保存"重新生成文件。
Q:能不能批量把一批 .html 教程文件改成"保留标签"?
A:可以。后台列表页有"批量删除模板",但目前没有批量改 keep_raw_tags。可以逐个编辑勾选,或者用 SQL 批量更新:
UPDATE `你的前缀_dynamic_templates` SET keep_raw_tags = 1 WHERE file_path LIKE '/tutorial/%';
Q:教程模式勾选后,是不是所有标签都不渲染?
A:是的。教程模式是全局开关,勾选后所有标签原样保留。如果你需要"一部分渲染、一部分展示",建议拆成两个模板文件,或渲染后手动把需要展示的标签转义。
十、结语
这次 v2.0 升级的核心思路是:把"模板文件"从"静态文本容器"升级为"能读懂系统数据的智能模板"——接入 list_generator.php 的导航标签体系,让系统模板也能一键生成动态导航页。
- 站长不必再手抄栏目;
- 开发者不必再装第二套系统;
- 写教程的人不必再和渲染逻辑打架。
一套标签体系,三种使用场景,向后兼容,即刻可用。
感谢各位长期以来的反馈与建议。如果在使用中遇到问题,或希望增加新的标签类型,欢迎随时反馈。
系统模板管理模块 v2.0
发布日期:2026-10-30
升级包:dynamic_templates.php(单文件覆盖)
数据库变更:keep_raw_tags 字段(1 条 ALTER)
标签支持范围:list_generator.php 导航标签([n:map] + 配套变量)

