Your First Admin Resource: AdminUser

This guide assumes you’ve used the default AdminUser model.

Start by logging into your admin section at http://localhost:3000/admin. The migration created a user with the credentials [email protected] / password.

Your first step is to generate the section to manage your admin users:

rails generate active_admin:resource AdminUser

This will create an empty file:

#app/admin/admin_user.rb
ActiveAdmin.register AdminUser do
end

Index

Loading http://localhost:3000/admin/admin_users/ will show a pretty noisy default index page. So our first step will be to clean it up:

#app/admin/admin_user.rb
ActiveAdmin.register AdminUser do
  index do
    column :email
    column :current_sign_in_at
    column :last_sign_in_at
    column :sign_in_count
    default_actions
  end
end

Check out the documentation for index pages to it tweak some more: http://activeadmin.info/documentation.html#Customizing%20the%20Index%20Page

Form

Now comes the time to create your first real administrator. The “New Admin User” button also leads to a page with too many fields. Let’s simplify it as well:

#app/admin/admin_user.rb
ActiveAdmin.register AdminUser do
  #...
  form do |f|
    f.inputs "Admin Details" do
      f.input :email
    end
    f.buttons
  end
end

The current form doesn’t let you create a valid admin user instance because the password isn’t present. But instead of forcing administrators to set find a dummy password and then send an email to the new admin, we’ll let Devise do it’s thing.

This approach requires that your admin model is devise ... :recoverable. We’ll make the password for new admin users optional for when creating a new user and we’ll force Devise to send the password recovery email:

#/app/models/admin_user.rb
  after_create { |admin| admin.send_reset_password_instructions }
  def password_required?
    new_record? ? false : super
  end

So when you create a new admin, an email is automatically sent to your new admin. Until the person clicks the link to set his password, it’s impossible to log into the account.

Customizing the show form is left to your discretion :-)