Permalink
Find file
Fetching contributors…
Cannot retrieve contributors at this time
75 lines (43 sloc) 2.69 KB
Searchify
=========
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.
Installation
------------
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
Requirements
------------
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.
Instructions
------------
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
end
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]
end
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