Neos MailObfuscator

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., _(*1)

When the link is clicked, the email address is unobfuscated by the same algorithm in JavaScript:, _(*2)

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

will become, _(*3)

<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:, _(*4)

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

will become, _(*5)

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

Installation

Install the composer package in your site package or distribution:, _(*6)

$ 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., _(*7)

Compatibility

See the following table for the correct plugin version to choose:, _(*8)

Neos CMS	Plugin version
>= 3.0	2.x
< 3.0	1.x

Configuration

Obfuscation can be disabled for specific node types by unsetting the processor:, _(*9)

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

The JavaScript include can be disabled for custom minification:, _(*10)

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:, _(*11)

# 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, _(*12)

// 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)