ReCAPTCHA Mailhide

This gem provides Ruby (and Rails) support for ReCAPTCHA’s Mailhide API.

Installation

Add this to your Gemfile:

gem 'recaptcha-mailhide'

Configuration

Add this somewhere (if you’re using Rails put it in config/initializers/recaptcha_mailhide.rb):

RecaptchaMailhide.configure do |c|
  c.private_key = '...'
  c.public_key  = '...'
end

If you need a set of public/private keys get them from www.google.com/recaptcha/mailhide/apikey

Usage

In Rails views

recaptcha_mailhide('[email protected]')

You can also provide content as a method argument or a block (just like with link_to):

# Content in argument
recaptcha_mailhide('Click to view email', '[email protected]')

recaptcha_mailhide('[email protected]') do
  # Content here
end

You can also provide options (they get forwarded to link_to):

recaptcha_mailhide('[email protected]', class: 'hidden-email', target: '_blank')

In addition it accepts a :popup option that will make the link open in a popup window (requires JavaScript):

recaptcha_mailhide('[email protected]', popup: true)

# Configuring popup window size
recaptcha_mailhide('[email protected]', popup: { width: 600, height: 600 })

Pure Ruby

Use the following to get just the ReCAPTCHA Mailhide URL (without a link tag):

RecaptchaMailhide.url_for(email)

TODO

Tests for Rails helpers
Basic helpers (non-dependent on Rails)
Rails generator for initializer with auto-fetching of private/public keys