public
Description: ReCaptcha helpers for Rails apps
Homepage: http://ambethia.com/recaptcha
Clone URL: git://github.com/ambethia/recaptcha.git
Search Repo:
name age message
folder .gitignore Sun Jun 22 14:58:30 -0700 2008 Ignoring generated rdoc [ambethia]
folder LICENSE Sat May 26 02:35:19 -0700 2007 Initial import of ReCAPTCHA plugin [ambethia]
folder README.rdoc Thu May 08 18:52:28 -0700 2008 Updating README and tweaking Rdoc tasks [ambethia]
folder Rakefile Thu May 08 18:52:28 -0700 2008 Updating README and tweaking Rdoc tasks [ambethia]
folder init.rb Sat May 26 02:35:19 -0700 2007 Initial import of ReCAPTCHA plugin [ambethia]
folder install.rb Sat May 26 02:35:19 -0700 2007 Initial import of ReCAPTCHA plugin [ambethia]
folder lib/ Tue Jul 01 15:02:01 -0700 2008 enhancement for using recaptcha ajax api [Evan Wheeler]
folder tasks/ Sat May 26 02:35:19 -0700 2007 Initial import of ReCAPTCHA plugin [ambethia]
folder test/ Wed Jun 18 13:50:47 -0700 2008 Refactoring verify_recaptcha_test [pivotal]
folder uninstall.rb Sat May 26 02:35:19 -0700 2007 Initial import of ReCAPTCHA plugin [ambethia]
README.rdoc

ReCAPTCHA

Author:Jason L Perry (http://ambethia.com)
Copyright:Copyright © 2007 Jason L Perry
License:MIT
RDOC:http://ambethia.com/recaptcha/
Git:http://github.com/ambethia/recaptcha/tree/master
Bugs:http://ambethia.lighthouseapp.com/projects/11072-recaptcha/overview

This plugin adds helpers for the ReCAPTCHA API (http://recaptcha.net/). In your views you can use the recaptcha_tags method to embed the needed javascript, and you can validate in your controllers with verify_recaptcha.

You’ll want to add your public and private API keys in the environment variables RECAPTCHA_PUBLIC_KEY and RECAPTCHA_PRIVATE_KEY, respectively. You could also specify them in config/environment.rb if you are so inclined. Exceptions will be raised if you call these methods and the keys can’t be found.

recaptcha_tags

Some of the options available:

:ssl:Uses secure http for captcha widget (default false)
:noscript:Include content (default true)
:display:Takes a hash containing the theme and tabindex options per the API. (default nil)
:public_key:Your public API key, takes precedence over the ENV variable (default nil).
:error:Override the error in +session[:recaptcha_error]+ (default nil).

verify_recaptcha

This method returns true or false after processing the parameters from the ReCAPTCHA widget. Why isn’t this a model validation? Because that violates MVC. Use can use it like this, or how ever you like. Passing in the ActiveRecord object is optional, if you do—and the captcha fails to verify—an error will be added to the object for you to use.

  respond_to do |format|
    if verify_recaptcha(@post) && @post.save
      # ...
    else
      # ...
    end
  end

TODO

  • Remove Rails/ActionController dependencies
  • Framework agnostic
  • Add some helpers to use in before_filter and what not
  • Better documentation