It’s been a long time since we released a new version of Active Admin. There were always this nice-to-have-in-the-next-gem feature or bug fix that pushed away the release of the 0.5.0 version for months. Anyway, here it is, please welcome Active Admin 0.5.0!

What’s new in Active Admin 0.5.0

Batch Actions

Users can now select many records and perform an action against those. This is great for Deleting or Archiving many records at once or for Merging records together.

Wanna play with it? Have a look at the Batch Actions Documentation.

Dashboards are deprecated. Root routes are customisable.

Dashboards are deprecated in 0.5.0 and will be removed in 0.6.0. They can be replaced with Active Admin Pages and you dont have to have Dashboards in all namespaces.

The root route was hardcoded to dashboard#index, it can now be customised per namespace.

# All namespace root is the index action of the DashboardController
config.root_to = "dashboard#index"

config.namespace :admin do |admin_namespace|
  # /admin renders the AdminAccountController index action
  admin_namespace.root_to = "accounts#index"
end

More view Components and Factories

You can now use your own Arbre Components to customise the Footer, TitleBar, Header and UtilityNav.

ActiveAdmin.setup do |config|
  config.view_factory.footer = MyFooter
end
class MyFooter < ActiveAdmin::Component
  def build?
    super(id: "footer")
    para "Copyright #{Date.today.year} Reverb Media Group"
  end
end

The view factory can be customised per namespace.

A lot of bug fixes and other improvements

Active Admin 0.5.0 contains a lot of compatibility issues with Rails 3.2 & the asset pipeline, I18n enhancements, fixes on Forms, customisable CSV separators and so on…

Also, Arbre, the DOM implementation in Ruby, was extracted into its own gem.

Upgrading from 0.4.X

Just update the gem version to 0.5.0 and regenerate the assets if needed. No new files or migrations. It should just work. To regenerate the assets:

$> rails generate active_admin:assets

Batch Actions are disabled by default, so you might want to update the activeadmin initialiser to enable them. Add the following to config/initializers/active_admin.rb:

# == Root
# Set the action to call for the root path. You can set different
# roots for each namespace.
# Default:
# config.root_to = 'dashboard#index'

# == Batch Actions
# Enable and disable Batch Actions
config.batch_actions = true

# == CSV options
# Set the CSV builder separator (default is ",")
# config.csv_column_separator = ','

Thank you!

Active Admin 0.5.0, it’s 552 new commits, 140 Pull Requests, 88 contributors. Thank you for reporting issues and for contributing to Active Admin.

We’d like to welcome James McKinney to the Active Admin Team and thank him for the amazing job he’s doing (on the day he joined the team he closed ~90 issues and merged ~20 pull requests!). James is moving Active Admin forward at lightning speed. Thank you James.

What’s next?

Documentation

Active Admin Documentation deserves a lot of love. People have been really active updating the Wiki while the “official” documentation fails to document all the available features and options. So, we need to work a lot on the documentation and your help is more than welcome! :)

Modularity

We want to split out the Active Admin project into multiple gems so that people can leave out what they don’t need. We already extracted Arbre into its own gem and we’d like to do the same for comments, batch action, devise authentication and so on.

Moving those features into their own gems would force us to make Active Admin more “pluggable” and would make it easier for people to create Active Admin plugins.

Multi ORM support!

People have been patching Active Admin for quite a long time to get it working with Mongoid and mongomapper. In the long term, we’d like to make Active Admin ORM agnostic so that it could support MongoID, DataMapper… on top of ActiveRecord.

We hope you’re gaining a boost of productivity using Active Admin as much as we do. Thank you for using it and contributing to it!