networkteam/neos-mailobfuscator

A email address and link obfuscation plugin for Neos CMS

3.3.1 2024-08-13 09:31 UTC

README

In order to make life for spammers more difficult, this package provides an obfuscation of email addresses. The email address is obfuscated by a rot13 like algorithm with random offsets.

When the link is clicked, the email address is unobfuscated by the same algorithm in JavaScript:

<a href="mailto:foo@example.com">foo@example.com</a>

will become

<a href="javascript:linkTo_UnCryptMailto('obfuscatedEmail', -randomNumber)">foo (at) example.com</a>

The replacement is done in 2 steps, thus it is possible to have a link label that is different from the email address:

<a href="mailto:foo@example.com">Contact us</a>

will become

<a href="javascript:linkTo_UnCryptMailto('obfuscatedEmail', -randomNumber)">Contact us</a>

Installation

Install the composer package in your site package or distribution:

$ composer require networkteam/neos-mailobfuscator

There is no need for configuration, as a Fusion processor is attached to body of Neos.Neos:Page. That means, that the complete content of body tag is obfuscated.

Compatibility

See the following table for the correct plugin version to choose:

Configuration

Obfuscation can be disabled for specific node types by unsetting the processor:

prototype(Neos.Neos:Page) {
    @process.networkteamNeosMailObfuscator >
}

The JavaScript include can be disabled for custom minification:

prototype(Neos.Neos:Page) {
    networkteamNeosMailObfuscator >
}

The replacement string for the at-sign (@) can be configured. It will be inserted as HTML without escaping, so it's possible to replace it with something like an image:

# Settings.yaml
Networkteam:
  Neos:
    MailObfuscator:
      atCharReplacementString: '<img src="https://example.com/at-icon.png" alt="at" />'

EEL Helpers

There are Eel helpers available to use MailObfuscator functions in Fusion

// Convert @ Character
${Networkteam.Neos.MailObfuscator.convertAtChar('foo@example.com')}
// returns: foo (at) example.com

// Convert Mail to Href
${Networkteam.Neos.MailObfuscator.convertMailto2Href('foo@example.com')}
// returns javascript:linkTo_UnCryptMailto('obfuscatedEmail', -randomNumber)

Acknowledgments

Original email address obfuscation code by TYPO3 CMS.

Development sponsored by networkteam GmbH - Neos Agentur.

License

Licensed under GPLv2+, see LICENSE.