EmailObfuscationPlugin

Introduction

This plugin replaces characters in email address with their appropriate HTML entity references. This is intended to help prevent email harvesters from recognizing addresses.

Syntax Rules

• N/A

Examples

• user@examplePLEASENOSPAM.com (If you view source you should see that the string is encoded).

Plugin Settings

Plugin settings are stored as preferences variables. To reference a plugin setting write %<plugin>_<setting>%, i.e. %EMAILOBFUSCATIONPLUGIN_SHORTDESCRIPTION%

• Short description:
  • Set SHORTDESCRIPTION = Obfuscates e-mail addresses by characters to their HTML character entity references

• Debug plugin: (See output in data/debug.txt)
  • Set DEBUG = 0

• Range of characters to encode (NOTE: Setting a bad range here can result in your TWiki not displaying content, please ensure that a correct range is used and that the Plugin topic is locked to TWikiAdminGroup):
  • Set ESCAPELIST = \000-\056\072-\100\133-\140\173-\177

• Restrict access: (remove the # to enable the access control)
  • #Set ALLOWTOPICCHANGE = TWikiAdminGroup

Plugin Installation Instructions

Note: You do not need to install anything on the browser to use this plugin. The following instructions are for the administrator who installs the plugin on the TWiki server.

• Ensure you have the HTML::Entities module installed from CPAN.
• Download the ZIP file from the Plugin web (see below)
• Unzip EmailObfuscationPlugin.zip in your twiki installation directory. Content:

  File:	Description:
  data/TWiki/EmailObfuscationPlugin.txt	Plugin topic
  lib/TWiki/Plugins/EmailObfuscationPlugin.pm	Plugin Perl module

• Configure the Plugin:
  • Run the configure script to enable the plugin
  • Change the plugin settings as needed. Enable the access control by removing the # from the Set ALLOWTOPICCHANGE

Plugin Info

Related Topics: TWikiPlugins, DeveloperDocumentationCategory, AdminDocumentationCategory, TWikiPreferences