rails-simple-search 0.9.1 → 0.9.2

data/README

@@ -1,67 +1,67 @@
 rails-simple-search
 ===================
 
-rails-simple-search is a Ruby gem. It helps you quickly implement searching/filtering function for your web site.
-This plugin has paginating feature built in. If you're not looking for a full-text searching solution, this plugin will
-most probably satisfy all your searching requirement.
+rails-simple-search is a Ruby gem. It helps you quickly implement searching/filtering function for your web site. This plugin has paginating feature built in. If you're not looking for a full-text searching solution, this plugin will most probably satisfy all your searching requirement.
+
+From time to time, I need to build pages to show a list of narrowed down records from a database table by giving some searching criteria on some columns of the table and/or of some referencing tables. Before I implemented this plugin, I usually do the searching in the following way:
 
-From time to time, I need to build pages to show a list of narrowed down records from a database table by giving 
-some searching criteria on some columns of the table and/or of some referencing tables. Before I implemented this
-plugin, I usually do the searching in the following way:
     1) Use <%= form_tag %> to build a form in the view
     2) Get the searching criteria from the params hash individually in the controller and put them into instance variable to be used in view
     3) Build the SQL WHERE clause and sometimes the JOIN clause according to the values from the form
     4) Run the find(:all, :conditions => [xxxxxx], :joins => "yyyyyy") with the WHERE and JOIN clauses
 
-After having used this pattern a few times, I realized I could DRY it to make future coding of this kind of searching
-much simpler. That's where the rails-simple-search plugin comes in. 
+After having used this pattern a few times, I realized I could DRY it to make future coding of this kind of searching much simpler. That's where the rails-simple-search plugin comes in. 
 
-Now implementing the searching/filter page is a lot easier for me. You're see how easy it is by taking a look at the 
-following example. I may give more examples in the future when I have some spare time. 
+Now implementing the searching/filter page is a lot easier for me. You're see how easy it is by taking a look at the following example. I may give more examples in the future when I have some spare time. 
 
 
 Example
 =======
 
-Let's suppose we have models of User, Address, Post and Comment.
-User model has_one address and has_many posts; Post model has_many comments
-We'd like to find users according to any combination of the following criteria:
+Let's suppose we have models of User, Address, Post and Comment. User model has_one address and has_many posts; Post model has_many comments. We'd like to search for users according to any combination of the following criteria:
 
-              1) part of the user's email addrsss
-              2) state of the user's address
-              3) part of the name of any authors who commented the user's any posts
+    1) part of the user's email addrsss
+    2) state of the user's address
+    3) part of the name of any authors who commented the user's any posts
 
 The following is how we implement this searching function with rails-simple-search:
 
 Code in model (app/model/search.rb):
 
-      class Search < RailsSimpleSearch::Base
-      end
+    class Search < RailsSimpleSearch::Base
+    end
 
 Code in controller:
 
-      @search = Search.new(User, params[:search])
-      @users = @search.run(:order => 'email')
+    @search = Search.new(User, params[:search])
+    @search.order = 'email'  # optional
+    @users = @search.run
 
 Code in views:
 
-     <% form_for @search do |f| %>
+    <% form_for @search do |f| %>
+
+      <%=f.label :email %>
+      <%=f.text_field :email %>
+
+      <%=f.label :state%>
+      <%=f.select "address.state_id", [['AL', 1], ...] %>  <!-- address is an association of model User -->
 
-       <%=f.label :email %>
-       <%=f.text_field :email %>
+      <%=f.label :post%>
+      <%=f.text_field "posts.comments.author" %>           <!-- the associations could go even deeper, isn't it POWERFUL? -->
 
-       <%=f.label :state%>
-       <%=f.select "address.state_id", [['AL', 1], ...] %>  <!-- address is an association of model User -->
+      <%=f.submit %>
+    <% end %>
 
-       <%=f.label :post%>
-       <%=f.text_field "posts.comments.author" %>           <!-- the associations could go even deeper, isn't it POWERFUL? -->
+    <% @users.each do |user| %>
+     <%= # show the attributes of user %>
+    <% end %>
 
-       <%=f.submit %>
-     <% end %>
+Note
+====
+For rails 2.x.x applications, you might want to use the version 0.9.0. Since version 0.9.1, this gem started to support rails 3 now.
 
-     <% @users.each do |user| %>
-      <%= # show the attributes of user %>
-     <% end %>
+There is a real demo application which you can download and run immediately: https://github.com/yzhanginwa/demo_app_for_rails_simple_search
 
 
 Copyright (c) 2012 [Yi Zhang], released under the MIT license

data/lib/rails-simple-search.rb

@@ -30,7 +30,7 @@ module RailsSimpleSearch
     end
 
     def pages
-      (count == 0)? 0 : (count / @config[:per_page].to_i + 1) 
+      (count == 0)? 0 : (count * 1.0 / @config[:per_page]).ceil 
     end
 
     def pages_for_select
@@ -40,6 +40,10 @@ module RailsSimpleSearch
     def add_conditions(h={})
       @criteria.merge!(h)
     end
+
+    def order=(str)
+      @order = str
+    end
   
     def conditions
       run_criteria
@@ -51,7 +55,7 @@ module RailsSimpleSearch
       @joins_str
     end
 
-    def run(option={})
+    def run
       run_criteria
       if @config[:paginate]
         @count = @model_class.count({:select => "distinct #{@model_class.table_name}.#{@model_class.primary_key}", 
@@ -65,12 +69,14 @@ module RailsSimpleSearch
         limit = @config[:limit]
       end
 
-      @model_class.all({:select => "distinct #{@model_class.table_name}.*", 
-                        :conditions => @conditions,
-                        :joins => @joins_str, 
-                        :offset => @config[:offset],
-                        :limit => @config[:limit] }.merge(option)
-      )
+      execute_hash = {:select => "distinct #{@model_class.table_name}.*", 
+                      :conditions => @conditions,
+                      :joins => @joins_str, 
+                      :offset => offset,
+                      :limit => limit
+      }
+      execute_hash[:order] = @order if @order
+      @model_class.all(execute_hash)
     end
 
     private

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: rails-simple-search
 version: !ruby/object:Gem::Version
-  version: 0.9.1
+  version: 0.9.2
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-03-11 00:00:00.000000000Z
+date: 2012-06-05 00:00:00.000000000 Z
 dependencies: []
 description: this version starts to support rails 3
 email: yzhang.wa@gmail.com
@@ -39,7 +39,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 1.8.15
+rubygems_version: 1.8.24
 signing_key: 
 specification_version: 3
 summary: A very simple and light get to quick build search function in rails