recurring_select 1.0.0

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright 2013 Jobber (OctopusApp Inc)
+
+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.md

@@ -0,0 +1,83 @@
+RecurringSelect
+=============
+
+This is a gem to add a number of selectors and helpers for working with recurring schedules in a rails app.
+It uses the [IceCube](https://github.com/seejohnrun/ice_cube) recurring scheduling gem.
+
+Created by the [Jobber](http://getjobber.com) team for Jobber, the leading business management tool for field service companies.
+
+Check out the [live demo](http://recurring-select-demo.herokuapp.com/)
+
+
+Usage
+-----
+
+Basic selector:
+
+Load the gem:
+`gem 'recurring_select`
+
+Require assets  
+  Desktop view  
+    application.js  
+      `//= require recurring_select`  
+    application.css  
+      `//= require recurring_select`  
+
+  or jQueryMobile interface  
+    application.js  
+      `//= require jquery-mobile-rs`  
+    application.css  
+      `//= require jquery-mobile-rs`  
+
+
+In the form view call the helper:
+`<%= f.select_recurring :recurring_rule_column %>`
+
+Options
+-------
+
+Defaults Values
+```
+f.select_recurring :current_existing_rule, [
+  IceCube::Rule.weekly.day(:monday, :wednesday, :friday),
+  IceCube::Rule.monthly.day_of_month(-1)
+]
+```
+
+:allow_blank let's you pick if there is a "not recurring" value
+```
+  f.select_recurring :current_existing_rule, :allow_blank => true
+```
+
+
+Additional Helpers
+------------------
+
+RecurringSelect also comes with several helpers for parsing up the
+parameters when they hit your application.
+
+You can send the column into the `is_valid_rule?` method to check the
+validity of the input.
+`RecurringSelect.is_valid_rule?(possible_rule)`
+
+There is also a `dirty_hash_to_rule` method for sanitizing the inputs
+for IceCube. This is sometimes needed based on if you're receiving strings, fixed
+numbers, strings vs symbols, etc.
+`RecurringSelect.dirty_hash_to_rule(params)`
+
+
+Testing and development
+----------------------
+
+Start the dummy server for clicking around the interface:
+`rails s`
+
+Use [Guard](https://github.com/guard/guard) and RSpec for all tests. I'd
+love to get jasmine running also, but haven't had time yet.
+
+Feel free to open issues or send pull requests.
+
+Licensing
+---------
+This project rocks and uses MIT-LICENSE.

data/Rakefile

@@ -0,0 +1,39 @@
+#!/usr/bin/env rake
+begin
+  require 'bundler/setup'
+rescue LoadError
+  puts 'You must `gem install bundler` and `bundle install` to run rake tasks'
+end
+begin
+  require 'rdoc/task'
+rescue LoadError
+  require 'rdoc/rdoc'
+  require 'rake/rdoctask'
+  RDoc::Task = Rake::RDocTask
+end
+
+RDoc::Task.new(:rdoc) do |rdoc|
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title    = 'RecurringSelect'
+  rdoc.options << '--line-numbers'
+  rdoc.rdoc_files.include('README.rdoc')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end
+
+APP_RAKEFILE = File.expand_path("../test/dummy/Rakefile", __FILE__)
+load 'rails/tasks/engine.rake'
+
+
+Bundler::GemHelper.install_tasks
+
+require 'rake/testtask'
+
+Rake::TestTask.new(:test) do |t|
+  t.libs << 'lib'
+  t.libs << 'test'
+  t.pattern = 'test/**/*_test.rb'
+  t.verbose = false
+end
+
+
+task :default => :test

data/app/assets/javascripts/jquery-mobile-rs.js.coffee

@@ -0,0 +1,15 @@
+//= require recurring_select
+//= require_self
+
+$ ->
+  $(document).on "recurring_select:cancel recurring_select:save", ".recurring_select", ->
+    $(this).selectmenu('refresh')
+
+  $(document).on "recurring_select:dialog_opened", ".rs_dialog_holder", ->
+    $(this).find("select").attr("data-theme", $('.recurring_select').data("theme")).attr("data-mini", true).selectmenu()
+    $(this).find("input[type=text]").textinput()
+
+    $(this).on "recurring_select:dialog_positioned", ".rs_dialog", ->
+      $(this).css
+        "top" : $(window).scrollTop()+"px"
+

data/app/assets/javascripts/recurring_select.js.coffee

@@ -0,0 +1,74 @@
+//= require recurring_select_dialog
+//= require_self
+
+$ = jQuery
+$ ->
+  $(document).on "focus", ".recurring_select", ->
+    $(this).recurring_select('set_initial_values')
+
+  $(document).on "change", ".recurring_select", ->
+    $(this).recurring_select('changed')
+
+methods =
+  set_initial_values: ->
+    @data 'initial-value-hash', @val()
+    @data 'initial-value-str', $(@find("option").get()[@.prop("selectedIndex")]).text()
+
+  changed: ->
+    if @val() == "custom"
+      methods.open_custom.apply(@)
+    else
+      methods.set_initial_values.apply(@)
+
+  open_custom: ->
+    @data "recurring-select-active", true
+    new RecurringSelectDialog(@)
+    @blur()
+
+  save: (new_rule) ->
+    @find("option[data-custom]").remove()
+    new_json_val = JSON.stringify(new_rule.hash)
+
+    # TODO: check for matching name, and replace that value if found
+
+    if $.inArray(new_json_val, @find("option").map -> $(@).val()) == -1
+      methods.insert_option.apply @, [new_rule.str, new_json_val]
+
+    @val new_json_val
+    methods.set_initial_values.apply @
+    @.trigger "recurring_select:save"
+
+  current_rule: ->
+    str:  @data("initial-value-str")
+    hash: $.parseJSON(@data("initial-value-hash"))
+
+  cancel: ->
+    @val @data("initial-value-hash")
+    @data "recurring-select-active", false
+    @.trigger "recurring_select:cancel"
+
+
+  insert_option: (new_rule_str, new_rule_json) ->
+    seperator = @find("option:disabled")
+    if seperator.length == 0
+      seperator = @find("option")
+    seperator = seperator.last()
+
+    new_option = $(document.createElement("option"))
+    new_option.attr "data-custom", true
+
+    if new_rule_str.substr(new_rule_str.length - 1) != "*"
+      new_rule_str+="*"
+
+    new_option.text new_rule_str
+    new_option.val new_rule_json
+    new_option.insertBefore seperator
+
+  methods: ->
+    methods
+
+$.fn.recurring_select = (method) ->
+  if method of methods
+    return methods[ method ].apply( this, Array.prototype.slice.call( arguments, 1 ) );
+  else
+    $.error( "Method #{method} does not exist on jQuery.recurring_select" );

data/app/assets/javascripts/recurring_select_dialog.js.coffee.erb

@@ -0,0 +1,300 @@
+<%
+  template_path = File.expand_path("../templates/recurring_select/dialog_template.html", File.dirname(__FILE__))
+  File.open(template_path) do |file|
+    @template = file.read
+  end
+%>
+
+window.RecurringSelectDialog =
+  class RecurringSelectDialog
+    constructor: (@recurring_selector) ->
+      @current_rule = @recurring_selector.recurring_select('current_rule')
+      @initDialogBox()
+      if not @current_rule.hash? or not @current_rule.hash.rule_type?
+        @freqChanged()
+      else
+        setTimeout @positionDialogVert, 10 # allow initial render
+
+    initDialogBox: ->
+      $(".rs_dialog_holder").remove()
+
+      open_in = $("body")
+      open_in = $(".ui-page-active") if $(".ui-page-active").length
+      open_in.append "<%= ActionController::Base.helpers.escape_javascript @template %>"
+      @outer_holder = $(".rs_dialog_holder")
+      @inner_holder = @outer_holder.find ".rs_dialog"
+      @content = @outer_holder.find ".rs_dialog_content"
+
+      @positionDialogVert(true)
+      @mainEventInit()
+      @freqInit()
+      @summaryInit()
+      @freq_select.focus()
+      @outer_holder.trigger "recurring_select:dialog_opened"
+
+    positionDialogVert: (initial_positioning) =>
+      window_height = $(window).height()
+      window_width  = $(window).width()
+      dialog_height = @content.outerHeight()
+      if dialog_height < 80
+        dialog_height = 80
+      margin_top = (window_height - dialog_height)/2 - 30
+      margin_top = 10 if margin_top < 10
+      # if dialog_height > window_height - 20
+      #   dialog_height = window_height - 20
+
+      new_style_hash =
+        "margin-top" : margin_top+"px"
+        "height" : dialog_height+"px"
+
+      if initial_positioning?
+        @inner_holder.css new_style_hash
+        @inner_holder.trigger "recurring_select:dialog_positioned"
+      else
+        @content.css {"width": @content.width()+"px"}
+        @inner_holder.addClass "animated"
+        @inner_holder.animate new_style_hash, 200, =>
+          @inner_holder.removeClass "animated"
+          @content.css {"width": "auto"}
+          @inner_holder.trigger "recurring_select:dialog_positioned"
+
+    cancel: =>
+      @outer_holder.remove()
+      @recurring_selector.recurring_select('cancel')
+
+    outerCancel: (event) =>
+      if $(event.target).hasClass("rs_dialog_holder")
+        @cancel()
+
+    save: =>
+      return if !@current_rule.str?
+      @outer_holder.remove()
+      @recurring_selector.recurring_select('save', @current_rule)
+
+# ========================= Init Methods ===============================
+
+    mainEventInit: ->
+      # Tap hooks are for jQueryMobile
+      @outer_holder.on 'click tap', @outerCancel
+      @content.on 'click tap', 'h1 a', @cancel
+      @save_button = @content.find('input.rs_save').on "click tap", @save
+      @content.find('input.rs_cancel').on "click tap", @cancel
+
+    freqInit: ->
+      @freq_select = @outer_holder.find ".rs_frequency"
+      if @current_rule.hash? && (rule_type = @current_rule.hash.rule_type)?
+        if rule_type.search(/Weekly/) != -1
+          @freq_select.prop('selectedIndex', 1)
+          @initWeeklyOptions()
+        else if rule_type.search(/Monthly/) != -1
+          @freq_select.prop('selectedIndex', 2)
+          @initMonthlyOptions()
+        else if rule_type.search(/Yearly/) != -1
+          @freq_select.prop('selectedIndex', 3)
+          @initYearlyOptions()
+        else
+          @initDailyOptions()
+      @freq_select.on "change", @freqChanged
+
+    initDailyOptions: ->
+      section = @content.find('.daily_options')
+      interval_input = section.find('.rs_daily_interval')
+      interval_input.val(@current_rule.hash.interval)
+      interval_input.on "change keyup", @intervalChanged
+      section.show()
+
+    initWeeklyOptions: ->
+      section = @content.find('.weekly_options')
+
+      # connect the interval field
+      interval_input = section.find('.rs_weekly_interval')
+      interval_input.val(@current_rule.hash.interval)
+      interval_input.on "change keyup", @intervalChanged
+
+      # connect the day fields
+      if @current_rule.hash.validations? && @current_rule.hash.validations.day?
+        $(@current_rule.hash.validations.day).each (index, val) ->
+          section.find(".day_holder a[data-value='"+val+"']").addClass("selected")
+      section.on "click", ".day_holder a", @daysChanged
+
+      section.show()
+
+    initMonthlyOptions: ->
+      section = @content.find('.monthly_options')
+      interval_input = section.find('.rs_monthly_interval')
+      interval_input.val(@current_rule.hash.interval)
+      interval_input.on "change keyup", @intervalChanged
+
+      @current_rule.hash.validations ||= {}
+      @current_rule.hash.validations.day_of_month ||= []
+      @current_rule.hash.validations.day_of_week ||= {}
+      @init_calendar_days(section)
+      @init_calendar_weeks(section)
+
+      in_week_mode = Object.keys(@current_rule.hash.validations.day_of_week).length > 0
+      section.find(".monthly_rule_type_week").prop("checked", in_week_mode)
+      section.find(".monthly_rule_type_day").prop("checked", !in_week_mode)
+      @toggle_month_view()
+      section.find("input[name=monthly_rule_type]").on "change", @toggle_month_view
+      section.show()
+
+    initYearlyOptions: ->
+      section = @content.find('.yearly_options')
+      interval_input = section.find('.rs_yearly_interval')
+      interval_input.val(@current_rule.hash.interval)
+      interval_input.on "change keyup", @intervalChanged
+      section.show()
+
+
+    summaryInit: ->
+      @summary = @outer_holder.find(".rs_summary")
+      @summaryUpdate()
+
+# ========================= render methods ===============================
+
+    summaryUpdate: (new_string) =>
+      if @current_rule.hash? && @current_rule.str?
+        @summary.removeClass "fetching"
+        @save_button.removeClass("disabled")
+        rule_str = @current_rule.str.replace("*", "")
+        if rule_str.length < 20
+          rule_str = "Summary: "+rule_str
+        @summary.find("span").html rule_str
+      else
+        @summary.addClass "fetching"
+        @save_button.addClass("disabled")
+        @summary.find("span").html ""
+        @summaryFetch()
+
+    summaryFetch: ->
+      return if !(@current_rule.hash? && (rule_type = @current_rule.hash.rule_type)?)
+      @content.css {"width": @content.width()+"px"}
+      $.ajax
+        url: "/recurring_select/translate",
+        type: "POST",
+        data: @current_rule.hash
+        success: @summaryFetchSuccess
+
+    summaryFetchSuccess: (data) =>
+      @current_rule.str = data
+      @summaryUpdate()
+      @content.css {"width": "auto"}
+
+    init_calendar_days: (section) =>
+      monthly_calendar = section.find(".rs_calendar_day")
+      monthly_calendar.html ""
+      for num in [1..31]
+        monthly_calendar.append (day_link = $(document.createElement("a")).text(num))
+        if $.inArray(num, @current_rule.hash.validations.day_of_month) != -1
+          day_link.addClass("selected")
+
+      # add last day of month button
+      monthly_calendar.append (end_of_month_link = $(document.createElement("a")).text("Last Day"))
+      end_of_month_link.addClass("end_of_month")
+      if $.inArray(-1, @current_rule.hash.validations.day_of_month) != -1
+        end_of_month_link.addClass("selected")
+
+      monthly_calendar.find("a").on "click tap", @dateOfMonthChanged
+
+    init_calendar_weeks: (section) =>
+      monthly_calendar = section.find(".rs_calendar_week")
+      monthly_calendar.html ""
+      row_labels = ["1st", "2nd", "3rd", "4th"]
+      cell_str = ["S", "M", "T", "W", "T", "F", "S"]
+
+      for num in [1..4]
+        monthly_calendar.append "<span>#{row_labels[num - 1]}</span>"
+        for day_of_week in [0..6]
+          day_link = $("<a>", {text: cell_str[day_of_week]})
+          day_link.attr("day", day_of_week)
+          day_link.attr("instance", num)
+          monthly_calendar.append day_link
+      $.each @current_rule.hash.validations.day_of_week, (key, value) ->
+        $.each value, (index, instance) ->
+          section.find("a[day='#{key}'][instance='#{instance}']").addClass("selected")
+      monthly_calendar.find("a").on "click tap", @weekOfMonthChanged
+
+    toggle_month_view: =>
+      week_mode = @content.find(".monthly_rule_type_week").prop("checked")
+      @content.find(".rs_calendar_week").toggle(week_mode)
+      @content.find(".rs_calendar_day").toggle(!week_mode)
+
+# ========================= Change callbacks ===============================
+
+    freqChanged: =>
+      @current_rule.hash = null unless $.isPlainObject(@current_rule.hash) # for custom values
+
+      @current_rule.hash ||= {}
+      @current_rule.hash.interval = 1
+      @current_rule.hash.until = null
+      @current_rule.hash.count = null
+      @current_rule.hash.validations = null
+      @content.find(".freq_option_section").hide();
+      @content.find("input[type=radio], input[type=checkbox]").prop("checked", false)
+      switch @freq_select.val()
+        when "Weekly"
+          @current_rule.hash.rule_type = "IceCube::WeeklyRule"
+          @current_rule.str = "Weekly"
+          @initWeeklyOptions()
+        when "Monthly"
+          @current_rule.hash.rule_type = "IceCube::MonthlyRule"
+          @current_rule.str = "Monthly"
+          @initMonthlyOptions()
+        when "Yearly"
+          @current_rule.hash.rule_type = "IceCube::YearlyRule"
+          @current_rule.str = "Yearly"
+          @initYearlyOptions()
+        else
+          @current_rule.hash.rule_type = "IceCube::DailyRule"
+          @current_rule.str = "Daily"
+          @initDailyOptions()
+      @summaryUpdate()
+      @positionDialogVert()
+
+    intervalChanged: (event) =>
+      @current_rule.str = null
+      @current_rule.hash ||= {}
+      @current_rule.hash.interval = parseInt($(event.currentTarget).val())
+      if @current_rule.hash.interval < 1 || isNaN(@current_rule.hash.interval)
+        @current_rule.hash.interval = 1
+        # $(event.currentTarget).val(@current_rule.hash.interval)
+      @summaryUpdate()
+
+    daysChanged: (event) =>
+      $(event.currentTarget).toggleClass("selected")
+      @current_rule.str = null
+      @current_rule.hash ||= {}
+      @current_rule.hash.validations = {}
+      raw_days = @content.find(".day_holder a.selected").map -> parseInt($(this).data("value"))
+      @current_rule.hash.validations.day = raw_days.get()
+      @summaryUpdate()
+      false # this prevents default and propogation
+
+    dateOfMonthChanged: (event) =>
+      $(event.currentTarget).toggleClass("selected")
+      @current_rule.str = null
+      @current_rule.hash ||= {}
+      @current_rule.hash.validations = {}
+      raw_days = @content.find(".monthly_options .rs_calendar_day a.selected").map ->
+        res = if $(this).text() == "Last Day" then -1 else parseInt($(this).text())
+        res
+      @current_rule.hash.validations.day_of_week = {}
+      @current_rule.hash.validations.day_of_month = raw_days.get()
+      @summaryUpdate()
+      false
+
+    weekOfMonthChanged: (event) =>
+      $(event.currentTarget).toggleClass("selected")
+      @current_rule.str = null
+      @current_rule.hash ||= {}
+      @current_rule.hash.validations = {}
+      @current_rule.hash.validations.day_of_month = []
+      @current_rule.hash.validations.day_of_week = {}
+      @content.find(".monthly_options .rs_calendar_week a.selected").each (index, elm) =>
+        day = parseInt($(elm).attr("day"))
+        instance = parseInt($(elm).attr("instance"))
+        @current_rule.hash.validations.day_of_week[day] ||= []
+        @current_rule.hash.validations.day_of_week[day].push instance
+      @summaryUpdate()
+      false
+

data/app/assets/stylesheets/jquery-mobile-rs.css.scss.erb

@@ -0,0 +1,33 @@
+/*
+*= require recurring_select
+*= require_self
+*/
+
+.rs_dialog_holder {padding-left:0px; background-color:#333; background-color:rgba(30,30,30,0.3); font-size:1em; position:absolute;
+  .rs_dialog { position:absolute; left:10px; right:10px; margin:0px; display:block; z-index:51;
+
+
+    .rs_dialog_content {
+
+      label.ui-select { display:inline-block;}
+      div.ui-select {display:inline-block;}
+
+      input.rs_interval {display:inline-block;}
+
+      .freq_option_section {
+        .day_holder {height:36px;
+          a {padding:10px 12px;}
+        }
+
+        .rs_calendar { width:225px;
+          * { text-shadow: none; }
+          a {padding:10px 8px;}
+          a.end_of_month { width: 111px; }
+        }
+      }
+
+      .rs_summary span { font-size:90%; font-weight:normal; }
+    }
+
+  }
+}

data/app/assets/stylesheets/recurring_select.css.scss.erb

@@ -0,0 +1,101 @@
+@import "utilities.scss";
+
+/* -------- resets ---------------*/
+
+.rs_dialog_holder { font-size:14px; color:black;
+  a {color:black;}
+  input[type=button] {
+    font: small/normal Arial,sans-serif;
+    background: #F5F5F5; color: #444; border: 1px solid #ccc;
+    font-size: 11px; font-weight: bold; height: 27px; line-height: 27px; outline: none; padding: 0 8px; text-align: center;
+
+    @include rounded_corners(2px);
+    @include gradiant(#f5f5f5, #f1f1f1);
+    filter: progid:DXImageTransform.Microsoft.gradient(startColorStr='#f5f5f5',EndColorStr='#f1f1f1');
+
+    &:hover {border-color:#aaa; color:#222; background-color:#f9f9f9; @include shadows(0px, 1px, 2px, rgba(0,0,0,0.2)); }
+    &:focus {border-color:#1E90FF;}
+    &:active {border-color:#1E90FF;}
+  }
+}
+
+/*------- defaults ------------ */
+.rs_dialog_holder { font-family:helvetica, arial, 'san-serif'; color:#222; font-size:12px;}
+
+/*------- specifics ------------ */
+
+select {
+  option.bold {font-weight:bold; color:red;}
+}
+
+.rs_dialog_holder { position:fixed; left:0px; right:0px; top:0px; bottom:0px; padding-left:50%; background-color:rgba(255,255,255,0.2); z-index:50;
+  .rs_dialog { background-color:#f6f6f6; border:1px solid #acacac; @include shadows(1px, 3px, 8px, rgba(0,0,0,0.25)); @include rounded_corners(7px);
+              display:inline-block; min-width:200px; margin-left:-125px; overflow:hidden; height:25px; position:relative;
+    .rs_dialog_content { padding:10px;
+      h1 { font-size:16px; padding:0px; margin:0 0 10px 0;
+        a {float:right; display:inline-block; height:16px; width:16px; background-image:url(<%=asset_path "recurring_select/cancel.png"%>); background-position:center; background-repeat:no-repeat;}
+      }
+
+      p { padding:5px 0; margin:0;
+        label {margin-right:10px;}
+      }
+
+      .freq_option_section { display:none;
+        label { font-weight: bold; }
+        .rs_interval {width:30px; text-align:center;}
+
+        .day_holder { border-left:1px solid #ccc; position:relative; margin-top:5px; height:26px;
+          a {display:block; padding:5px 7px; font-size:14px; border-style:solid; border-color:#ccc; border-width:1px 1px 1px 0px; float:left; text-decoration:none; font-weight:bold; @include inset_shadows(0px, 1px, 2px, rgba(0,0,0,0.1)); background-color:#fff;;
+            &.selected {background-color:#89a; color:#fff; @include inset_shadows(1px, 1px, 2px, rgba(0,0,0,0.2));  @include gradiant(#9ab, #789); }
+            &:hover { cursor:pointer; background-color:#dde;}
+          }
+        }
+
+        .rs_calendar_day, .rs_calendar_week {
+          width:155px;
+          a {display:inline-block; text-align:center; width:15px; padding:5px 3px; font-size:12px; border-style:solid; border-color:#ccc; border-width:1px 1px 1px 1px; margin:-1px 0 0 -1px; line-height:10px; background-color:#fff; font-weight:bold;
+            &.selected {background-color:#89a; color:#fff; @include gradiant(#9ab, #789); @include inset_shadows(0px, 1px, 2px, rgba(0,0,0,0.2)); text-shadow:0 1px 1px #333;}
+            &:hover { cursor:pointer; background-color:#dde;}
+          }
+          a.end_of_month { width: 81px; }
+        }
+        .rs_calendar_week {
+          width: 183px;
+          span {
+            display: inline-block;
+            width: 27px;
+          }
+        }
+
+        .monthly_rule_type {
+          span {
+            margin-right: 15px;
+          }
+        }
+      }
+
+
+      .rs_summary { padding:0px; margin-top:15px; border-top:1px solid #ccc;
+        span {font-weight:bold; border-top:1px solid #fff; display:block; padding:10px 0 5px 0;}
+        &.fetching {color:#999;
+          span {background-image:url(<%=asset_path "recurring_select/throbber_13x13.gif" %>); background-position:center; background-repeat:no-repeat; display:inline-block; height:13px; width:13px; margin-top:-4px; padding-right:5px;}
+        }
+        label {font-weight:normal;}
+      }
+
+      .controls { padding:10px 0px 5px 0px; min-width:170px; text-align:center;
+        input[type=button] { margin:0px 5px; width:70px;
+          &.rs_save {color:#333; }
+          &.rs_cancel {color:#666;}
+          &.disabled {color:#aaa; }
+        }
+      }
+    }
+
+    &.animated {
+      .controls {position:absolute; bottom:10px; left:10px;}
+      .rs_summary, .freq_option_section {display:none;}
+    }
+
+  }
+}

data/app/assets/stylesheets/utilities.scss

@@ -0,0 +1,26 @@
+@mixin shadows($x_offset: 0px, $y_offset: 1px, $size: 8px, $color: rgba(0, 0, 0, 0.5)) { 
+  -webkit-box-shadow: $x_offset $y_offset $size $color;
+  -moz-box-shadow:    $x_offset $y_offset $size $color;
+  -ms-box-shadow:     $x_offset $y_offset $size $color;
+  -o-box-shadow:      $x_offset $y_offset $size $color;
+  box-shadow:         $x_offset $y_offset $size $color;
+}
+
+@mixin inset_shadows($x_offset: 0px, $y_offset: 1px, $size: 8px, $color: rgba(0, 0, 0, 0.5)) { 
+  -webkit-box-shadow: $x_offset $y_offset $size $color inset;
+  -moz-box-shadow:    $x_offset $y_offset $size $color inset;
+  -ms-box-shadow:     $x_offset $y_offset $size $color inset;
+  -o-box-shadow:      $x_offset $y_offset $size $color inset;
+  box-shadow:         $x_offset $y_offset $size $color inset;
+}
+
+@mixin rounded_corners($radius: 5px) { -moz-border-radius: $radius; -webkit-border-radius: $radius; border-radius: $radius;}
+
+@mixin gradiant ($color_a:#aaa, $color_b:#bbb) { 
+  position:relative;
+  background-image:     -webkit-linear-gradient(top, $color_a, $color_b);                       /* Chrome 10+, Saf5.1+ */
+  background-image:     -webkit-gradient(linear, 0% 0%, 0% 100%, from($color_a), to($color_b)); /* Saf4+, Chrome */
+  background-image:     -moz-linear-gradient(top,$color_a,$color_b);                            /* FF3.6 */
+  background-image:     -ms-linear-gradient(top, $color_a, $color_b);                           /* IE10 */
+  background-image:     -o-linear-gradient(top, $color_a, $color_b);                            /* Opera 11.10+ */
+}

data/app/assets/templates/recurring_select/dialog_template.html

@@ -0,0 +1,77 @@
+<div class='rs_dialog_holder'>
+  <div class='rs_dialog'>
+    <div class='rs_dialog_content'>
+      <h1>Repeat <a href='#' title='Cancel' Alt='Cancel'></a> </h1>
+
+      <p>
+        <label for='rs_frequency'>Frequency:</label>
+        <select id='rs_frequency' class='rs_frequency' name='rs_frequency'>
+          <option value="Daily">Daily</option>
+          <option value="Weekly">Weekly</option>
+          <option value="Monthly">Monthly</option>
+          <option value="Yearly">Yearly</option>
+        </select>
+      </p>
+
+      <div class="daily_options freq_option_section">
+        <p>
+          Every
+          <input type='text' name='rs_daily_interval' class='rs_daily_interval rs_interval' value='1' size='2' />
+          day(s)
+        </p>
+      </div>
+
+      <div class="weekly_options freq_option_section">
+        <p>
+          Every
+          <input type='text' name='rs_weekly_interval' class='rs_weekly_interval rs_interval' value='1' size='2' />
+          week(s) on :
+        </p>
+        <div class="day_holder">
+          <a href="#" data-value='0'>S</a>
+          <a href="#" data-value='1'>M</a>
+          <a href="#" data-value='2'>T</a>
+          <a href="#" data-value='3'>W</a>
+          <a href="#" data-value='4'>T</a>
+          <a href="#" data-value='5'>F</a>
+          <a href="#" data-value='6'>S</a>
+        </div>
+
+        <span style="clear:both; visibility:hidden; height:1px;">.</span>
+      </div>
+
+      <div class="monthly_options freq_option_section">
+        <p>
+          Every
+          <input type='text' name='rs_monthly_interval' class='rs_monthly_interval rs_interval' value='1' size='2' />
+          month(s):
+        </p>
+        <p class="monthly_rule_type">
+          <span>Day of Month <input type="radio" class="monthly_rule_type_day" name="monthly_rule_type" value="true" /></span>
+          <span>Day of Week <input type="radio" class="monthly_rule_type_week" name="monthly_rule_type" value="true" /></span>
+        </p>
+        <p class="rs_calendar_day"></p>
+        <p class="rs_calendar_week"></p>
+      </div>
+
+      <div class="yearly_options freq_option_section">
+        <p>
+          Every
+          <input type='text' name='rs_yearly_interval' class='rs_yearly_interval rs_interval' value='1' size='2' />
+          year(s)
+        </p>
+      </div>
+
+
+      <p class='rs_summary'>
+        <span></span>
+      </p>
+
+      <div class="controls">
+        <input type="button" class="rs_save" value='OK' />
+        <input type="button" class="rs_cancel" value='Cancel' />
+      </div>
+
+    </div>
+  </div>
+</div>

data/app/helpers/recurring_select_helper.rb

@@ -0,0 +1,107 @@
+require "ice_cube"
+
+module RecurringSelectHelper
+  module FormHelper
+    def select_recurring(object, method, default_schedules = nil, options = {}, html_options = {})
+      InstanceTag.new(object, method, self, options.delete(:object)).to_recurring_select_tag(default_schedules, options, html_options)
+    end
+  end
+
+  module FormOptionsHelper
+    def recurring_options_for_select(currently_selected_rule = nil, default_schedules = nil, options = {})
+
+      options_array = []
+      blank_option_label = options[:blank_label] || "- not recurring -"
+      blank_option = [blank_option_label, "null"]
+      seperator = ["or", {:disabled => true}]
+
+      if default_schedules.blank?
+        if currently_selected_rule
+          options_array << blank_option if options[:allow_blank]
+          options_array << ice_cube_rule_to_option(currently_selected_rule)
+          options_array << seperator
+          options_array << ["Change schedule...", "custom"]
+        else
+          options_array << blank_option
+          options_array << ["Set schedule...", "custom"]
+        end
+      else
+        options_array << blank_option if options[:allow_blank]
+
+        options_array += default_schedules.collect{|dc|
+          ice_cube_rule_to_option(dc)
+        }
+
+        if currently_selected_rule and not current_rule_in_defaults?(currently_selected_rule, default_schedules)
+          options_array << ice_cube_rule_to_option(currently_selected_rule, true)
+          custom_label = ["New custom schedule...", "custom"]
+        else
+          custom_label = ["Custom schedule...", "custom"]
+        end
+
+        options_array << seperator
+        options_array << custom_label
+      end
+
+      options_for_select(options_array, currently_selected_rule.to_json)
+    end
+
+    private
+
+    def ice_cube_rule_to_option(supplied_rule, custom = false)
+      return supplied_rule unless RecurringSelect.is_valid_rule?(supplied_rule)
+
+      rule = supplied_rule.is_a?(Hash) ? IceCube::Rule.from_hash(supplied_rule) : supplied_rule
+      ar = [rule.to_s, rule.to_hash.to_json]
+
+      if custom
+        ar[0] << "*"
+        ar << {"data-custom" => true}
+      end
+
+      ar
+    end
+
+    def current_rule_in_defaults?(currently_selected_rule, default_schedules)
+      default_schedules.any?{|option|
+        option == currently_selected_rule or
+          (option.is_a?(Array) and option[1] == currently_selected_rule)
+      }
+    end
+
+  end
+
+  class InstanceTag < ActionView::Helpers::InstanceTag
+    include FormOptionsHelper
+
+    def to_recurring_select_tag(default_schedules, options, html_options)
+      html_options = recurring_select_html_options(html_options)
+      add_default_name_and_id(html_options)
+      value = value(object)
+      content_tag("select",
+                  add_options(
+                    recurring_options_for_select(value, default_schedules, options),
+                    options, value
+      ), html_options
+                 )
+    end
+
+    private
+
+    def recurring_select_html_options(html_options)
+      html_options = html_options.stringify_keys
+      html_options["class"] = ((html_options["class"] || "").split() + ["recurring_select"]).join(" ")
+      html_options
+    end
+  end
+
+  module FormBuilder
+    def select_recurring(method, default_schedules = nil, options = {}, html_options = {})
+      if !@template.respond_to?(:select_recurring)
+        @template.class.send(:include, RecurringSelectHelper::FormHelper)
+      end
+
+      @template.select_recurring(@object_name, method, default_schedules, options.merge(:object => @object), html_options)
+    end
+  end
+end

data/app/middleware/recurring_select_middleware.rb

@@ -0,0 +1,26 @@
+require "ice_cube"
+
+class RecurringSelectMiddleware
+
+  def initialize(app)
+    @app = app
+  end
+
+  def call(env)
+    if env["PATH_INFO"] =~ /^\/recurring_select\/translate/
+      request = Rack::Request.new(env)
+      params = request.params
+      params.symbolize_keys!
+
+      if params and params[:rule_type]
+        rule = RecurringSelect.dirty_hash_to_rule(params)
+        [200, {"Content-Type" => "text/html"}, [rule.to_s]]
+      else
+        [200, {"Content-Type" => "text/html"}, [""]]
+      end
+    else
+      @app.call(env)
+    end
+  end
+
+end

data/config/routes.rb

@@ -0,0 +1,2 @@
+Rails.application.routes.draw do
+end

data/lib/recurring_select.rb

@@ -0,0 +1,90 @@
+require "recurring_select/engine"
+require "ice_cube"
+
+#TODO: remove monkey patch when https://github.com/seejohnrun/ice_cube/issues/136 is fixed
+IceCube::ValidatedRule.class_eval do
+  alias old_to_s to_s
+  def to_s
+    old_to_s.gsub("when it is", "and")
+  end
+end
+
+module RecurringSelect
+
+  def self.dirty_hash_to_rule(params)
+    if params.is_a? IceCube::Rule
+      params
+    else
+      if params.is_a?(String)
+        params = JSON.parse(params)
+      end
+
+      params.symbolize_keys!
+      rules_hash = filter_params(params)
+
+      IceCube::Rule.from_hash(rules_hash)
+    end
+  end
+
+  def self.is_valid_rule?(possible_rule)
+    return true if possible_rule.is_a?(IceCube::Rule)
+    return false if possible_rule.blank?
+
+    if possible_rule.is_a?(String)
+      begin
+        JSON.parse(possible_rule)
+        return true
+      rescue JSON::ParserError
+        return false
+      end
+    end
+
+    # TODO: this should really have an extra step where it tries to perform the final parsing
+    return true if possible_rule.is_a?(Hash)
+
+    false #only a hash or a string of a hash can be valid
+  end
+
+  private
+
+  def self.filter_params(params)
+    params.reject!{|key, value| value.blank? || value=="null" }
+
+    params[:interval] = params[:interval].to_i if params[:interval]
+
+    params[:validations] ||= {}
+    params[:validations].symbolize_keys!
+
+    if params[:validations][:day]
+      params[:validations][:day] = params[:validations][:day].collect(&:to_i)
+    end
+
+    if params[:validations][:day_of_month]
+      params[:validations][:day_of_month] = params[:validations][:day_of_month].collect(&:to_i)
+    end
+
+    # this is soooooo ugly
+    if params[:validations][:day_of_week]
+      params[:validations][:day_of_week] ||= {}
+      if params[:validations][:day_of_week].length > 0 and not params[:validations][:day_of_week].keys.first =~ /\d/
+        params[:validations][:day_of_week].symbolize_keys!
+      else
+        originals = params[:validations][:day_of_week].dup
+        params[:validations][:day_of_week] = {}
+        originals.each{|key, value|
+          params[:validations][:day_of_week][key.to_i] = value
+        }
+      end
+      params[:validations][:day_of_week].each{|key, value|
+        params[:validations][:day_of_week][key] = value.collect(&:to_i)
+      }
+    end
+
+    if params[:validations][:day_of_year]
+      params[:validations][:day_of_year] = params[:validations][:day_of_year].collect(&:to_i)
+    end
+
+    params
+  end
+
+end

data/lib/recurring_select/engine.rb

@@ -0,0 +1,16 @@
+module RecurringSelect
+  class Engine < Rails::Engine
+    
+    initializer "recurring_select.extending_form_builder" do |app|
+    # config.to_prepare do
+      ActionView::Helpers::FormHelper.send(:include, RecurringSelectHelper::FormHelper)
+      ActionView::Helpers::FormOptionsHelper.send(:include, RecurringSelectHelper::FormOptionsHelper)
+      ActionView::Helpers::FormBuilder.send(:include, RecurringSelectHelper::FormBuilder)
+    end
+    
+    initializer "recurring_select.connecting_middleware" do |app|
+      app.middleware.use RecurringSelectMiddleware # insert_after ActionDispatch::ParamsParser, 
+    end
+    
+  end
+end

data/lib/recurring_select/version.rb

@@ -0,0 +1,3 @@
+module RecurringSelect
+  VERSION = "1.0.0"
+end

metadata

@@ -0,0 +1,163 @@
+--- !ruby/object:Gem::Specification
+name: recurring_select
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+  prerelease: 
+platform: ruby
+authors:
+- Jobber
+- Forrest Zeisler
+- Nathan Youngman
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-04-16 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rails
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '3.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '3.1'
+- !ruby/object:Gem::Dependency
+  name: jquery-rails
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: ice_cube
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0.8'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0.8'
+- !ruby/object:Gem::Dependency
+  name: sass-rails
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '3.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '3.1'
+- !ruby/object:Gem::Dependency
+  name: coffee-rails
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '3.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '3.1'
+- !ruby/object:Gem::Dependency
+  name: pry
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: This gem provides a useful interface for creating recurring rules for
+  the ice_cube gem.
+email:
+- forrest@getjobber.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- app/assets/images/recurring_select/cancel.png
+- app/assets/images/recurring_select/throbber_13x13.gif
+- app/assets/javascripts/jquery-mobile-rs.js.coffee
+- app/assets/javascripts/recurring_select.js.coffee
+- app/assets/javascripts/recurring_select_dialog.js.coffee.erb
+- app/assets/stylesheets/jquery-mobile-rs.css.scss.erb
+- app/assets/stylesheets/recurring_select.css.scss.erb
+- app/assets/stylesheets/utilities.scss
+- app/assets/templates/recurring_select/dialog_template.html
+- app/helpers/recurring_select_helper.rb
+- app/middleware/recurring_select_middleware.rb
+- config/routes.rb
+- lib/recurring_select/engine.rb
+- lib/recurring_select/version.rb
+- lib/recurring_select.rb
+- MIT-LICENSE
+- Rakefile
+- README.md
+homepage: http://github.com/getjobber/recurring_select
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.24
+signing_key: 
+specification_version: 3
+summary: A select helper which gives you magical powers to generate ice_cube rules.
+test_files: []
+has_rdoc: