图片公益
您的位置:>> 媒塔CMS V3.0首页 > 功能更新 > 正文 >

动态模板模块 v2.0 —— 全面接入列表页标签体系,静态页一键生成

2026-10-30 来源:未知 繁体  复制 访问:加载中...  

系统模板升级公告:动态模板模块 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)"完全一致,参数含义也一样。会写列表页模板,就会写系统模板。

典型用法:建一个网站地图

  1. 后台 → 系统模板管理 → 添加模板
  2. 文件路径填:/map/sitemap.html
  3. 模板内容填(见下方代码块)
  4. 保存
<!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 等静态后缀会正常渲染。

典型用法:写一篇模板标签教程

  1. 添加模板,文件路径:/tutorial/tags.html
  2. 勾选"保留标签不解析"
  3. 模板内容里写(见下方代码块)
  4. 保存 → 打开 /tutorial/tags.html,看到的就是标签原文,教程效果完美。
<h2>如何使用导航标签</h2>
<p>在模板内容中输入:</p>
<pre>[n:map={1,500,0,1,1}]
  &lt;li&gt;&lt;a href="{$[classurl]}"&gt;{$[classname]}&lt;/a&gt;&lt;/li&gt;
[/n:map]</pre>

注意:教程模式是"全局开关"——勾选后所有标签都不渲染。如果你需要"一部分标签渲染、一部分标签展示",可以在渲染完成后手动把需要展示的标签用 HTML 实体(&lt; &gt;)转义后再写入,或分两个文件处理。

三、升级带来的实际收益

对站长/运营:维护成本大幅降低

以前做一个网站地图:需要进数据库抄栏目、手写 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:静态页基本功能

  1. 后台 → 系统模板管理 → 添加模板
  2. 文件路径:/test/hello.html
  3. 内容:<h1>Hello</h1>
  4. 不勾选"保留标签"
  5. 保存 → 访问 /test/hello.html,看到 "Hello"

测试 2:导航标签渲染

  1. 文件路径:/test/map.html
  2. 内容:[n:map={1,100,0,1,1}]<a href="{$[classurl]}">{$[classname]}</a>[/n:map]
  3. 保存 → 访问 /test/map.html,看到真实的栏目链接列表

测试 3:教程模式

  1. 文件路径:/test/tutorial.html
  2. 内容:[n:map={1,100,0,1,1}]...[/n:map]
  3. 勾选"保留标签不解析"
  4. 保存 → 访问 /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] + 配套变量)

  本网声明:媒塔CMS V3.0发布此文仅出于信息分享,并非赞同其观点或证实其描述,不承担侵权行为的连带责任。文章内容仅供参考,不构成投资建议。投资者据此操作,风险自担。版权归原作者所有,如涉版权或来源标注有误,请联系我们删除。本网原创内容未经书面授权,任何单位或个人不得转载和摘编。

[ 编辑: NO 26 ]

网站首页 - 关于我们 - 服务条款 - 合作咨询 - 联系我们 - 网站地图 - 法律声明 - 合作伙伴 - 公益活动 - 网站帮助 - 返回顶部

本网所刊载信息,不代表本网观点。刊用本网稿件,务必书面授权。

欢迎您访问媒塔CMS V3.0,如需合作,在线QQ:3322129830

未经书面授权禁止复制或建立镜像,违者必究。

媒塔CMS V3.0  版权所有