No commit activity in last 3 years
No release in over 3 years
Middleman extension for email link protection and obfuscation.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

~> 10.3

Runtime

 Project Readme

middleman-protect-emails

Build Status Code Climate Test Coverage

middleman-protect-emails is a Middleman extension that encrypts email links on your page on the server-side and decodes them on the client-side, avoiding spam bots with no visible impacts to your users.

This gem makes use of the ROT13 encryption algorithm to encrypt email links. Users must have Javascript enabled on their computers for the decoding stage to work.

Installation

Add this line to your Middleman application's Gemfile:

gem 'middleman-protect-emails'

And then run:

$ bundle

Usage

Using this gem is as simple as adding the following line to your project's config.rb file:

activate :protect_emails

And that's it! This will now protect all mailto links in your Middleman project.

How it Works

If the middleware detects a mailto link on your page, it will automatically replace the link with an encrypted hash and insert a small script at the end of the page for the browser to decode it on page load. For example, if the following code was on one of your pages:

<a href='mailto:hello@example.com'>Link</a>

It would automatically be replaced with:

<a href='#email-protection-uryyb@rknzcyr.pbz'>Link</a>

This extension also encrypts link parameters (ex. mailto:hello@example.com?subject=Some%20Subject).

Contributing

  1. Fork it
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create a new pull request