Reputation system Rails engine.
Ruby JavaScript
Pull request Compare This branch is 329 commits behind merit-gem:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.

Merit Gem: Reputation rules (badges, points and rankings) for Rails applications


Build Status


  • ActiveRecord or Mongoid


  1. Add gem 'merit' to your Gemfile
  2. Run rails g merit:install
  3. Run rails g merit USER_MODEL_NAME
  4. Run rake db:migrate (only for ActiveRecord)
  5. Configure reputation rules for your application

Defining badge rules

You may give badges to any resource on your application if some condition holds. Badges may have levels, and may be temporary. Define rules on app/models/merit_badge_rules.rb:

grant_on accepts:

  • 'controller#action' string (similar to Rails routes)
  • :badge for badge name
  • :level for badge level
  • :to method name over target_object which obtains object to badge
  • :model_name (string) define controller's name if it differs from the model (like RegistrationsController for User model).
  • :multiple (boolean) badge may be granted multiple times
  • :temporary (boolean) if the receiver had the badge but the condition doesn't hold anymore, remove it. false by default (badges are kept forever).
  • &block
    • empty (always grants)
    • a block which evaluates to boolean (recieves target object as parameter)
    • a block with a hash composed of methods to run on the target object with expected values


grant_on 'comments#vote', :badge => 'relevant-commenter', :to => :user do |comment|
  comment.votes.count == 5

grant_on ['users#create', 'users#update'], :badge => 'autobiographer', :temporary => true do |user| && user.address.present?

Grant manually

You may also grant badges "by hand":


Defining point rules

Points are a simple integer value which are given to "meritable" resources. They are given on actions-triggered, either to the action user or to the method(s) defined in the :to option. Define rules on app/models/merit_point_rules.rb:


score 10, :on => [

score 15, :on => 'reviews#create', :to => [:reviewer, :reviewed]

score 20, :on => [

Defining rank rules

5 stars is a common ranking use case. They are not given at specified actions like badges, you should define a cron job to test if ranks are to be granted.

Define rules on app/models/merit_rank_rules.rb:

set_rank accepts:

  • :level ranking level (greater is better)
  • :to model or scope to check if new rankings apply
  • :level_name attribute name (default is empty and results in 'level' attribute, if set it's appended like 'level_#{level_name}')

Check for rules on a rake task executed in background like:

task :cron => :environment do


set_rank :level => 2, :to => do |commiter|
  commiter.branches > 1 && commiter.followers >= 10

set_rank :level => 3, :to => do |commiter|
  commiter.branches > 2 && commiter.followers >= 20

To-do list

  • Can infer params[:id] = in create actions, for having the object in the rule method parameter, so we don't need it in controllers.
  • add an error handler for inexistent badges.
  • rails g merit MODEL_NAME shouldn't create general migrations again.
  • Abstract User (rule.rb#51 for instance) into a Merit option.
  • Should namespace app/models into Merit module.
  • rescue ActiveRecord::... should depend on ORM used
  • Why 1.8.7 tests are not passing?
  • :value parameter (for star voting for example) should be configurable (depends on params[:value] on the controller).
  • Make fixtures for integration testing (now creating objects on test file!).