/ransack_ui

Framework for building a search UI with Ransack

Primary LanguageHTMLMIT LicenseMIT

Ransack UI

Provides HTML templates and JavaScript to build a fully functional advanced search form using Ransack.

Installation

Add this line to your application's Gemfile:

gem 'ransack_ui'

And then execute:

$ bundle

Or install it yourself as:

$ gem install ransack_ui

Usage

Make your model ransackable (if you name associations, it will enable you to search them aswell).

has_ransackable_associations %w(account tags)
ransack_can_autocomplete

In your controller, where you'd like to add search functionality, add the following before_filter hook. You can change the 'index' action if needed.

before_filter :load_ransack_search, :only => :index

Insert the following helper call into your rails view code where you'd like the search form to appear.

= ransack_ui_search

Now you can start playing with the results.

Contributing

  1. Fork it
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create new Pull Request

Acknowledgements

  • Ernie Miller (@ernie) - Creator of ransack (https://github.com/ernie/ransack)
  • Nathan Broadbent (@ndbroadbent)
  • Steve Kenworthy (@steveyken)
  • Daniel O'Connor (@CloCkWeRX)