emandiev / autop-twig-filter
Craft CMS 插件。添加了一个 Twig 过滤器,用于去除 HTML 并将新行转换为段落。
1.0.0
2020-01-26 17:25 UTC
Requires
- craftcms/cms: ^3.0.0
This package is auto-updated.
Last update: 2024-09-28 14:58:42 UTC
README
一个去除 HTML 并将换行符转换为段落的 Twig 过滤器。
当您想使用纯文本字段生成 <p>
和 <br>
标签时很有用。
要求
此插件需要 Craft CMS 3.0.0 或更高版本。
安装
要安装插件,请按照以下说明操作。
- 打开您的终端并进入您的 Craft 项目
cd /path/to/project
- 然后告诉 Composer 加载插件
composer require emandiev/autop-twig-filter
- 在控制面板中,转到设置 → 插件,并点击 autop Twig Filter 的“安装”按钮。
使用 autop Twig Filter
您可以使用无参数的 autop
过滤器,如下所示
{{ entry.plainText|autop }}
过滤器将从连续的新行创建 <p>
标签,并且(默认情况下)从单个新行创建 <br>
标签。
可选参数 $br
允许您禁用 <br>
标签的创建。
{{ entry.plainText|autop(false) }}
如果需要,该插件还会注册一个 Twig 函数。
{% set formattedText = autop(entry.plainText) %}
配置 autop Twig Filter
您可以在 Craft 的 config
文件夹中创建一个名为 autop-twig-filter.php
的文件,以更改默认参数值。
例如,您可以通过以下方式全局禁用默认的 <br>
标签创建
<?php
return [
'br' => false,
];
{{ entry.plainText|autop }} // 不会生成 <br> 标签
致谢
由 Danail Emandiev 提供