devise_suspendable

= devise_suspendable

devise_suspendable is a simple module which uses the Devise authentication framework Activatable module hooks to provide a simple clean way to suspend an account. When an account is suspended the date and time of suspension is recorded, as well as an optional reason, for easy reference.

== Setup (Assumes that you have devise already setup and your device models, e.g. User, are already created)

1. Add gem devise_suspendable in your Gemfile
2. Create a migration to update each of your device model(s), e.g. User, that you want to be suspendable rails g devise_suspendable User
3. Run the migration rake db:migrate
4. Mark the model as suspendable class User < ActiveRecord::Base devise ..., :activatable, :suspendable ... end

== Notes

• :suspendable depends on :activatable

• This plugin is similar to Lockable and can be used along side it, as long as Lockable is using token or timeouts as the unlock strategy. Lockable is great for failed login tracking, and subsequent locking, suspendable is best for manual account suspension

• Maintaining your active users is part and parcel of running a web app

== References

• Devise
• Warden

== Thanks to

• Josh Kalderimis for most of core logic for this gem
• devise_lastseenable[https://github.com/ctide/devise_lastseenable] for essentially operating as the base for this gem
• Jeweler[https://github.com/technicalpickles/jeweler] for making it dead simple to write this gem

Released under the MIT license

Copyright (c) 2010, 2011 Josh Kalderimis, Amol Kelkar