Home > sunspot_autocomplete

sunspot_autocomplete

Sunspot_autocomplete is a project mainly written in Ruby, based on the View license.

A Rails plugin encapsulating autocompletion of HTML text input using Solr and Sunspot

= Sunspot Autocomplete

Sunspot Autocomplete is a Rails plugin that lets you use Solr and Sunspot for handy autocompletion of your html text inputs.

=== Features:

  • Autocomplete: Typing "clo" will yield results that start with "clo", like "cloudy with a chance of meatballs".
  • Autosuggest: Typing "clo" will yield results that contain (or start with) "clo", like "cloudy with a chance of meatballs" and "Jumping like Clowns".
  • Both features are case insenitive.
  • A CSS based view. You can override some style rules to force your look and feel.

== Prerequisites

You should have solr, sunspot and sunspot_rails ON and running.

http://outoftime.github.com/sunspot

== Installation

Download the plugin and place it under vendor/plugins.

Run the following rake task to copy the plugin's assets to your public directory. This will copy jquery.js and solr-autocompleter to your public/javascripts.

rake sunspot_autocomplete:copy_assets

== Usage

In your solr schema.xml, add the following field types inside the tag:

Also in your solr schema.xml, add the following fields inside thw tag.

To be able to autocomplete/autosuggest a model's attribute, call 'autocomplete'/'autosuggest' on it in its 'searchable' block. the field_name used (post_title and post_author in the following example) must be unique across all your autocomplete fields of the application.

class Post < ActiveRecord::Base searchable do autocomplete :post_title, :using => :title autosuggest :post_author, :using => :author end end

In your view, Add the following script tags (in the given order) to be able to use the view helpers.

Also, add the following stylesheet to use the basic style included. Alternatively, you can override those style rules to force your design's look and feel.

In your view, to create a text field with autocomplete:

<%=autocomplete_text_field "post", "title", "http://127.0.0.1:8983/solr/", "post_title"%>

And to create a text field with autosuggest:

<%=autosuggest_text_field "post", "author", "http://127.0.0.1:8983/solr/", "post_author"%>

You can view documentation for more advanced features of the helpers.