Find file
Fetching contributors…
Cannot retrieve contributors at this time
75 lines (43 sloc) 2.69 KB
This is a Rails plugin which adds some search functionality to models. It also includes a javascript file and helper methods for building a dynamic search form.
If you are running edge rails you can install the plugin straight from the repository:
script/plugin install git://
Otherwise you can install it with this command:
git clone --depth=1 git:// vendor/plugins/searchify
To use the dynamic form you need to install a javascript file using this command:
script/generate searchify_javascript
This plugin uses the "paginate" method to perform a search on the model, so you need to install the will_paginate plugin/gem.
Currently only MySQL is fully supported. It may work on other database engines, just not as well.
You can use the "searchify" method in your model class to enable it for searching. Pass the columns you want to search to this method.
class Product < ActiveRecord::Base
searchify :name, :description, :price, :created_at, :discontinued
You can then use the "search" method to search all or some of these columns. Here are some examples. => 'Puzzle', :description => '%forest%') # use percent sign for partial search => 'blue puzzle') # searches for partial word "blue" and "puzzle" in all columns => '2008-01-01', :created_at_to => '2008-02-01') => '<', :price => '40') # changes the comparison operator => 5, :per_page => 20, :order => 'name') # pass other options besides conditions
The searchify also allows you to include associations in the search. For example:
class Category < ActiveRecord::Base
has_many :products
searchify :name, :products => [:name, :description]
To search the product columns you need to prefix them with "products_" like this: => 'Big Ben') # finds all categories with a product called Big Ben => 'puzzle') # product columns are included
The main benefit of this plugin is how easy it is to add a dynamic search. You can use the searchify_fields_for helper method to generate dynamic fields for searching. Like this:
<% form_tag products_path, :method => 'get' do %>
<%= searchify_fields_for Product %>
<p><%= submit_tag 'Search', :name => nil, :onclick => 'return searchify_submit()' %></p>
<% end %>
Make sure you have the prototype libraries included and it should allow you to dynamically add and remove fields. Pretty cool huh?
Copyright (c) 2008 Ryan Bates, released under the MIT license