formtastic_jquery_ui 0.0.1

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2010 Paul Smith
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.textile

@@ -0,0 +1,99 @@
+h1. Formtastic jQuery-UI
+
+Adds some "jQuery UI":http://jqueryui.com widgets as input types for "Formtastic":http://github.com/justinfrench/formtastic
+
+Currently Supports:
+
+* Autocomplete
+* Calendar
+
+h2. Examples
+
+h3. Autocomplete
+
+The autocomplete module adds jQuery UI's autocomplete widget to <code>belongs_to</code>, <code>has_many</code>, and <code>has_and_belongs_to_many</code> relationships.
+
+For best results use it with "Searchlogic":http://github.com/binarylogic/searchlogic and "Will Paginate":http://github.com/mislav/will_paginate as shown below
+
+<pre><code>
+class Product
+  belongs_to :brand
+  has_and_belongs_to_many :categories
+end
+</code></pre>
+
+<pre><code>
+class Category
+  has_and_belongs_to_many :products
+end
+</code></pre>
+
+The search results should be mapped into value/label pairs for a JSON query
+
+<pre><code>
+class CategoriesController < ApplicationController
+  def index
+    @search = Category.search(params[:search])
+    @categories = @search.paginate(:page => params[:page])
+    respond_to do |format|
+      format.html {}
+      format.json { @categories.map { |category| {:label => category.title, :value => category.id} }.to_json }
+    end
+  end
+end
+</pre></code>
+
+<pre><code>
+class Brand
+  has_many :products
+end
+</code></pre>
+
+<pre><code>
+class BrandsController < ApplicationController
+  def index
+    @search = Brand.search(params[:search])
+    @brands = @search.paginate(:page => params[:page])
+    respond_to do |format|
+      format.html {}
+      format.json { @brands.map { |brand| {:label => brand.name, :value => brand.id} }.to_json }
+    end
+  end
+end
+</pre></code>
+
+The input method takes two extra parameters:
+
+* <code>:url</code> - the URL of the data source (JSON formatted)
+* <code>:param_name</code> - the parameter that will be passed to the URL (as part of the search param) 
+
+<pre><code>
+<% semantic_form_for @product do |f| %>
+  <% f.inputs do %>
+    <%= f.input :categories, :as => :autocomplete, :url => categories_path(:format => :json), :param_name => 'title_begins_with' %>
+    <%= f.input :brand, :as => :autocomplete, :url => brands_path(:format => :json), :param_name => 'name_begins_with' %>
+  <% end %>
+<% end %>
+</code></pre>
+
+h2. Datepicker
+
+<pre><code>
+<% semantic_form_for @todo do |f| %>
+  <% f.inputs do %>
+    <%= f.input :due_date, :as => :datepicker
+  <% end %>
+<% end %>
+</code></pre>
+
+h2. Requirements
+
+This addon requires the following components
+
+* "Formtastic":http://github.com/justinfrench/formtastic (tested with v1.1.0)
+* "jQuery":http://jquery.com (tested with v1.4.2)
+* "jQuery UI":http://jqueryui.com (tested with v1.8.5) 
+** *1.7 will not work as it does not include the autocomplete widget*
+** Don't forget to include the necessary CSS and include the images in your project
+
+Copyright (c) 2010 Paul Smith, released under the MIT license

data/Rakefile

@@ -0,0 +1,23 @@
+require 'rake'
+require 'rake/testtask'
+require 'rake/rdoctask'
+
+desc 'Default: run unit tests.'
+task :default => :test
+
+desc 'Test the formtastic_jquery_ui plugin.'
+Rake::TestTask.new(:test) do |t|
+  t.libs << 'lib'
+  t.libs << 'test'
+  t.pattern = 'test/**/*_test.rb'
+  t.verbose = true
+end
+
+desc 'Generate documentation for the formtastic_jquery_ui plugin.'
+Rake::RDocTask.new(:rdoc) do |rdoc|
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title    = 'Formtastic-jquery-ui'
+  rdoc.options << '--line-numbers' << '--inline-source'
+  rdoc.rdoc_files.include('README')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/lib/formtastic_jquery_ui/autocomplete.rb

