@@ -49,7 +49,7 @@ include the following in your model class (specifiying the fields you want to ge <tt>acts_as_ferret :fields => [ :title, :description ]</tt> -now you can use ModelClass.find_by_contents(query) to find instances of your model +now you can use ModelClass.find_with_ferret(query) to find instances of your model whose indexed fields match a given query. All query terms are required by default, but explicit OR queries are possible. This differs from the ferret default, but imho is the more often needed/expected behaviour (more query terms result in README @@ -60,7 +60,7 @@ require 'rdig_adapter' # include the following in your model class (specifiying the fields you want to get indexed): # acts_as_ferret :fields => [ :title, :description ] # -# now you can use ModelClass.find_by_contents(query) to find instances of your model +# now you can use ModelClass.find_with_ferret(query) to find instances of your model # whose indexed fields match a given query. All query terms are required by default, but # explicit OR queries are possible. This differs from the ferret default, but imho is the more # often needed/expected behaviour (more query terms result in less results). lib/acts_as_ferret.rb @@ -169,7 +169,7 @@ module ActsAsFerret # Useful e.g. if you want to search across models or do not want to fetch # all result records (yet). # - # Options are the same as for find_by_contents + # Options are the same as for find_with_ferret # # A block can be given too, it will be executed with every result: # find_ids_with_ferret(q, options) do |model, id, score| lib/class_methods.rb @@ -29,8 +29,8 @@ module ActsAsFerret #:nodoc: # equals Ferret's internal similarity implementation) # :analyzer => 'Ferret::Analysis::StandardAnalyzer' # class name of the analyzer to use # :append_to_query => nil # proc taking a query object as argument, which will be called after generating the query. can be used to further manipulate the query used to find related documents, i.e. to constrain the search to a given class in single table inheritance scenarios - # ferret_options : Ferret options handed over to find_by_contents (i.e. for limits and sorting) - # ar_options : options handed over to find_by_contents for AR scoping + # ferret_options : Ferret options handed over to find_with_ferret (i.e. for limits and sorting) + # ar_options : options handed over to find_with_ferret for AR scoping def more_like_this(options = {}, ferret_options = {}, ar_options = {}) options = { :field_names => nil, # Default field names @@ -44,7 +44,7 @@ module ActsAsFerret #:nodoc: :similarity => 'ActsAsFerret::MoreLikeThis::DefaultAAFSimilarity', # class name of the similarity implementation to use :analyzer => 'Ferret::Analysis::StandardAnalyzer', # class name of the analyzer to use :append_to_query => nil, - :base_class => self.class # base class to use for querying, useful in STI scenarios where BaseClass.find_by_contents can be used to retrieve results from other classes, too + :base_class => self.class # base class to use for querying, useful in STI scenarios where BaseClass.find_with_ferret can be used to retrieve results from other classes, too }.update(options) #index.search_each('id:*') do |doc, score| # puts "#{doc} == #{index[doc][:description]}" lib/more_like_this.rb 4fad5817a673c414003db3a8df6de64088b1d341 Mike Boone mike@boonedocks.net http://github.com/tvdeyen/acts_as_ferret/commit/fdc49aa394d5a107bbb805a295cf30f35a070430 fdc49aa394d5a107bbb805a295cf30f35a070430 2009-04-02T04:25:10-07:00 2009-04-02T04:25:10-07:00 Changed find_by_contents references to find_with_ferret b40f16c51889fe059c8894438783f36c7e5097fd Mike Boone mike@boonedocks.net