{ "info": { "author": "Nick Timkovich", "author_email": "prometheus235@gmail.com", "bugtrack_url": null, "classifiers": [ "Development Status :: 3 - Alpha", "Environment :: Web Environment", "Framework :: Django", "Intended Audience :: Developers", "License :: OSI Approved :: MIT License", "Operating System :: OS Independent", "Programming Language :: Python", "Programming Language :: Python :: 2", "Programming Language :: Python :: 2.6", "Programming Language :: Python :: 2.7", "Programming Language :: Python :: 3" ], "description": "============\nMail Mangler\n============\n\nA simple Django app providing template tags that attempt to obfuscate raw\ne-mail addresses to make them ever so slightly more difficult to scrape.\n\nTo be less-obtrusive, JavaScript is used to translate mangled source into a\nnormal e-mail address. If JavaScript is not present, the reCAPTCHA mailhide\nservice is offered to deobfuscate the addresses.\n\nUsing images, LTR-RTL hacks, or forcing reCAPTCHA access might be better at\nkeeping your address safe from bots, but it's annoying for legitimate users.\nBy using JavaScript, hopefully we can thwart some of the dumbest bots into\nfarming someone else's email address without much of a usability hit.\n\nQuick start\n-----------\n\n1. In your Django's settings:\n\n * Add ``'mailmangler'`` to your ``INSTALLED_APPS``.\n\n * Add ``MAILMANGLE_PUBLIC`` and ``MAILMANGLE_SECRET``,\n with keys from the reCAPTCHA Mailhide API:\n , e.g. ::\n\n MAILMANGLE_PUBLIC = 'your-key...=='\n MAILMANGLE_SECRET = '123789...abcd'\n\n2. Load the tag library with ``{% load mailmangler %}``\n\n3. In the ```` of your template, add ``{% mailmangle_js %}``\n\n4. Pipe (filter) email addresses through ``mailmangle`` or\n ``mailmangle_linked``, e.g. ::\n\n {{ my_email_var|mailmangle }}\n {{ \"alice@example.com\"|mailmangle }}\n {{ \"bob@example.net\"|mailmangle_linked }}\n\n will produce:\n\n 1. A JS obfuscated, unlinked string of whatever ``my_email_var`` was.\n 2. A JS obfuscated, unlinked string of \"alice@example.com\"\n 3. A JS obfuscated, string with mailto link of \"bob@example.com\"\n\n If JS is not present, a reCAPTCHA mailhide link is available in\n ``