EasyFilters

This gem provides a simple API for defining dynamic persistent(in session) filters based on active record models. This was extracted from el_dia_backend

Installation

Add this line to your application's Gemfile:

    gem 'easy_filters'

And then execute:

    $ bundle

Usage

EasyFilters expects you to define the following methods:

class ArticlesFilter < ModelFilter

  # Default values for this filter.
  def self.defaults
    { body: nil, date_from: nil, date_to: nil }
  end

  # Model class to be filtered.
  def model
    Article
  end
end

• defaults: defines the fields that will be used for filtering and its defaults values
• model: returns the target class to be filtered

Customizing filtering strategy

For defining the parts of the query that will filter each each field, define a method named filter_by_#{field_name}. The field must be present in the defaults array.

Each filter_by_* method receives 2 params:

• scope: The actual query.
• value: The value for the current field

For example:

class ArticlesFilter < ModelFilter

  #(...) previously defined methods

  # Custom filter method for :body field.
  def filter_by_body(scope, value)
    matcher = "%#{value}%"
    scope.where('body like ? OR body like ?', matcher, matcher)
  end

  # The following 2 filter_by builds an from/to/between date filter:

  # Custom filter method for :date_from field.
  def filter_by_date_from(scope, value)
    scope.joins(:editions).where('editions.date >= ?', Date.parse(value))
  end

  # Custom filter method for :date_to field.
  def filter_by_date_to(scope, value)
    scope.joins(:editions).where('editions.date <= ?', Date.parse(value))
  end
end