Skip to content

Template tags providing weak hiding of email addresses using JavaScript or CAPTCHAs

License

Notifications You must be signed in to change notification settings

nicktimko/django-mailmangler

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

5 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Mail Mangler

A simple Django app providing template tags that attempt to obfuscate raw e-mail addresses to make them ever so slightly more difficult to scrape.

To be less-obtrusive, JavaScript is used to translate mangled source into a normal e-mail address. If JavaScript is not present, the reCAPTCHA mailhide service is offered to deobfuscate the addresses.

Using images, LTR-RTL hacks, or forcing reCAPTCHA access might be better at keeping your address safe from bots, but it's annoying for legitimate users. By using JavaScript, hopefully we can thwart some of the dumbest bots into farming someone else's email address without much of a usability hit.

Quick start

  1. In your Django's settings:

    1. Add 'mailmangler' to INSTALLED_APPS.

    2. Define MAILMANGLE_PUBLIC and MAILMANGLE_SECRET with keys from the reCAPTCHA Mailhide API, e.g.

      MAILMANGLE_PUBLIC = 'your-key...=='
      MAILMANGLE_SECRET = '123789...abcd'
      
  2. Load the tags and filters in your template with {% load mailmangler %}

  3. In the <head> of your template, add {% mailmangle_js %}. (The JS deobfuscator uses inline document.write's, so by loading the code early, hopefully this will avoid any rendering delays.)

  4. Pipe (filter) email addresses through mailmangle or mailmangle_linked, e.g.

    {{ my_email_var|mailmangle }}
    {{ "[email protected]"|mailmangle }}
    {{ "[email protected]"|mailmangle_linked }}
    

    will produce:

    1. A JS obfuscated, unlinked string of whatever my_email_var was.
    2. A JS obfuscated, unlinked string of "[email protected]"
    3. A JS obfuscated, string with mailto link of "[email protected]"

    If JS is not present, a reCAPTCHA mailhide link is available in <noscript> tags.

About

Template tags providing weak hiding of email addresses using JavaScript or CAPTCHAs

Resources

License

Stars

Watchers

Forks

Packages

No packages published