Filterrific

Filterrific is a Rails Engine plugin that makes it easy to filter, search, and sort your ActiveRecord lists:

Features

  • 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.

A filterrific enhanced list


Installation

gem install filterrific

or with bundler in your Gemfile:

gem 'filterrific'

Usage

Make sure to go to the fantastic Filterrific documentation to find out more!

Compatibility

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 Build Status
4.x Rails 4.x MRI 2.0.0, 2.1.7, 2.2.3, 2.3.1 mysql, mysql2, postgresql, sqlite3 Build Status
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

Guidelines for submitting issues

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 in baby. 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 -v in your app root)
  • 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.

Resources

Build Status

Code Climate

License

MIT licensed.

Copyright (c) 2010 - 2023 Jo Hund. See (MIT) LICENSE for details.