README

混淆器

A Craft CMS 插件，该插件添加了一个 Twig 过滤器，用于使用 Hivelogic Enkoder 对电子邮件或其他内容进行混淆。

此插件使用 Standalone PHPEnkoder。

内容

• 使用方法
• 安装
• 需求
• 变更日志
• 许可

使用方法

以下Twig代码片段——

{% apply enkode_emails %}
    Reach us on me@example.com or
    <a href="mailto:anotherme@example.com">here</a>.
{% endapply %}

将在生成的HTML中，将纯文本电子邮件和mailto:锚标签都识别为电子邮件并混淆。结果将如下所示（重新格式化以提高可读性）

Reach us on

<span id="enkoder_1_2033799978">email hidden; JavaScript is required</span>
<script id="script_enkoder_1_2033799978" type="text/javascript"> /* <!-- */
function hivelogic_enkoder_1_2033799978() { … } hivelogic_enkoder_1_2033799978();
/* --> */ </script>

or

<span id="enkoder_0_1540754146">email hidden; JavaScript is required</span>
<script id="script_enkoder_0_1540754146" type="text/javascript"> /* <!-- */
function hivelogic_enkoder_0_1540754146() { … } hivelogic_enkoder_0_1540754146();
/* --> */ </script>.

除了enkode_emails过滤器之外，混淆器还附带了一系列额外的过滤器，用于更精确地指定要混淆的内容。

{{ 'Reach us on me@example.com or <a href="mailto:anotherme@example.com">here</a>.'|enkode_emails }}

{{ '<a href="mailto:me@example.com">Contact Us</a>'|enkode_mailtos }}

{{ 'Contact us at me@example.com.'|enkode_plaintext_emails }}

{{ 'I don’t want spam bots to read this.'|enkode }}

{{ 'If you don’t have JavaScript, you’ll see a helpful message.'|enkode('JavaScript is required to view this message.') }}

安装

您可以从插件商店或使用Composer安装此插件。

从插件商店

转到您项目的控制面板中的插件商店，搜索“混淆器”。然后在其模态窗口中点击“安装”按钮。

使用Composer

打开您的终端并运行以下命令

# go to the project directory
cd /path/to/project

# tell composer to use the plugin
composer require miranj/craft-obfuscator

# tell Craft to install the plugin
./craft plugin/install obfuscator

需求

此插件需要Craft CMS 3、4或5。Craft 2版本可在v0分支中找到：此处。

由Miranj提供