idris-auto_complete_jquery 0.1.0

data/CHANGELOG

@@ -0,0 +1 @@
+* 1 July 2008: Switched to a different jQuery autocomplete plugin to be used with this plugin.  The previous plugin was not handling case insensitivity, was slow, and lacked various other options.  The new jQuery autocomplete plugin this depends on his a nice improvement, being massively faster, providing a CSS style you can use while your AJAX request runs, handling case properly, and adding a slew of options.

data/README

@@ -0,0 +1,57 @@
+This plugin provides a auto-complete method for your controllers to be used
+with Dylan Verheul's jquery autocomplete plugin.  This jQuery plugin is not
+included, and can be obtained from:
+
+http://bassistance.de/jquery-plugins/jquery-plugin-autocomplete/
+
+This auto_complete_jquery plugin is just a modified version of the standard
+Rails auto_complete plugin.  It provides the same auto_complete_for method
+for your controllers, but eliminates the various view helper methods, as
+those are not needed when using jQuery and Unobtrusive JavaScript.
+
+To use this, you need to have jQuery and the autocomplete plugin mentioned 
+above (as well as appropriate CSS).  Then, there are four aspects of setting 
+up an auto-complete field:
+
+1) Create the text field in your view, which is just a regular form text
+field as you'd create in a Rails erb view:
+
+  <%= post.text_field :title, :autocomplete =>"off" %>
+  
+2) Include the appropriate JS files and CSS in your layout or similar:
+
+  <%= stylesheet_link_tag 'jquery.ui.autocomplete' %>
+  <%= javascript_include_tag 'jquery.min', 'jquery.dimensions.min', 'jquery.templating', 'jquery.ui.autocomplete.ext', 'jquery.ui.autocomplete', :cache => 'jquery' %>
+
+3) Use the auto_complete_for controller macro to generate the appropriate
+auto-complete method in your controller, such as:
+
+  # Controller
+  class BlogController < ApplicationController
+    auto_complete_for :post, :title
+  end
+
+4) Hook up the text field's autocomplete event in your JavaScript file
+using jQuery and the jquery-autocomplete plugin mechanism, for example:
+
+  $(document).ready(function() {
+    $("input#post_title").autocomplete("auto_complete_for_post_title")
+  });
+
+By default, auto_complete_for limits the results to 10 entries,
+and sorts by the given field.
+
+auto_complete_for takes a third parameter, an options hash to
+the find method used to search for the records:
+
+  auto_complete_for :post, :title, :limit => 15, :order => 'created_at DESC'
+
+For more information, see:
+* jQuery site: http://jquery.com
+* Dylan Verheul jquery autocomplete plugin site: http://www.dyve.net/jquery/?autocomplete
+* Good article on jQuery and Rails (note this mentions a different jquery autocomplete 
+  plugin, which was originally used in this plugin): http://errtheblog.com/posts/73-the-jskinny-on-jquery
+* Original Rails auto_complete plugin: http://github.com/rails/auto_complete
+
+
+Copyright (c) 2008 Cobalt Edge LLC, released under the MIT license.

data/Rakefile

@@ -0,0 +1,11 @@
+require 'rake' 
+require 'rake/rdoctask' 
+   
+desc 'Generate documentation for auto_complete plugin.' 
+Rake::RDocTask.new(:rdoc) do |rdoc| 
+  rdoc.rdoc_dir = 'rdoc' 
+  rdoc.title    = 'Auto Complete jQuery' 
+  rdoc.options << '--line-numbers' << '--inline-source' 
+  rdoc.rdoc_files.include('README') 
+  rdoc.rdoc_files.include('lib/**/*.rb') 
+end

data/auto_complete_jquery.gemspec

@@ -0,0 +1,19 @@
+Gem::Specification.new do |s|
+  s.name     = "auto_complete_jquery"
+  s.version  = "0.1.0"
+  s.date     = "2008-12-28"
+  s.summary  = "auto-complete method for Rails controllers using Dylan Verheul's jQuery autocomplete plugin"
+  s.email    = "chris@cobaltedge.com"
+  s.homepage = "http://github.com/mojombo/grit"
+  s.description = "This plugin provides a auto-complete method for your controllers to be used with Dylan Verheul's jquery autocomplete plugin."
+  s.has_rdoc = true
+  s.authors  = ["Chris Bailey"]
+  s.files    = ["CHANGELOG", 
+		"README", 
+		"Rakefile", 
+		"auto_complete_jquery.gemspec", 
+		"init.rb", 
+		"lib/quto_complete_jquery.rb"]
+  s.rdoc_options = ["--main", "README.txt"]
+  s.extra_rdoc_files = ["CHANGELOG", "README"]
+end

data/init.rb

@@ -0,0 +1 @@
+ActionController::Base.send :include, AutoCompleteJquery

metadata

@@ -0,0 +1,60 @@
+--- !ruby/object:Gem::Specification 
+name: idris-auto_complete_jquery
+version: !ruby/object:Gem::Version 
+  version: 0.1.0
+platform: ruby
+authors: 
+- Chris Bailey
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2008-12-28 00:00:00 -08:00
+default_executable: 
+dependencies: []
+
+description: This plugin provides a auto-complete method for your controllers to be used with Dylan Verheul's jquery autocomplete plugin.
+email: chris@cobaltedge.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- CHANGELOG
+- README
+files: 
+- CHANGELOG
+- README
+- Rakefile
+- auto_complete_jquery.gemspec
+- init.rb
+- lib/quto_complete_jquery.rb
+has_rdoc: true
+homepage: http://github.com/mojombo/grit
+post_install_message: 
+rdoc_options: 
+- --main
+- README.txt
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.2.0
+signing_key: 
+specification_version: 2
+summary: auto-complete method for Rails controllers using Dylan Verheul's jQuery autocomplete plugin
+test_files: []
+