0.02
No commit activity in last 3 years
No release in over 3 years
Makes it easy to set a role strategy on your User model in Mongoid
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

>= 2.4.1

Runtime

>= 1.2.0
>= 2.0.1
~> 1.2.0
~> 0.4.9.5
 Project Readme

Roles for Mongoid

A Mongoid implementation of [Roles Generic](http://github.com/kristianmandrup/roles_generic).
See the Roles [wiki](http://github.com/kristianmandrup/roles_generic/wiki) for an overview of the API and how to use it.

Role strategies

Role strategies implemented:

Inline attribute on User

  • admin_flag
  • roles_mask
  • role_string
  • role_strings

Reference Role

  • many_roles
  • one_role

Embedded Role

  • embed_many_roles
  • embed_one_role

Install

gem install roles_mongoid

Install in Rails app

Insert in Gemfile:

gem 'roles_mongoid'

Run $ bundle install from terminal

Alternatively install using [Cream](http://github.com/kristianmandrup/cream)

Strategy and roles configuration

Example: role_string strategy

class User
  include Mongoid::Document  
  include Roles::Mongoid 

  strategy :one_role
  valid_roles_are :admin, :guest, :user
end  

Example: one_role strategy

class User
  include Mongoid::Document  
  include Roles::Mongoid 

  strategy :one_role
  valid_roles_are :admin, :guest, :user
end  

Rails generators

The library comes with a Rails 3 generator that lets you populate a user model with a role strategy of your choice.

The following role strategies are included by default. Add your own by adding extra files inside the strategy folder, one file for each role strategy is recommended.

Apply :admin_flag Role strategy to User model using default roles :admin and :guest (default)

$ rails g mongoid:roles User --strategy admin_flag

Apply :admin_flag Role strategy to User model using default roles and extra role :author

$ rails g mongoid:roles_migration User --strategy admin_flag --roles author

Apply :one_role Role strategy to User model without default roles, only with roles :user, :special and :editor

$ rails g mongoid:roles_migration User --strategy one_role --roles user special editor --no-default-roles

Note on Patches/Pull Requests

  • Fork the project.
  • Make your feature addition or bug fix.
  • Add tests for it. This is important so I don’t break it in a
    future version unintentionally.
  • Commit, do not mess with rakefile, version, or history.
    (if you want to have your own version, that is fine but bump version in a commit by itself I can ignore when I pull)
  • Send me a pull request. Bonus points for topic branches.

Copyright

Copyright © 2010 Kristian Mandrup. See LICENSE for details.