Awesome
ActiveAdmin Addons
ActiveAdmin Addons will extend your ActiveAdmin and enable a set of addons you can optionally use to improve the ActiveAdmin UI and make it awesome.
What you get:
Rows/Columns
- Shrine Image: show thumbnails on your show/index views.
- AASM Integration: nice looking tags for states.
- Rails Enum Integration: nice looking tags for enums.
- Boolean Values: beautiful boolean values.
- Toggleable Booleans: have switches to toggle values directly at the index
- Number Formatting: format you currencies with ease.
- List: show Arrays or Hashes like a list.
Inputs
- Select2 Input: cool select boxes for everyone.
- Tag Input: to add tags using select2.
- Search Select Input: easy ajax search with activeadmin.
- Selected List Input: to handle your many to many associations.
- Nested Select Input: to build related select inputs.
- Color Picker Input: select colors from a pretty popup.
- Date Time Picker Input: pick date and time comfortably.
Filters
- Numeric Range Filter: filter your results using a numeric range (i.e. age between 18-30).
- Date Time Picker Filter: filter your results using a datetime range.
- Search Select Filter: filter your results using the ajax select input.
Themes
- No Theme: ActiveAdmin default style.
Installation
Add this line to your application's Gemfile:
gem 'activeadmin_addons'
And then execute:
$ bundle
After that, run the generator:
$ rails g activeadmin_addons:install
Check here to see more information about this generator.
Default changes to behaviour
Installing this gem will enable the following changes by default:
- The default date input will be
:datepickerinstead of:date_select - Select filters will show translated values when used with Rails built-in
enums - All select boxes will use select2
Addons
Rows/Columns
Images
Display images in the index and show views. This implementation supports Shrine.
<img src="./docs/images/paperclip-image-column.png" height="380" />AASM Integration
You can show aasm values as active admin tags.
<img src="./docs/images/aasm-integration-row.png" height="150" />Rails Enum Integration
You can show Rails' built in enums as active admin tags.
Boolean Values
Modifies how boolean values are displayed.
<img src="./docs/images/bool-column.png" height="250" />Toggleable Boolean Columns
Have switches to toggle values directly at the index
<img src="./docs/images/toggle-bool-column.gif" height="250" />Number Formatting
You can show numbers with format supported by Rails NumberHelper
<img src="./docs/images/number-column.png" height="250" />List
You can show Array or Hash values as html lists.
Markdown
You can render text as markdown.
<img src="./docs/images/markdown-row.png" height="250" />Inputs
Slim Select Input
With Slim Select the select control looks nicer, it works great with large collections.
<img src="./docs/images/slim-select.gif" />Tag Input
Using tags input, you can add tags using slim select.
<img src="./docs/images/slim-select-tags.gif" />Selected List Input
This form control allows you to handle your many to many associations.
<img src="./docs/images/slim-select-selected-list.gif" />Search Select Input
Using search_select input, you can easily add ajax search to activeadmin.
Nested Select Input
Using nested_select input, you can build related select inputs.
Color Picker Input
You can pick colors using JQuery Palette Color Picker
f.input :color, as: :color_picker
Date Time Picker Input
You can pick dates with time using the xdan's jQuery Plugin Date and Time Picker
f.input :updated_at, as: :date_time_picker
Filters
Numeric Range Filter
To filter based on a range of values you can use numeric_range_filter like this:
filter :number, as: :numeric_range_filter
Date Time Picker Filter
To filter based on a range of datetimes you can use date_time_picker_filter like this:
filter :created_at, as: :date_time_picker_filter
Search Select Filter
You can use the ajax select input to filter values on index view like this:
filter :category, as: :search_select_filter
Themes
NO Theme
Use default active_admin theme.
Publishing
On a new branch:
- Change
VERSIONinlib/activeadmin_addons/version.rb. Note that beta versions should have a.betasuffix (e.g.1.0.0.beta.1). - Change
"version"inpackage.jsonto the same version. Note that beta versions should have a-betasuffix (e.g.1.0.0-beta.1). - Change
Unreleasedtitle to current version inCHANGELOG.md. - Run
bundle install. - Open a new PR with those changes.
- Once the PR is merged, checkout to master and pull the changes.
- Create tag. For example:
git tag v1.0.0. - Push tag. For example:
git push origin v1.0.0. This will trigger the CI to publish the new version to npm and rubygems.
Contributing
- Fork it
- Create your feature branch (
git checkout -b my-new-feature) - Commit your changes (
git commit -am 'Add some feature') - Push to the branch (
git push origin my-new-feature) - Create new Pull Request
If you want to collaborate, please check the rules first.
Credits
Thank you contributors!
<img src="http://platan.us/gravatar_with_text.png" alt="Platanus" width="250"/>activeadmin_addons is maintained by platanus.
License
ActiveAdminAddons is © 2021 Platanus, spa. It is free software and may be redistributed under the terms specified in the LICENSE file.