activeadmin_addons
v2.0.0-beta.4
Set of addons to help with the activeadmin ui
0/weekUpdated 1 years agoMITUnpacked: 70.1 KB
Published by Platanus
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:
``ruby`
gem 'activeadmin_addons'
And then execute:
`bash`
$ bundle
After that, run the generator:
`bash`
$ 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 :datepicker instead of :date_select
* Select filters will show translated values when used with Rails built-in
* All select boxes will use select2
Addons
$3
#### Images
Display images in the index and show views. This implementation supports Shrine.
#### AASM Integration
You can show aasm values as active admin tags.
#### Rails Enum Integration
You can show Rails' built in enums 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.
#### Markdown
You can render text as markdown.
$3
#### Slim Select Input
With Slim Select the select control looks nicer, it works great with large collections.
#### Tag Input
Using tags input, you can add tags using slim select.
#### 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.
$3
You can pick colors using JQuery Palette Color Picker
`ruby`
f.input :color, as: :color_picker
$3
You can pick dates with time using the xdan's jQuery Plugin Date and Time Picker
`ruby`
f.input :updated_at, as: :date_time_picker
$3
#### Numeric Range Filter
To filter based on a range of values you can use numeric_range_filter like this:
`ruby`
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:
`ruby`
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:
`ruby`
filter :category, as: :search_select_filter
$3
#### NO Theme
Use default active_admin theme.
Publishing
On a new branch:
1. Change VERSION in lib/activeadmin_addons/version.rb. Note that beta versions should have a .beta suffix (e.g. 1.0.0.beta.1)."version"
2. Change in package.json to the same version. Note that beta versions should have a -beta suffix (e.g. 1.0.0-beta.1).Unreleased
3. Change title to current version in CHANGELOG.md.bundle install
4. Run .git tag v1.0.0
5. Open a new PR with those changes.
6. Once the PR is merged, checkout to master and pull the changes.
8. Create tag. For example: .git push origin v1.0.0
9. Push tag. For example: . This will trigger the CI to publish the new version to npm and rubygems.
Contributing
1. Fork it
2. Create your feature branch (git checkout -b my-new-feature)git commit -am 'Add some feature'
3. Commit your changes ()git push origin my-new-feature`)
4. Push to the branch (
5. 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 © 2021 Platanus, spa. It is free software and may be redistributed under the terms specified in the LICENSE file.