rails engine plugin for filtering active_record model objects
Ruby HTML JavaScript CSS
Latest commit 1a4b673 Sep 13, 2016 @berk switching to bootstrap
Permalink
Failed to load latest commit information.
app
config Bringing back filters to live Aug 31, 2016
lib more customization options Sep 12, 2016
script
spec
test
.gitignore
.rspec
.watchr fixed specs and added some example for serialization Apr 18, 2012
CHANGELOG.rdoc
Gemfile
Gemfile.lock
MIT-LICENSE
README.rdoc
Rakefile
will_filter.gemspec minor changes Aug 15, 2013

README.rdoc

WillFilter

will_filter is a Rails engine plugin that provides a GUI for filtering your ActiveRecord models.

Preamble

If you ever had to build an admin tool for your web site that displayed a list of objects that can be filtered using various criteria, this plugin will make your life easier. Adding a filtered page can now be a matter of adding two lines of code - one to your controller and one to your view. See examples below.

Installation Instructions

Add the following gems to your Gemfile:

gem 'will_filter'
gem 'kaminari'

And run:

$ bundle

To configure and initialize will_filter engine, run the following commands:

$ rails generate will_filter  
$ rake db:migrate

At the top of your routes.rb file, add the following line:

mount WillFilter::Engine => "/will_filter"

Examples

To add a filtered result-set to your controller use the following method call:

class UsersController < ApplicationController

  def index
    @users = User.filter(:params => params)    
  end

end

Note: 'User' is a Rails ActiveRecord model

Now all you have to do is create a view for this action and add the following tag where you want the filter to be rendered:

<%= will_filter_tag(@users) %>

And optionally you can do (for results table):

<%= will_filter_table_tag(@users) %>

That's it. This will render a filter box with various conditions, operators and values for the model object you selected.

Documentation

Please read the following document to learn more about filter customization:

github.com/berk/will_filter/wiki/Customizing-Filters

Please read the following document to learn more about table tag customization:

github.com/berk/will_filter/wiki/Customizing-Table-View

Dummy Application

This plugin comes with a dummy test project. To try out some of the examples, run the following commands:

$ git clone git://github.com/berk/will_filter.git
$ cd will_filter/test/dummy  
$ rake db:migrate 
$ rake samples:init
$ rails server

Open your browser and point to:

http://localhost:3000

If you have any questions, comments or suggestions, email me at theiceberk@gmail.com

Authors and credits

Authors

Michael Berkovich