Humanizer is a very simple CAPTCHA method. It has a localized YAML file with questions and answers which is used to validate that the user is an actual human. Any model that includes ActiveModel::Validations should work. Our aim is to be database and mapper agnostic, so if it doesn't work for you, open an issue. Humanizer works with Rails 3 and 4.
humanizer to your Gemfile:
Bundle and run the generator in terminal:
bundle rails g humanizer
- Install all locales:
rails g humanizer --all-locales
- Show available locales:
rails g humanizer --show-locales
- Install selected locales:
rails g humanizer en fi de
- In your model, include Humanizer and add the #require_human_on method, example:
class User < ActiveRecord::Base include require_human_on :create end
- Ask the question in the form, example:
<%= f.label :humanizer_answer, @model.humanizer_question %> <%= f.text_field :humanizer_answer %> <%= f.hidden_field :humanizer_question_id %>
If you are using attr_accessible, remember to whitelist
If you are using strong_parameters, remember to permit
Default translations can be found in config/locales/
You might want to add/change question and answer pairs. This can be easily done by adding/modifying entries in locales file.
You might want to skip the humanizer validations on your tests or rails console.
You can just have a simple attribute on your model and use it to bypass the validation. Here's an example:
attr_accessor :bypass_humanizer require_human_on :create, :unless => :bypass_humanizer
Now when bypass_humanizer is true, validation will be skipped.
In case you want to give your users the option to change the question, there's a #change_humanizer_question method to help you.
To make sure the current question doesn't get asked again, you can pass the current question id to the method. For example:
Humanizer is licensed under the MIT License, for more details see the LICENSE file.
- English, Finnish and Portuguese translations by Kisko Labs
- German by Sven Schwyn
- Dutch by Joren De Groof
- Brazilian Portuguese by Britto
- Russian by Shark
- Spanish by Juanjo Bazán
- Polish by Maciek O
- Italian by Alberto Vena
- Chinese (Simplified) by Crane Jin