Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Reward users with points for their actions

fix bug of initial points added to the recognizable to be added after…

…_create instead of after_save
latest commit b71ae86f9f
Eslam Foad authored
Failed to load latest commit information.
lib fix bug of initial points added to the recognizable to be added after…
script
spec Version 0.8.4
.gitignore fix bug of initial points added to the recognizable to be added after…
.rspec Initial commit
.travis.yml Version 0.3.3
CHANGELOG.txt fix bug of initial points added to the recognizable to be added after…
CONTRIBUTING.md Adding README and CONTRIBUTION documents
Gemfile Initial commit
Gemfile.lock Version 0.8.5
LICENSE.txt Adding working points recognition for active_record and action_contro…
README.md Minor fix in documentation
Rakefile Fixing v0.3.0
circle.yml Adding CircleCI configuration file to fix broken builds
recognition.gemspec Version 0.3.5

README.md

Recognition

Build Status

A fully-fledged reward system for Rails 3.1+.

Features

  • Reward users with points for any model method, ActiveRecord crud or even controller methods.
  • Create vouchers that users can redeem for points.

Links

Installation

Add this line to your application's Gemfile:

gem 'recognition'

And then execute:

$ bundle

Then, you need to run the generator:

$ rails generate recogintion:install

And finally, configure your REDIS server connection parameters in: config/recognition.yml

Usage

Points

Assuming you have two models User and Post and you want to give users points for the following:

5 points for registration 7 points for adding new posts, can be earned multiple times with no limit 2 point for deleting posts, can be earned twice 2 points for visiting their profile, earned once

app/models/user.rb:

class User < ActiveRecord::Base
  attr_accessible :name
  has_many :posts
  acts_as_recognizable initial: 5
end

app/models/post.rb:

class Post < ActiveRecord::Base
  attr_accessible :title, :user_id
  belongs_to :user
  recognize :user, for: :create, gain: 7
  recognize :user, for: :destroy, loss: 2, maximum: 4
end

Important: Due to the way Ruby method aliasing work, if you need to recognize users for non-ActiveRecord actions (anything that's not :create, :update and :destroy), make sure you add the recognize line after the method you want to recognize the user for.

app/controllers/profiles_controller.rb:

class ProfilesController < ApplicationController
  recognize :current_user, for: :index, amount: 6, maximum: 12
  def index
    @user = User.find(params[:id])
    respond_to do |format|
      format.html
    end
  end
end

Example:

The following won't work:

class Post < ActiveRecord::Base
  attr_accessible :title, :user_id
  recognize :user, for: :foo, gain: 2
  def foo
    # do something useful
  end
end

This one will:

class Post < ActiveRecord::Base
  attr_accessible :title, :user_id
  def foo
    # do something useful
  end
  recognize :user, for: :foo, gain: 2
end

Vouchers

Use an existing model or generate a new one using:

$ rails generate recogintion:voucher

Your model might have the following attributes:

  • :code required
  • :amount required
  • :expires_at optional
  • :reusable optional

You can specify the following extra parameters for vouchers:

  • :prefix can be a number, string or method name or even an anonymous function.
  • :suffix can be a number, string or method name or even an anonymous function.

app/models/voucher.rb:

class Voucher < ActiveRecord::Base
  attr_accessible :code, :amount, :expires_at, :reusable
    acts_as_voucher code_length: 14
end

Then, you may do:

voucher = Voucher.create!(amount: 20, expires_at: (DateTime.now + 1.day), reusable: true)
voucher.redeem current_user

Gifts

Use an existing model or generate a new one using:

$ rails generate recogintion:gift

Your model might have the following attributes:

  • :code required
  • :amount required
  • :expires_at optional
  • :reusable optional

You can specify the following extra parameters for gifts:

  • :prefix can be a number, string or method name or even an anonymous function.
  • :suffix can be a number, string or method name or even an anonymous function.

app/models/gift.rb:

class Gift < ActiveRecord::Base
  attr_accessible :code, :amount, :expires_at, :reusable
    acts_as_gift code_length: 14
end

Then, you may do:

gift = Gift.create!(amount: 20, expires_at: (DateTime.now + 1.day), reusable: true)
gift.redeem current_user

Contributing

Please see CONTRIBUTING.md for details.

Credits

recognition was originally written by Omar Abdel-Wahab.

RSM

recognition is maintained and funded by Raya Social Media.

License

recognition is Copyright © 2013 Raya Social Media. It is free software, and may be redistributed under the terms specified in the LICENSE file.

Something went wrong with that request. Please try again.