PbootCMS 增加换行格式化标签 br=1 的实现方法
在使用 PbootCMS 时，如果需要对多行文本字段的内容进行换行处理（如产品简介字段），可以通过二次开发增加一个自定义的换行格式化标签。以下是详细的操作步骤和代码说明。
一、功能概述
PbootCMS 默认的模板标签支持多种格式化方式（如 decode、date 等），但未直接提供换行处理功能。通过修改核心文件，可以新增一个 br=1 标签，用于将换行符 \n 转换为 HTML 的 <br> 标签，从而实现前台内容的换行显示。
二、实现步骤
1. 修改核心文件
文件路径：
\apps\home\controller\ParserController.php操作步骤：
-
打开
ParserController.php文件。 -
搜索以下代码：
case 'decode': -
在其下方新增以下代码：
case 'br': // 换行格式化标签 if ($params['br']) { $data = nl2br($data); } break;
参数说明：
case 'br'：新增的格式化标签名称。nl2br($data)：将字符串中的换行符\n转换为 HTML 的<br>标签。$params['br']：判断是否启用了br=1参数。
2. 使用新标签
完成上述修改后，您可以在模板中使用新增的 br=1 标签。例如：
[list:ext_jianjie br=1]示例效果：
假设后台字段内容为：
这是第一行
这是第二行
这是第三行前台输出结果为：
这是第一行<br>
这是第二行<br>
这是第三行三、注意事项
1. 备份核心文件
- 在修改
ParserController.php文件之前，请务必备份原始文件，以便在出现问题时快速恢复。
2. 兼容性
- 新增的
br=1标签与官方自带的格式化标签用法一致，可全局使用。 - 如果字段内容中已包含 HTML 标签（如
<p>或<br>），请确保不会重复处理。
3. 避免直接修改核心文件
- 直接修改核心文件可能会导致升级时被覆盖。如果条件允许，建议通过插件或钩子函数实现类似功能。
四、完整代码示例
以下是修改后的代码片段：
case 'decode':
$data = htmlspecialchars_decode($data);
break;
case 'br': // 换行格式化标签
if ($params['br']) {
$data = nl2br($data);
}
break;
更新时间：2025-12-06 17:53:59