rails_admin
v3.3.0
Published
RailsAdmin is a Rails engine that provides an easy-to-use interface for managing your data.
Downloads
45,465
Readme
RailsAdmin
RailsAdmin is a Rails engine that provides an easy-to-use interface for managing your data.
Getting started
- Check out the docs.
- Try the live demo. (Source code)
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
- On your gemfile:
gem 'rails_admin', '~> 3.0'
- Run
bundle install
- Run
rails g rails_admin:install
- Provide a namespace for the routes when asked
- Start a server
rails s
and administer your data at /admin. (if you chose default namespace: /admin)
Upgrading from 2.x
Due to introduction of Webpack/Webpacker support, some additional dependency and configuration will be needed.
Running rails g rails_admin:install
will suggest you some required changes, based on current setup of your app.
Configuration
Global
In config/initializers/rails_admin.rb
:
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
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:
- Ruby 2.6
- Ruby 2.7
- Ruby 3.0
- Ruby 3.1
- Ruby 3.2
- JRuby