The idea is that you provide the query and plugin does the rest (splits query to keywords and compose where statement).

This can be very useful in case you just want to filter list of records by some query, you have autocomplete field, … or something similar.

Example

View

  <% form_tag request.path, :method => 'get' do %>
    <%= text_field_tag :query, params[:query] %>
  <% end %>

Model

  class User < ActiveRecord::Base
    acts_as_simply_searchable
  end

  # Columns: id, login, email, crypted_password, salt

Controller

  class UsersController < ApplicationController
    def index
      @users = User.simple_search(params[:query]).all
    end
  end

Query examples

Simple query

  User.simple_search("vlado")
  # => SELECT * FROM "users" WHERE (users.id LIKE '%vlado%' OR users.login LIKE '%vlado%' OR users.email LIKE '%vlado%' OR users.crypted_password LIKE '%vlado%' OR users.salt LIKE '%vlado%')

You can also provide :columns => :column1, :column2, ... option to limit search only to those columns

  class User < ActiveRecord::Base
    acts_as_simply_searchable :columns => :login, :email
  end

  User.simple_search("vlado")
  # => SELECT * FROM "users" WHERE (users.login LIKE '%vlado%' OR users.email LIKE '%vlado%')

More complex query

  User.simple_search("vlado, cingel")
  # will search for users matching 'vlado' and 'cingel' keywords
  # => SELECT * FROM "users" WHERE ((users.login LIKE '%vlado%' OR users.email LIKE '%vlado%') AND (users.login LIKE '%cingel%' OR users.email LIKE '%cingel%'))

NOTE: With proper use of indexes this plugin can work quite well in most cases, but in case you have a large and complex database it is usually much better idea to use some search daemon like Thinking Sphinx.

More info

http://github.com/cingel/simple_search

* you have area where users input phone numbers in many different formats
* output phone numbers in specific format
* you need to send SMS messages from your app
* …

You can initialize new Phone object with Phone.new

  Phone.new('5125486', '91', '385')

or

  Phone.new(:number => '5125486', :area_code => '91', :country_code => '385')

Parsing is done using Phone.parse method

    Phone.parse '091/512-5486', :country_code => '385'
    Phone.parse '(091) 512 5486', :country_code => '385'

It is smart to set default contry code first so you don’t have to provide it as option every time

    Phone.default_country_code = '385'
    Phone.parse '091/512-5486'
    Phone.parse '(091) 512 5486'

Fow now, Phone works only for Croatian, Slovenian, Bosnian and Serbian phone numbers, but Tomislav is collecting data to support other countries.

Go check it out