RailsAdmin was conceived as a port of MerbAdmin to Rails 3 and implemented as a Ruby Summer of Code project by Bogdan Gaza with mentors Erik Michaels-Ober, Yehuda Katz, Rodrigo Rosenfeld Rosas, Luke van der Hoeven, and Rein Henrichs.
It currently offers the following functionality:
-
Show database tables
-
Easily update data
-
Create new data
-
Safely delete data
-
Automatic form validation
-
Search
-
Authentication (via Devise)
-
User action history
In your Gemfile, add the following dependency:
gem 'devise' # Devise must be required before RailsAdmin gem 'rails_admin', :git => 'git://github.com/sferik/rails_admin.git'
Run:
$ bundle update
And then run:
$ rails generate rails_admin:install_admin
This task will install RailsAdmin. During this process, it install Devise if you don’t already have it installed. Devise is required for authentication to protect your data from anonymous users.
Start the server:
$ rails server
You should now be able to administer your site at localhost:3000/admin (after you have created a simple account)
In the spirit of free software, people of all abilities are encouraged to help improve RailsAdmin.
There are many ways to contribute:
-
by reporting bugs
-
by suggesting new features
-
by writing documentation
-
by writing specifications
-
by writing code (no patch is too small: fix typos in comments or inconsistent whitespace)
-
by refactoring code
-
by reviewing patches
Please submit bugs and feature requests to the issue tracker.
All contributors will be added to the credits below and will receive the respect and gratitude of the author.
If you have questions about contributing to RailsAdmin, please contact Erik Michaels-Ober and Bogdan Gaza.
Many thanks to:
-
Everyone in the Ruby Summer of Code class of 2010
-
and everyone who contributed to MerbAdmin.