meta_search 0.9.11 → 1.0.0

data/CHANGELOG

@@ -1,3 +1,6 @@
+Changes since 0.9.11 (2011-01-06):
+  * Doc updates only.
+
 Changes since 0.9.10 (2010-11-18):
   * Skip attempts to sort if someone passes an empty string to meta_sort
   * Allow conditions on search_methods, (attr|assoc)_(un)?searchable using :if.

data/README.rdoc

@@ -273,12 +273,12 @@ MetaSearch adds a helper for this:
 lets you sandwich a list of fields, each in hash format, between the attribute and the usual
 options hash. See MetaSearch::Helpers::FormBuilder for more info.
 
-=== check_boxes and collection_check_boxes
+=== checks and collection_checks
 
 If you need to get an array into your where, and you don't care about parameter order,
 you might choose to use a select or collection_select with multiple selection enabled,
 but everyone hates multiple selection boxes. MetaSearch adds a couple of additional
-helpers, +check_boxes+ and +collection_check_boxes+ to handle multiple selections in a
+helpers, +checks+ and +collection_checks+ to handle multiple selections in a
 more visually appealing manner. They can be called with or without a block. Without a
 block, you get an array of MetaSearch::Check objects to do with as you please.
 
@@ -286,7 +286,7 @@ With a block, each check is yielded to your template, like so:
 
   <h4>How many heads?</h4>
   <ul>
-    <% f.check_boxes :number_of_heads_in,
+    <% f.checks :number_of_heads_in,
       [['One', 1], ['Two', 2], ['Three', 3]], :class => 'checkboxy' do |check| %>
       <li>
         <%= check.box %>
@@ -363,6 +363,50 @@ Excluded attributes on a model will be honored across associations, so if an Art
 Then your call to <tt>Article.search</tt> will allow <tt>:comments_body_contains</tt>
 but not <tt>:comments_user_id_equals</tt> to be passed.
 
+=== Conditional access to searches
+
+<tt>search_methods</tt>, <tt>attr_searchable</tt>, <tt>attr_unsearchable</tt>,
+<tt>assoc_searchable</tt>, and <tt>assoc_unsearchable</tt> all accept an <tt>:if</tt>
+option. If present, it should specify a Proc (or other object responding to <tt>call</tt>)
+that accepts a single parameter. This parameter will be the instance of the MetaSearch::Builder
+that gets created by a call to Model.search. Any unused search options (the second hash param)
+that get passed to Model.search will be available via the Builder object's <tt>options</tt>
+reader, and can be used for access control via this proc/object.
+
+Example:
+
+  assoc_unsearchable :notes,
+                     :if => proc {|s| s.options[:access] == 'blocked' || !s.options[:access]}
+
+=== Localization
+
+MetaSearch supports i18n localization in a few different ways. Consider this abbreviated
+example "flanders" locale:
+
+  flanders:
+    activerecord:
+      attributes:
+        company:
+          name: "Company name-diddly"
+        developer:
+          name: "Developer name-diddly"
+          salary: "Developer salary-doodly"
+    meta_search:
+      or: 'or-diddly'
+      predicates:
+        contains: "%{attribute} contains-diddly"
+        equals: "%{attribute} equals-diddly"
+      attributes:
+        company:
+          reverse_name: "Company reverse name-diddly"
+        developer:
+          name_contains: "Developer name-diddly contains-aroonie"
+
+First, MetaSearch will use a key found under meta_search.attributes.model_name.attribute_name,
+if it exists. As a fallback, it will use a localization based on the predicate type, along with
+the usual ActiveRecord attribute localization (the activerecord.attributes.model_name keys above).
+Additionally, a localized "or" can be specified for multi-column searches.
+
 == Contributions
 
 There are several ways you can help MetaSearch continue to improve.

data/VERSION

@@ -1 +1 @@
-0.9.11
+1.0.0

data/meta_search.gemspec

@@ -5,11 +5,11 @@
 
 Gem::Specification.new do |s|
   s.name = %q{meta_search}
-  s.version = "0.9.11"
+  s.version = "1.0.0"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Ernie Miller"]
-  s.date = %q{2011-01-06}
+  s.date = %q{2011-01-17}
   s.description = %q{
       Allows simple search forms to be created against an AR3 model
       and its associations, has useful view helpers for sort links

data/test/test_view_helpers.rb

@@ -17,19 +17,7 @@ class TestViewHelpers < ActionView::TestCase
   include router.url_helpers
 
   def setup
-    @controller = Class.new do
-
-      attr_reader :url_for_options
-      def url_for(options)
-        @url_for_options = options
-        "http://www.example.com"
-      end
-
-      def _routes
-        @routes ||= ActionDispatch::Routing::RouteSet.new
-      end
-    end
-    @controller = @controller.new
+    @controller = ActionView::TestCase::TestController.new
   end
 
   context "A search against Company and a search against Developer" do

metadata

@@ -3,10 +3,10 @@ name: meta_search
 version: !ruby/object:Gem::Version 
   prerelease: false
   segments: 
+  - 1
   - 0
-  - 9
-  - 11
-  version: 0.9.11
+  - 0
+  version: 1.0.0
 platform: ruby
 authors: 
 - Ernie Miller
@@ -14,7 +14,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2011-01-06 00:00:00 -05:00
+date: 2011-01-17 00:00:00 -05:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency