Project

ransack_ui

0.02
No release in over 3 years
Low commit activity in last 3 years
There's a lot of open issues
Framework for building a search UI with Ransack
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Runtime

 Project Readme

Ransack UI

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

Please note: this project is still in alpha and the following instructions are not yet complete/fully working.

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)