@@ -0,0 +1,84 @@
+module FormtasticJQueryUI
+  module Autocomplete
+  
+    def autocomplete_input(method, options)
+      html_options = options.delete(:input_html) || {}
+      options = set_include_blank(options)
+      html_options[:multiple] = html_options[:multiple] || options.delete(:multiple)
+      html_options.delete(:multiple) if html_options[:multiple].nil?
+      
+      html = "" 
+      reflection = self.reflection_for(method)
+      input_name = "autocomplete_for_#{sanitized_object_name}_#{method}"
+      param_name = options[:param_name] || 'term'
+      url = options[:url] || ''
+      
+      if reflection && [:has_many, :has_and_belongs_to_many].include?(reflection.macro)
+        selections_name = generate_html_id(method, 'selections')
+        selection_name = "#{sanitized_object_name}[#{method.to_s.singularize}_ids][]"
+        html << template.content_tag(:ul, object.send(method).map { |i| template.content_tag(:li, "<input type=\"hidden\" name=\"#{selection_name}\" value=\"#{i.id}\" />#{i.to_label} <a href=\"#\" onclick=\"$(this).closest('li').remove();\">Remove</a>") }.join(''), :id => selections_name)
+        html << template.tag(:input, :type => 'hidden', :name => selection_name, :value => '')
+        html << template.text_field_tag(input_name)
+        html << template.content_tag(:script, :type => 'text/javascript') do
+          <<-EOT
+  $('##{input_name}').autocomplete({
+    source: function(request, response) {
+      $.ajax({
+        url: '#{url}',
+        dataType: 'json',
+        data: {
+          search: { #{param_name}: request.term }
+        },
+        success: function(data) {
+          response(data);
+        }
+      });
+    },
+    select: function(event, selection) {
+      if($('##{selections_name} input[value=' + selection.item.value + ']').length == 0)
+        $('##{selections_name}').append('<li><input type="hidden" name="#{selection_name}" value="' + selection.item.value + '" />' + selection.item.label + ' <a href="#" onclick="$(this).closest(\\'li\\').remove();">Remove</a></li>');
+      $('##{input_name}').val('');
+      return false;
+    },
+    focus: function(event, ui) { return false; }
+  });
+EOT
+        end
+      elsif reflection && [:belongs_to].include?(reflection.macro)
+        html << self.hidden_field(reflection.primary_key_name)
+        html << template.text_field_tag(input_name, object.send(method).try(detect_label_method([object.send(method)])))
+        html << template.content_tag(:script, :type => 'text/javascript') do
+          <<-EOT
+  $('##{input_name}').autocomplete({
+    source: function(request, response) {
+      $.ajax({
+        url: '#{url}',
+        dataType: 'json',
+        data: {
+          search: { #{param_name}: request.term }
+        },
+        success: function(data) {
+          response(data);
+        }
+      });
+    },
+    select: function(event, selection) {
+      $('##{sanitized_object_name}_#{reflection.primary_key_name}').val(selection.item.value);
+      $('##{input_name}').val(selection.item.label);
+      return false;
+    },
+    focus: function(event, ui) { return false; }
+  }); 
+  $('##{input_name}').blur(function(event){
+    if($(this).val() == '')
+      $('##{sanitized_object_name}_#{reflection.primary_key_name}').val('');
+  })   
+EOT
+        end
+      end
+    
+      template.content_tag(:label, method.to_s.humanize, :for => input_name) << html
+    end
+    
+  end
+end

data/lib/formtastic_jquery_ui/datepicker.rb

@@ -0,0 +1,19 @@
+module FormtasticJQueryUI
+  module Datepicker
+    
+    def datepicker_input(method, options)
+      html_options = options.delete(:input_html) || {}
+      html_options = default_string_options(method, type).merge(html_options) if [:numeric, :string, :password, :text].include?(type)
+
+      self.label(method, options_for_label(options)) <<
+      self.send(:text_field, method, html_options) <<
+      template.content_tag(:script, :type => 'text/javascript') do
+        <<-EOT
+  $('##{sanitized_object_name}_#{method}').datepicker({dateFormat: 'yy-mm-dd'});   
+EOT
+      end
+    end
+    
+  end
+end
+

data/lib/formtastic_jquery_ui.rb

@@ -0,0 +1,9 @@
+if Object.const_defined?("Formtastic")
+  
+  require 'formtastic_jquery_ui/datepicker.rb'
+  Formtastic::SemanticFormBuilder.send(:include, FormtasticJQueryUI::Datepicker)
+  
+  require 'formtastic_jquery_ui/autocomplete.rb'
+  Formtastic::SemanticFormBuilder.send(:include, FormtasticJQueryUI::Autocomplete)
+  
+end

data/lib/tasks/formtastic_jquery_ui.rake

@@ -0,0 +1,4 @@
+# desc "Explaining what the task does"
+# task :formtastic_jquery_ui do
+#   # Task goes here
+# end

data/rails/init.rb

@@ -0,0 +1,2 @@
+# Include hook code here
+require File.join(File.dirname(__FILE__), '..', 'lib', 'formtastic_jquery_ui')

data/test/formtastic_jquery_ui_test.rb

@@ -0,0 +1,8 @@
+require 'test_helper'
+
+class Formtastic-jquery-uiTest < ActiveSupport::TestCase
+  # Replace this with your real tests.
+  test "the truth" do
+    assert true
+  end
+end

data/test/test_helper.rb

@@ -0,0 +1,4 @@
+require 'rubygems'
+require 'test/unit'
+require 'active_support'
+require 'active_support/test_case'

metadata

@@ -0,0 +1,78 @@
+--- !ruby/object:Gem::Specification 
+name: formtastic_jquery_ui
+version: !ruby/object:Gem::Version 
+  hash: 29
+  prerelease: false
+  segments: 
+  - 0
+  - 0
+  - 1
+  version: 0.0.1
+platform: ruby
+authors: 
+- Paul Smith
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-09-23 00:00:00 +01:00
+default_executable: 
+dependencies: []
+
+description: Currently provides autocomplete and datepicker widgets
+email: paul@elandesign.co.uk
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- lib/formtastic_jquery_ui/autocomplete.rb
+- lib/formtastic_jquery_ui/datepicker.rb
+- lib/formtastic_jquery_ui.rb
+- lib/tasks/formtastic_jquery_ui.rake
+- test/formtastic_jquery_ui_test.rb
+- test/test_helper.rb
+- rails/init.rb
+- MIT-LICENSE
+- Rakefile
+- README.textile
+has_rdoc: true
+homepage: http://github.com/elandesign/formtastic_jquery_ui
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 19
+      segments: 
+      - 1
+      - 3
+      - 4
+      version: 1.3.4
+requirements: []
+
+rubyforge_project: formtastic_jquery_ui
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: Provides Formtastic input helpers for some jQuery UI widgets
+test_files: []
+