Filterrific is a Rails Engine plugin that makes it easy to filter, search, and sort your ActiveRecord lists:
- Makes heavy use of ActiveRecord Scopes
- ActionController helpers to shuttle filter params from ActionView forms to ActiveRecord based models, and to return matching records back from ActiveRecord to ActionView.
- Form helpers to build powerful search and filter forms with ease.
- Javascript assets to auto-submit filter form on change via AJAX.
- Image asset to show a spinner in the Filterrific form when new records are being loaded via AJAX.
- API option to use Filterrific with Rails API mode. Just use
gem 'filterrific', require: 'filterrific_api'in your Gemfile.
gem install filterrific
or with bundler in your Gemfile:
gem 'filterrific'
Make sure to go to the fantastic Filterrific documentation to find out more!
Every commit to Filterrific is automatically tested against the following scenarios:
| Filterrific version | Rails version | Ruby environments | Database adapters | Build status |
|---|---|---|---|---|
| 5.x | Rails 5.x, 6.x, 7.x | MRI 2.0.0, 2.1.7, 2.2.3, 2.3.1 | mysql2, postgresql |  |
| 4.x | Rails 4.x | MRI 2.0.0, 2.1.7, 2.2.3, 2.3.1 | mysql, mysql2, postgresql, sqlite3 |  |
| 3.x | Rails 3.2 | MRI 2.0.0, 2.1.7 | mysql, mysql2, postgresql, sqlite3 | Not tested |
| 2.x | Rails 3.2 | MRI 1.9.3 | mysql, mysql2, postgresql, sqlite3 | Not tested |
| 1.x | < 3.2 | MRI <= 1.9.3 | mysql, mysql2, postgresql, sqlite3 | Not tested |
Please post questions related to usage at StackOverflow under the filterrific tag.
If you think you've found a bug, or have a feature request, then create an issue here on Github. You'll make my job easier if you follow these guidelines:
- Please keep in mind that I do this in my spare time. To you this software is free as in
beer, to me it's free as inbaby. I appreciate it if you first do everything you can on your own: read the detailed Filterrific documentation, look for similar issues on StackOverflow, search the internets, etc. - If you're stuck, give me sufficient context so that I have a chance to identify the issue:
- what version of filterrific are you using? (look in your
Gemfile.lock) - what version of Rails are you using? (look in your
Gemfile.lock) - what version of Ruby are you using? (run
ruby -vin your app root)
- what version of filterrific are you using? (look in your
- If you get an exception, include the entire stack trace, including the error message.
- Include any relevant code snippets (your model, controller, and view code).
- When pasting code, please use markdown code formatting. It will be much easier to read.
- Documentation
- Live demo using classic Rails views.
- Live JSON API demo using React and Mobx.
- Changelog
- Source code (github)
- Issues
- Questions on Stack Overflow (tagged
filterrific) - Rubygems.org
Copyright (c) 2010 - 2019 Jo Hund. See (MIT) LICENSE for details.