Sha256: 89cc619c87a07d3e7c5da111d99b1c6dcc1cb6f62ea063527fe00677196a1e50
Contents?: true
Size: 1.63 KB
Versions: 47
Compression:
Stored size: 1.63 KB
Contents
# Installation
Installing Active Admin in a Rails application is as easy as adding the gem to
your Gemfile:
# Gemfile
gem 'activeadmin'
## Running the Generator
Once you have added the gem to your Gemfile (and any other dependencies), you
need to run the Active Admin install generator.
$> rails generate active_admin:install
This will install Active Admin the default settings. By default it will create a
new Devise user / model called AdminUser. To change the name of the user class,
simply pass the class as the last argument:
$> rails generate active_admin:install User
Instead of generating an AdminUser class, this command will create a User class.
You can skip the Devise user class all together by using the `skip-users` flag:
$> rails generate active_admin:install --skip-users
NOTE: If you don't use the default user settings, you will need to configure the
settings in `config/intializers/active_admin.rb` to suite your needs.
After running the installer, run `rake db:migrate` to ensure that all db tables
are created.
## Upgrading
To upgrade Active Admin, simply update the version number in your Gemfile, then
run the assets generator:
$> rails generate active_admin:assets
This command makes sure you have all the latest assets and your installation is
up to date. Each time you upgrade Active Admin, you should run this command.
## will_paginate compatibility
If you use `will_paginate` in your app, you need to configure an initializer for
Kaminari to avoid conflicts. Put this in `config/initializers/kaminari.rb`
Kaminari.configure do |config|
config.page_method_name = :per_page_kaminari
end
Version data entries
47 entries across 47 versions & 2 rubygems