README

The Drupal Email Obfuscator Module uses a middleware get rendered content from each request. The content is searched for emails with regexes. The emails are obfuscated depending on where the text is found.

Obfuscations

Emails in a Mailto-Link

Example: <a href="mailto:test@email.com">

• The email string excluding mailto: is reversed
• An onfocus and an onmousedown are added which re-reverse the email after the mailto:. These two events cover the following cases: right-click, left-click and focus with tab. (onfocus would do it for most browsers, but Safari needs onmousedown.)

The re-reverse is only done once in order to avoid reversing back to the reversed email

All other Emails

Example: <a>test@email.com</a>

• A span with display:none containing a text with delimiters that are invalid email characters is added in the middle of the email

Exclusions

• Any email that is invalid (according to PHP's filter_var function)
• Everything in the backoffice (admin pages)
• Emails inside HTML-attributes (placeholder for input fields)
• Exclude Ajax webform request:
  • Because Ajax is usually used when sending a web form.
    This means that the request does not contain HTML, but a JSON object in which HTML is encoded with Unicode.
    The regex does not apply here and it is not necessary to obfuscate this email address as it is added by the sender.
• Content in routes that are whitelisted (see below)

Whitelisting Routes

• Define whitelisted (excluded) routes in settings.php

  $settings['email_obfuscator'] = [
    'route_whitelist' => [
      'rest.api_layout_footer.GET',
      'editor.link_dialog'
    ]
  ];

• IMPORTANT: If you are using CKEditor 4 you should whitelist the route editor.link_dialog to avoid obfuscating the email in the CKEditor link dialog.

Disabling use of data-nosnippet

• The attribute data-nosnippet is used by default, to disable displaying the $displayNoneText in search results. It is possible to disable it in settings.php

  $settings['email_obfuscator'] = [
    'use_datanosnippet' => FALSE,
  ];

• IMPORTANT: The data-nosnippet attribute is officially supported ONLY by the Googlebot. Support from other bots is not guaranteed.