#THIS PROJECT IS DEPRECATED
emo is not maintained anymore. It maybe does not work in Evolution 1.1 anymore. Please fork it and bring it back to life, if you need it.
E-Mail Obfuscation with Javascript for the MODX Evolution content management framework
This plugin replaces all plaintext emails and email links with span elements. Then the email addresses are encrypted and stored in javascript variables. Javascript decryption routines are triggered by the browser on 'window.onload' event and replace the span elements with the real email addresses.
This plugin searches for 'mailto:' strings in href attributes and all plain text email addresses in the html output. However, only email addresses like 'user@host.com' are matched whereas 'Tog@ther' is left untouched.
Matches of all plaintext emails and email links are consequently replaced with span elements only containing a note to turn on javascript. Then email addresses and original link text are encrypted and stored in javascript variables. Decryption routines triggered by the browser on 'window.onload' event are located in the script file 'emo.js'. Optionally, CSS class 'emo_address' can be used to configure the appearance of email links.
It is still believed that hexadecimal or unicode encoding will stop spam-bots being able to find your email address. Nevertheless, encoded email address harvester are on the way. Unlike other obfuscation plugins, this one uses real encryption instead of using an out-dated and over-used hack such as hexadecimal or unicode encoding (not encryption) of email addresses. Also, all traces of href attributes as well as 'mailto:' strings and '@' characters are hidden from spam-bots. But it does not modify adresses inside <form> tags. So posted and not validated forms do not break.
If the 'No javascript' message contains a number, a link to a MODX resource with that ID is generated. This could i.e. point to a resouce with a contact form.
- Upload the folder assets/plugins/emo in the corresponding folder in your installation.
- Create a plugin called 'emo' with the plugin code
include MODX_BASE_PATH.'/assets/plugins/emo/emo.plugin.php';and check theOnWebPagePrerenderandOnLoadWebDocumentevents. - Insert the following code into the Plugin configuration
&emoTplOnly=Templates only?;list;enable,disable;enable
&emoSelection=How to select IDs?;list;exclude,include;exclude
&emoSelectionRange=Chosen IDs;text;
&pathToEmoJs=Path to emo javascript;text;/assets/plugins/emo/emo.min.js
&pathToEmoCss=Path to emo css;text;
&noScriptMessage='No javascript' message (Resource ID for internal link);text;Turn on JavaScript!
| Property | Description | Default |
|---|---|---|
| emoTplOnly | Don't work on resources with blank template | Yes |
| emoSelection | Selection type for enabled/disabled resources for emo | - |
| emoSelectionRange | Comma separated list of enabled/disabled resource IDs for emo | |
| pathToEmoJs | Path to emo javascript | /assets/components/emo/js/emo.min.js |
| pathToEmoCss | Path to emo css | |
| noScriptMessage | 'No javascript' message (Resource ID for internal link) | Turn on JavaScript! |