RailsAdmin is a Rails engine that provides an easy-to-use interface for managing your data
Ruby CSS JavaScript HTML CoffeeScript
Latest commit 4a6284b Jan 12, 2017 @mshibuya mshibuya Update Appraisals file

README.md

RailsAdmin

Gem Version Build Status Dependency Status Code Climate Coverage Status Inline docs

RailsAdmin is a Rails engine that provides an easy-to-use interface for managing your data.

Announcements

[Action required] Security issue

RailsAdmin 1.0.0 and 1.1.0 have been reported to have CSRF vulnerability with default setup. We strongly recommend that you upgrade RailsAdmin to 1.1.1 or later as soon as possible, if you are on these versions. See b13e879e for the detail.

This problem was reported by SourceClear, Inc.

Features

  • CRUD any data with ease
  • Custom actions
  • Automatic form validation
  • Search and filtering
  • Export data to CSV/JSON/XML
  • Authentication (via Devise or other)
  • Authorization (via CanCanCan or Pundit)
  • User action history (via PaperTrail)
  • Supported ORMs
    • ActiveRecord
    • Mongoid

Installation

  1. On your gemfile: gem 'rails_admin', '~> 1.0'
  2. Run bundle install
  3. Run rails g rails_admin:install
  4. Provide a namespace for the routes when asked
  5. Start a server rails s and administer your data at /admin. (if you chose default namespace: /admin)

Configuration

Global

In config/initializers/rails_admin:

Details

To begin with, you may be interested in setting up Devise, CanCanCan or Papertrail!

Per model

class Ball < ActiveRecord::Base
  validates :name, presence: true
  belongs_to :player

  rails_admin do
    configure :player do
      label 'Owner of this ball: '
    end
  end
end

Details: Models, Groups, Fields

Documentation

https://github.com/sferik/rails_admin/wiki

Demo

Take RailsAdmin for a test drive with sample data. (Source code.)

Support

If you have a question, please check this README, the wiki, and the list of known issues.

If you still have a question, you can ask the official RailsAdmin mailing list.

If you think you found a bug in RailsAdmin, you can submit an issue.

Supported Ruby Versions

This library aims to support and is tested against the following Ruby implementations: