Rails plugin to add extra searching functionality to models.
Ruby JavaScript
Switch branches/tags
Nothing to show
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
spec actually, as_json is what we want, but to_json need to be called on t… Dec 7, 2011
LICENSE initial import Mar 12, 2008
Rakefile initial import Mar 12, 2008
TODO filling readme Mar 19, 2008
init.rb adding require statement so it gets loaded properly as a rails plugin Mar 13, 2008



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://github.com/ryanb/searchify.git

Otherwise you can install it with this command:

	git clone --depth=1 git://github.com/ryanb/searchify.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.

	Product.search(:name => 'Puzzle', :description => '%forest%') # use percent sign for partial search
	Product.search(:all => 'blue puzzle') # searches for partial word "blue" and "puzzle" in all columns
	Product.search(:created_at_from => '2008-01-01', :created_at_to => '2008-02-01')
	Product.search(:price_operator => '<', :price => '40') # changes the comparison operator
	Product.search(:page => 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:

	Category.search(:products_name => 'Big Ben') # finds all categories with a product called Big Ben
	Category.search(:all => '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