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
- Paperclip Attachment: show file icons on your show/index views.
- Paperclip Image: show thumbnails on your show/index views.
- AASM Integration: nice looking tags for states.
- Enumerize and 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).
- Search Select Filter: filter your results using the ajax select input.
Installation
Add this line to your application's Gemfile:
gem 'activeadmin_addons'And then execute:
$ bundleAfter that, run the generator:
$ rails g activeadmin_addons:installCheck 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 - Filters and selects will offer integration with enumerize
- All select boxes will use select2
Addons
Rows/Columns
Paperclip Attachment
Displays a paperclip link with attachment related icon into index and show views.
Paperclip Image
Displays a paperclip image into index and show views
AASM Integration
You can show aasm values as active admin tags.
Enumerize and Rails Enum Integration
You can show Rails' built in enums or enumerize values as active admin tags.
Boolean Values
Modifies how boolean values are displayed.
Toggleable Boolean Columns
Have switches to toggle values directly at the index
Number Formatting
You can show numbers with format supported by Rails NumberHelper
List
You can show Array or Hash values as html lists.
Inputs
Select2 Input
With select2 the select control looks nicer, it works great with large collections.
Tag Input
Using tags input, you can add tags using select2.
Selected List Input
This form control allows you to handle your many to many associations.
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
Search Select Filter
You can use the ajax select input to filter values on index view like this:
filter :category_id, as: :search_select_filter
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!
activeadmin_addons is maintained by platanus.
License
ActiveAdminAddons is © 2016 Platanus, spa. It is free software and may be redistributed under the terms specified in the LICENSE file.