Go to file
Jason Lee bd138df5b8 Trim blank space and make better position. version 0.3.2 2015-12-24 12:12:07 +08:00
app/controllers/ru_captcha oops! blannnnnnnnk line 2015-11-09 15:40:27 +08:00
config Adding locale for pt-BR language 2015-10-31 10:30:07 -02:00
lib Trim blank space and make better position. version 0.3.2 2015-12-24 12:12:07 +08:00
spec More complex Image render: compact text, strong lines, +/-5 rotate... 2015-11-05 18:20:41 +08:00
.gitignore Added file cache, can setup how many images you want generate by , 2015-10-30 11:32:02 +08:00
.travis.yml Try to fix Travis CI config 2015-10-29 18:11:49 +08:00
CHANGELOG.md Trim blank space and make better position. version 0.3.2 2015-12-24 12:12:07 +08:00
Gemfile Add .travis.yml 2015-10-29 17:50:09 +08:00
Gemfile.lock Add expire time, for protect Rails CookieSession Replay Attack. version 0.2.4 2015-11-02 16:59:42 +08:00
LICENSE Initial commit 2015-10-26 14:07:48 +08:00
README.md Update example images. 2015-11-05 18:30:10 +08:00
Rakefile Add .travis.yml 2015-10-29 17:50:09 +08:00
rucaptcha.gemspec Add .travis.yml 2015-10-29 17:50:09 +08:00

README.md

RuCaptcha

Gem Version Build Status

This is a Captcha gem for Rails Applications. It runs an ImageMagick command to draw Captcha image - so it has NO performance issues or memory leak issues.

There is NO: RMagick

Idea by: https://ruby-china.org/topics/20558#reply4

中文介绍和使用说明

Feature

  • Only need ImageMagick, No RMagick, No mini_magick;
  • For Rails Application;
  • Simple, Easy to use;
  • File Caching for performance.

Requirements

  • ImageMagick

Ubuntu

sudo apt-get install imagemagick

Mac OS X

brew install imagemagick ghostscript

Example

captcha8 captcha7 captcha6 captcha5 captcha4 captcha3 captcha2 captcha1

Usage

Put rucaptcha in your Gemfile:

gem 'rucaptcha'

Create config/initializers/rucaptcha.rb

RuCaptcha.configure do
  # Number of chars, default: 4
  self.len = 4
  # Image font size, default: 45
  self.font_size = 45
  # Cache generated images in file store, this is config files limit, default: 100
  # set 0 to disable file cache.
  self.cache_limit = 100
end

Edit config/routes.rb, add the following code:

Rails.application.routes.draw do
  ...
  mount RuCaptcha::Engine => "/rucaptcha"
  ...
end

Controller app/controller/account_controller.rb

class AccountController < ApplicationController
  def create
    @user = User.new(params[:user])
    if verify_rucaptcha?(@user) && @user.save
      redirect_to root_path, notice: 'Sign up successed.'
    else
      render 'account/new'
    end
  end
end

View app/views/account/new.html.erb

<form>
  ...
  <div class="form-group">
    <%= rucaptcha_input_tag(class: 'form-control', placeholder: 'Input Captcha') %>
    <%= rucaptcha_image_tag(alt: 'Captcha') %>
  </div>
  ...
</form>

Write your test skip captcha validation

describe 'sign up and login', type: :feature do
  before do
    allow_any_instance_of(ActionController::Base).to receive(:verify_rucaptcha?).and_return(true)
  end

  it { ... }
end