Whodat - A simple, easy to use, authentication gem for Rails

• An MVC solution built on a Rails engine
• Uses BCrypt for password encryption
• Allows a quick easy user authentication
• And reference to current_user, user name and email

Whodat is intended to be used for easy and quick access to user and sessions when developing a rails application. When you don't want a lengthy set up, use Whodat. Add the one line responsive dashboard to whatever view you want. The dashboard has a main app button to return the user to the main app index page.

To see Whodat in use, run this demo app, Blogger. Test out the Whodat user dashboard.

gem 'whodat'

$ bundle install

or just add the gem as a dependency $ gem install whodat

Add this snippet to the header section of your application view

<%= render partial: "whodat/dashboard/navbar", action: "index" %>

Add this snippet to your main app application controller, then you can use current_user in any controller or view in your app

     helper_method :current_user
     def current_user
        @current_user ||= ::Whodat::User.find(session[:user_id])
     end

Add a migration to add user as reference to your table

$ rails g AddUserToYourTableName user:references`

And don't forget to run the migration

$ rake Whodat:install:migrate
$ rake db:migrate

Now you can refer to Whodat user attributes in your views user attributes: id, name, and email

<%= @class_instance.user.name %>`

In your app, create a whodat directory in your app/models directory, then create a new file user.rb with the following, replacing posts with the objects you need to link with a user. CAUTION: This overrides the user class in the gem, so use carefully and sparingly.

module Whodat
   class User < Whodat::ApplicationRecord
      has_many :posts
    end
end

Code of Conduct

• Do not open up a GitHub issue if the bug is a dependency security vulnerability.
• Ensure the bug was not already reported by searching on GitHub under Issues.
• If you're unable to find an open issue addressing the problem, open a new one. Be sure to include a title and clear description, as much relevant information as possible, what was expected, and a code sample or an executable test case demonstrating the expected behavior that is not occurring.

Read How to Contribute

You can test the engine (after forking, cloning, creating your upstream repo and branch.) run the internal "dummy" app by entering on your command line:

bin/rails server -b 127.0.0.1

and open your browser to localhost:3000

Ask any questions about how to use whodat.

Thank you for your interest!

Contact the Administrator

The gem is available as open source under the terms of the MIT License.