emandiev/autop-twig-filter

Craft CMS 插件。添加了一个 Twig 过滤器,用于去除 HTML 并将新行转换为段落。

安装: 26

依赖: 0

建议者: 0

安全性: 0

星标: 2

关注者: 1

分支: 0

开放问题: 0

类型:craft-plugin

1.0.0 2020-01-26 17:25 UTC

This package is auto-updated.

Last update: 2024-09-28 14:58:42 UTC


README

一个去除 HTML 并将换行符转换为段落的 Twig 过滤器。

当您想使用纯文本字段生成 <p><br> 标签时很有用。

Example Usage

要求

此插件需要 Craft CMS 3.0.0 或更高版本。

安装

要安装插件,请按照以下说明操作。

  1. 打开您的终端并进入您的 Craft 项目

cd /path/to/project

  1. 然后告诉 Composer 加载插件

composer require emandiev/autop-twig-filter

  1. 在控制面板中,转到设置 → 插件,并点击 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 提供