Recognition

A fully-fledged reward system for Rails 3.1+.

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

Usage

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

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

Note

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.

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

Contributing

Please see CONTRIBUTING.md for details.

Credits

recognition was originally written by Omar Abdel-Wahab.

recognition is maintained and funded by Raya Social Media.