Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/kiskolabs/humanizer
Very simple captcha with Rails 3 & 4 & 5 & 6 & 7 support
https://github.com/kiskolabs/humanizer
captcha rails ruby ruby-on-rails
Last synced: 27 days ago
JSON representation
Very simple captcha with Rails 3 & 4 & 5 & 6 & 7 support
- Host: GitHub
- URL: https://github.com/kiskolabs/humanizer
- Owner: kiskolabs
- License: mit
- Created: 2010-06-26T11:57:53.000Z (over 14 years ago)
- Default Branch: master
- Last Pushed: 2024-07-25T08:05:16.000Z (3 months ago)
- Last Synced: 2024-09-28T12:04:17.968Z (about 1 month ago)
- Topics: captcha, rails, ruby, ruby-on-rails
- Language: Ruby
- Homepage: https://kiskolabs.github.io/humanizer
- Size: 110 KB
- Stars: 256
- Watchers: 26
- Forks: 52
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# Humanizer
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–7.
## Installation
Add `humanizer` to your Gemfile:
```ruby
gem "humanizer"
```
Bundle and run the generator in terminal:
```sh
bundle
rails g humanizer
```
## Advanced Installation
* 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`
## Usage
1. In your model, include Humanizer and add the #require_human_on method, example:
```ruby
class User < ActiveRecord::Base
include Humanizer
require_human_on :create
end
```
2. Ask the question in the form, example:
```erb
<%= f.label :humanizer_answer, @model.humanizer_question %>
<%= f.text_field :humanizer_answer %>
<%= f.hidden_field :humanizer_question_id %>
```
3. If you are using attr_accessible, remember to whitelist `:humanizer_answer` and `:humanizer_question_id`.
4. If you are using strong_parameters, remember to permit `:humanizer_answer` and `:humanizer_question_id`.
## Configuration
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.
## Skipping validation
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:
```ruby
attr_accessor :bypass_humanizer
require_human_on :create, unless: :bypass_humanizer
```
Now when bypass_humanizer is true, validation will be skipped.
## Reloading questions
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:
```ruby
@user.change_humanizer_question(params[:user][:humanizer_question_id])
```
## License
Humanizer is licensed under the MIT License, for more details see the LICENSE file.
## Question/Answer Translations
* English, Finnish and Portuguese translations by [Kisko Labs](http://kiskolabs.com/)
* German by [Sven Schwyn](http://github.com/svoop)
* Dutch by [Joren De Groof](http://github.com/joren)
* Brazilian Portuguese by [Britto](http://github.com/britto)
* Russian by [Shark](http://github.com/Serheo)
* Spanish by [Juanjo Bazán](https://github.com/xuanxu)
* Polish by [Maciek O](https://github.com/ohaleck)
* Italian by [Alberto Vena](https://github.com/kennyadsl)
* Chinese (Simplified) by [Crane Jin](https://github.com/cranej)
## Contributors
* [Florian Bertholin](https://github.com/Arkan)
* [seogrady](https://github.com/seogrady)
* [yairgo](https://github.com/yairgo)
* [woto](https://github.com/woto)
## CI Build Status
[](https://travis-ci.org/kiskolabs/humanizer)