Description
======
This plugin adds full text search capabilities and many other nifty features from Apache's [Solr](http://lucene.apache.org/solr/) to any Rails model.
It was based on the first draft by Erik Hatcher.

This plugin is intended for use in old versions of Rails. For newer versions, I strongly advice using Sunspot!
Nevertheless, this plugin is used for Noosfero project in production. Any problem please open an issue.

Installation
======

Install as a plugin

    script/plugin install git://github.com/brauliobo/acts_as_solr_reloaded.git

Download Solr 3.5

    rake solr:download

Requirements
------
* Java Runtime Environment(JRE) 6.0 (or newer) from Oracle or OpenJDK

Configuration
======
See config/solr.yml file.

For solr configuration the important files are solrconfig.xml and schema.xml.

Basic Usage
======
<pre><code>
# Just include the line below to any of your ActiveRecord models:
  acts_as_solr

# Or if you want, you can specify only the fields that should be indexed:
  acts_as_solr :fields => [:name, :author]

# Then to find instances of your model, just do:
  Model.search(query) #query is a string representing your query

# Please see ActsAsSolr::ActsMethods for a complete info

</code></pre>

Pagination
======
ActsAsSolr implements in SearchResults class an interface compatible with will_paginate and maybe others.

In your tests
======
To test code that uses `acts_as_solr` you must start a Solr server for the test environment.
You can add to the beggining of your test/test_helper.rb the code:
<pre><code>
ENV["RAILS_ENV"] = "test"
abort unless system 'rake solr:start' 
at_exit { system 'rake solr:stop' }
</pre></code>

However, if you would like to mock out Solr calls so that a Solr server is not needed (and your tests will run much faster), just add this to your `test_helper.rb` or similar:
<pre><code>
class ActsAsSolr::Post
  def self.execute(request)
    true
  end
end
</pre></code>

Release Information
======
Released under the MIT license.