ActiveTrail

Provides integration between ActiveAdmin and Trailblazer, cool hun?!

Disclaimer

This is a BETA piece of software, please, don't use in production (yet)!

It won't work until some PRs got merged on upstream repos:

• [ ] Formtastic (Discover fields on a form object not just ActiveRecord) https://github.com/justinfrench/formtastic/pull/1142
• [ ] Reform (Expose contract fields) https://github.com/apotonick/reform/pull/212
• [ ] Trailblazer (Feature: Add operation collection) https://github.com/apotonick/trailblazer/pull/36
• [ ] Trailblazer (Feature: Add pagination and scope to collection) https://github.com/apotonick/trailblazer/pull/39
• [ ] Bonus! Trailblazer (Feature: Add authorization) https://github.com/apotonick/trailblazer/pull/41

In meanwhile you can use my forks:

gem "trailblazer", github: "fernandes/trailblazer", branch: "master"
gem "reform", github: "fernandes/reform", branch: "feature/expose_contract_fields"
gem "formtastic", github: "fernandes/formtastic", branch: "feature/get_fields_from_form_object"

I'm keeping my branches even with upstream's util everything is ok.

Installation

Add this line to your application's Gemfile:

gem 'activetrail'

And then execute:

$ bundle

Or install it yourself as:

$ gem install activetrail

Usage

In your app/admin/book.rb you need to customize your controller to make ActiveAdmin use Trailblazer, and ActiveTrail provides an easy way to make this integration happen! Just edit your resource like this:

ActiveAdmin.register Book do
  # everything happens here :D
  controller do
    include ActiveTrail::Controller
  end
end

You need to implement Book::(Create|Update|Index|Show) in your operation so everything works fine. If you need an example, check ActiveTrail's Book Operation used on its test suite

Known Issues

1. Just works with single Models. (Maybe works, maybe not with releationship, but we still do not support).
2. Do not support batch operations.

Development

After checking out the repo, run bin/setup to install dependencies. Then, run bin/console for an interactive prompt that will allow you to experiment.

To install this gem onto your local machine, run bundle exec rake install.

To release a new version, update the version number in version.rb, and then run bundle exec rake release to create a git tag for the version, push git commits and tags, and push the .gem file to rubygems.org.

Contributing

1. Fork it ( https://github.com/fernandes/activetrail/fork )
2. Create your feature branch (git checkout -b feature/my-new-feature)
3. Commit your changes (git commit -am 'Add some feature')
4. Push to the branch (git push origin feature/my-new-feature)
5. Create a new Pull Request

Always test against ActiveAdmin and Trailblazer latest release and master branch.