ui_datepicker-rails3 1.0.0

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2010 [name of plugin creator]
+
+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.mdown

@@ -0,0 +1,200 @@
+# jQuery UI Datepicker for Rails 3.x
+
+This gem adds support for jQuery UI Date and DateTime picker for Rails 3.x form builders, including:
+
+* Formtastic 2.x
+* SimpleForm
+
+Feel free to provide patches/extensions to support other form builders.
+
+## Install
+
+Insert into Gemfile:
+
+`gem 'ui_datepicker-rails3'`
+
+Activate it like this:
+
+`UiDatePickerRails3.activate :simple_form`
+
+This can be done fx from inside an initializer. You can pass either :simple_form, :formtastic or :active_admin to the `#activate` method.
+
+## jQuery UI Configuration
+
+For basic Rails form builder support, please see ["jquery_datepicker"](https://github.com/albertopq/jquery_datepicker)
+
+In Gemfile, insert:
+
+`gem 'jquery-rails'`
+
+Then install jquery with UI, by executing the following command from console:
+
+`rails generate jquery:install --ui`
+
+In Rails 3.1 when using the asset pipeline, this generator is deprecated, so you’ll need to add a line to your `app/assets/javascripts/application.js` file:
+
+`//= require jquery-ui`
+
+### Formtastic
+
+This gem requires Formtastic 2.0. For a version that supports Formtastic < 2.0, see [formtastic_datepicker]:(https://github.com/kristianmandrup/formtastic_datepicker)
+
+### ActiveAdmin
+
+The ActiveAdmin extension should work with ActiveAdmin _0.3.4_ (where Formtastic >= 2.0) 
+
+Note: As of Nov 25, 2011 The `active_admin/gregbell` _master_ branch is compatible with Formtastic 2.x. 
+
+ActiveAdmin _0.3.5+_ will likely support Formtastic 2.x ;)
+
+## Formtastic (by justinfrench)
+
+The gem adds a couple of new form inputs to Formtastic that can be used like this: 
+
+```ruby 
+	<% semantic_form_for @person do |f| -%>
+		<% f.inputs do -%>
+		  <%= f.input :name %>
+		  <%= f.input :born, :as => :ui_date_picker %>
+		<% end -%>
+		<%= f.buttons %>
+	<% end -%>
+```
+
+The Formtastic Input class adds `class='ui-date-picker'` to the text input, which can the be matched by jQuery and converted to the date picker widget.
+
+```ruby 
+	<% semantic_form_for @person do |f| -%>
+		<% f.inputs do -%>
+		  <%= f.input :name %>
+		  <%= f.input :born, :as => :ui_date_time_picker %>
+		<% end -%>
+		<%= f.buttons %>
+	<% end -%>
+```
+
+The Formtastic Input class adds `class='ui-datetime-picker'` to the text input, which can the be matched by jQuery and converted to the date-time picker widget.
+
+## SimpleForm (by plataformatec)
+
+The gem adds a couple of new form inputs to SimpleForm that can be used like this: 
+
+```ruby 
+	<% simple_form_for @person do |f| -%>
+	  <%= f.input :name %>
+	  <%= f.input :born, :as => :date_picker %>
+	<% end -%>
+```
+
+The SimpleForm Input class adds `class='ui-date-picker'` to the text input, which can the be matched by jQuery and converted to the date picker widget.
+
+```ruby 
+	<% simple_form_for @person do |f| -%>
+    <%= f.input :name %>
+    <%= f.input :born, :as => :date_time_picker %>
+	<% end -%>
+```
+
+The SimpleForm Input class adds `class='ui-datetime-picker'` to the text input, which can the be matched by jQuery and converted to the date-time picker widget.
+
+## Configuration
+
+These configuration tips are only appropriate for a static datepicker, i.e one with a fixed set of options and a given language. Handling a more dynamic configuration is left as an exercise.
+
+When the gem has been installed the datepicker should be configured as follows
+
+Install the jquery-ui CSS. You can get a bundle to match your site from ThemeRoller. From your theme bundle, extract the CSS directory and place it somewhere under app/assets/stylesheets/.
+
+Activate datepicker on all matching input elements in one of your javascript (or coffee script) files, fx `datepicker.js` or `datepicker.js.coffee`.
+
+```javascript
+$(document).ready(function(){
+  $('input.ui-date-picker').datepicker();
+  $('input.ui-datetime-picker').datepicker();
+});
+```
+
+The same in coffescript:
+
+```coffeescript
+$->
+  $('input.ui-date-picker').datepicker
+  $('input.ui-datetime-picker').datepicker
+```
+
+## Localization (optional)
+
+To add localization, you can additionally add localization options to the `datepicker()` call.
+
+Example: Using the swedish localization:
+
+```javascript
+$(document).ready(function(){
+  $('input.ui-date-picker').datepicker('option', 'sv' );
+});
+```
+
+The same in coffescript:
+
+```coffeescript
+$->
+  $('input.ui-date-picker').datepicker('option', 'sv')
+```
+
+
+For any other language exchange the local 'sv' to the appropriate (localized) country code.
+
+Copy the appropriate localization file from ["jQuery-UI i18n"](http://jquery-ui.googlecode.com/svn/trunk/ui/i18n/) to your js asset folder, fx at: `app/assets/javascripts/i18n/jquery.ui.datepicker-sv.js`
+
+Then make sure a reference to the locale file is added in the manifest file.
+
+`//= require 'i18n/jquery.ui.datepicker-sv.js'` to your js manifest file. 
+
+You can also use the included datepicker locale files as a base (see vendor/assets of this gem).
+This gem includes a helper method `#ui_localizers` that can be used like this (fx in your Rails layout file or similar):
+
+```ruby
+<%= javascript_include_tag UiDatePickerRails3.ui_localizers :ar, :ca, :da %>
+```
+
+It will generate strings of the form "ui/i18n/jquery.ui.datepicker-#{country_code}"
+
+## Styling (optional)
+
+Style the datepicker by adding a `datepicker.css` file to your css assets.
+
+You can use the *Themeroller* (http://jqueryui.com/themeroller/) to define and download an appropriate css file and the pictures needed. Add the downloaded Themeroller css file to the css assets and add the Themeroller images to the image assets. Edit the datepicker css and change all image references by removing all the "images/" prefixes e.g from `url(images/ui-icons_222222_256x240.png)` to `url(ui-icons_222222_256x240.png)`
+
+Note: It is also possible to load only the js needed for the datepicker widget by using the js files that are downloaded from Themeroller.
+
+A 'smoothness' theme is included with this gem. Simply do:
+
+```ruby
+<%= stylesheet_link_tag UiDatePickerRails3.ui_theme :smoothness %>
+```
+
+## Advanced configuration
+
+Add any additional datepicker options as defined in the ["Datepicker"](http://docs.jquery.com/UI/Datepicker) docs.
+
+Example: add option for displaying week number and displaying a drop-down of months:
+
+```javascript
+$(document).ready(function(){
+  var datepicker_widgets = $('input.ui-date-picker');
+
+  datepicker_widgets.datepicker( 'option', 'showWeek', true);
+	datepicker_widgets.datepicker( 'option', 'changeMonth', true );
+});
+```
+
+## ActiveAdmin integration
+
+In the Gemfile add this gem after _ActiveAdmin_ (`gem 'active_admin'`) to make sure it loads after and overrides/extends ActiveAdmin appropriately. 
+
+```text
+gem 'active_admin'
+gem 'ui_datepicker_rails3'
+```
+
+Note: To configure css and js files with ActiveAdmin you can use the config DSL in the ActiveAdmin initializer.

data/Rakefile

@@ -0,0 +1,18 @@
+require 'rubygems'
+require 'bundler'
+begin
+  Bundler.setup(:default, :development)
+rescue Bundler::BundlerError => e
+  $stderr.puts e.message
+  $stderr.puts "Run `bundle install` to install missing gems"
+  exit e.status_code
+end
+require 'rake'
+
+require 'rspec/core'
+require 'rspec/core/rake_task'
+RSpec::Core::RakeTask.new(:spec) do |spec|
+  spec.pattern = FileList['spec/**/*_spec.rb']
+end
+
+task :default => :spec

data/init.rb

@@ -0,0 +1,2 @@
+# Include hook code here
+require 'formtastic_datepicker_rails3x'

data/lib/active_admin/inputs/ui_date_picker_input.rb

@@ -0,0 +1,11 @@
+module ActiveAdmin
+  module Inputs
+    class UiDatePickerInput < ::ActiveAdmin::Inputs::DatepickerInput
+      def input_html_options
+        options = super
+        options[:class] = [options[:class], "ui-date-picker"].compact.join(' ')
+        options
+      end
+    end
+  end
+end

data/lib/active_admin/inputs/ui_date_time_picker_input.rb

@@ -0,0 +1,13 @@
+require 'active_admin/inputs/ui_date_picker_input'
+
+module ActiveAdmin
+  module Inputs
+    class UiDateTimePickerInput < UiDatePickerInput
+      def input_html_options
+        options = super
+        options[:class] = [options[:class], "ui-datetime-picker"].compact.join(' ')
+        options
+      end
+    end
+  end
+end

data/lib/active_admin/inputs_ext.rb

@@ -0,0 +1,2 @@
+require 'active_admin/inputs/ui_date_picker_input'
+require 'active_admin/inputs/ui_date_time_picker_input'

data/lib/date_util/localize.rb

@@ -0,0 +1,18 @@
+module DateUtil
+  module Localize
+    # http://stackoverflow.com/questions/7580238/how-do-i-parse-non-english-dates-with-datetime-strptime-in-ruby    
+    # value.nil? ? nil : I18n.localize(value)
+    def localized value
+      value
+    end
+    
+    def to_english_date(date_string, country_code = :sv)
+      case country_code.to_sym
+      when :sv
+        date_string.gsub(/may|okt/, 'may' => 'May', 'okt' => 'Oct')
+      else
+        raise ArgumentError, "Country code #{sw} not currently supported, please extend DateUtil::Localize"
+      end
+    end
+  end
+end

data/lib/formtastic/inputs/ui_date_picker_input.rb

@@ -0,0 +1,33 @@
+require 'formtastic/inputs/ui_date_picker_input'
+
+module Formtastic::Inputs
+  class UiDatePickerInput < Formtastic::Inputs::StringInput
+    def to_html
+      input_wrapping do
+        label_html <<
+          builder.text_field(input_name, input_html_options)
+      end
+    end
+
+    def format
+      input_options[:format] || '%d %b %Y'
+    end
+
+    def value
+      input_options[:value] || object.send(method).try(:strftime, format)
+    end
+
+    def css_class
+      "ui-date-picker"
+    end
+
+    def input_html_options
+      new_class = [super[:class], css_class].compact.join(" ")
+      super.update(:class => new_class, :value => localized(value))
+    end
+    
+    def localized value
+      value.nil? ? nil : I18n.localize(value)
+    end    
+  end
+end

data/lib/formtastic/inputs/ui_date_time_picker_input.rb

@@ -0,0 +1,12 @@
+module Formtastic::Inputs
+  class UiDateTimePickerInput < UiDatePickerInput
+
+    def format
+      input_options[:format] || '%d %b %Y %H:%M'
+    end
+
+    def css_class
+      "ui-datetime-picker"
+    end
+  end
+end

data/lib/formtastic/inputs_ext.rb

@@ -0,0 +1,2 @@
+require 'formtastic/inputs/ui_date_picker_input'
+require 'formtastic/inputs/ui_date_time_picker_input'

data/lib/simple_form/inputs/ui_date_picker_input.rb

@@ -0,0 +1,25 @@
+module SimpleForm
+  module Inputs
+    class UiDatePickerInput < Base
+      def input
+        @builder.text_field(attribute_name, input_html_options)
+      end
+
+      protected
+
+      include DateUtil::Localize
+
+      def input_html_options
+        super.merge(date_picker_options(object.send(attribute_name)))
+      end
+
+      def date_picker_options(value = nil)
+        {:value => localized(value), :class => css_class}
+      end
+
+      def css_class
+        "ui-date-picker"
+      end
+    end
+  end
+end

data/lib/simple_form/inputs/ui_date_time_picker_input.rb

@@ -0,0 +1,11 @@
+require 'simple_form/inputs/ui_date_picker_input'
+
+module SimpleForm
+  module Inputs
+    class UiDateTimePickerInput < UiDatePickerInput
+      def css_class
+        "ui-datetime-picker"
+      end      
+    end
+  end
+end

data/lib/simple_form/inputs_ext.rb

@@ -0,0 +1,2 @@
+require 'simple_form/inputs/ui_date_picker_input'
+require 'simple_form/inputs/ui_date_time_picker_input'

data/lib/ui_datepicker-rails3.rb

@@ -0,0 +1,41 @@
+require 'date_util/localize'
+
+module UiDatePickerRails3
+  module ClassMethods
+    def activate *names
+      names = names.flatten
+      names.each {|name| activate_one name }
+    end
+
+    def activate_one name
+      valid_framework? name
+      load_extension name
+    end
+
+    def load_extension name
+      require "#{name}/inputs_ext"
+    rescue Exception => e
+      raise NotImplementedError, "Unsupported Formbuilder or framework: #{name} - #{e}"
+    end
+
+    def valid_framework? name  
+      case name.to_sym
+      when :simple_form
+        raise ArgumentError, "SimpleForm not defined" unless defined?(SimpleForm)
+      when :formtastic
+        raise ArgumentError, "Formtastic not defined" unless defined?(Formtastic)
+      when :active_admin
+        raise ArgumentError, "ActiveAdmin not defined" unless defined?(ActiveAdmin)
+      end
+    end
+  
+    def ui_theme theme
+      "ui/#{theme}/jquery-ui-theme"
+    end
+  
+    def ui_localizers *country_codes
+      country_codes.map {|cc| "ui/i18n/jquery.ui.datepicker-#{cc}" }
+    end
+  end
+  extend ClassMethods
+end

data/spec/base_helper.rb

@@ -0,0 +1,26 @@
+require 'rubygems'
+require 'bundler'
+Bundler.setup
+
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+require 'rspec'
+
+require 'active_support'
+require 'action_pack'
+require 'action_view'
+require 'action_controller'
+require 'formtastic'
+require 'rspec_tag_matchers'
+
+# Requires supporting files with custom matchers and macros, etc,
+# in ./support/ and its subdirectories.
+Dir["#{File.dirname(__FILE__)}/support/**/*.rb"].each {|f| require f}
+
+require 'ui_datepicker-rails3'
+
+RSpec.configure do |config|
+  config.include RspecTagMatchers
+  config.include CustomMacros
+  config.mock_with :rspec
+end