/rails_admin

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

Primary LanguageRubyMIT LicenseMIT

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.

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:
  • For Rails 5 project:

    gem 'remotipart', github: 'mshibuya/remotipart'
    gem 'rails_admin', '>= 1.0.0.rc'
    
  • For Rails 4 project:

    gem 'rails_admin'
    
  1. Run bundle install
  2. Run rails g rails_admin:install
  3. Provide a namespace for the routes when asked
  4. 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: