crest_in_place 2.2.0

data/lib/assets/javascripts/best_in_place.purr.js

@@ -0,0 +1,10 @@
+//= require jquery.purr
+
+jQuery(document).on('best_in_place:error', function(event, request, error) {
+    // Display all error messages from server side validation
+    jQuery.each(jQuery.parseJSON(request.responseText), function(index, value) {
+      if( typeof(value) == "object") {value = index + " " + value.toString(); }
+      var container = jQuery("<span class='flash-error'></span>").html(value);
+      container.purr();
+    });
+});

data/lib/assets/javascripts/jquery.purr.js

@@ -0,0 +1,135 @@
+/**
+ * jquery.purr.js
+ * Copyright (c) 2008 Net Perspective (net-perspective.com)
+ * Licensed under the MIT License (http://www.opensource.org/licenses/mit-license.php)
+ *
+ * @author R.A. Ray
+ * @projectDescription  jQuery plugin for dynamically displaying unobtrusive messages in the browser. Mimics the behavior of the MacOS program "Growl."
+ * @version 0.1.0
+ *
+ * @requires jquery.js (tested with 1.2.6)
+ *
+ * @param fadeInSpeed           int - Duration of fade in animation in miliseconds
+ *                          default: 500
+ *  @param fadeOutSpeed         int - Duration of fade out animationin miliseconds
+                            default: 500
+ *  @param removeTimer          int - Timeout, in miliseconds, before notice is removed once it is the top non-sticky notice in the list
+                            default: 4000
+ *  @param isSticky             bool - Whether the notice should fade out on its own or wait to be manually closed
+                            default: false
+ *  @param usingTransparentPNG  bool - Whether or not the notice is using transparent .png images in its styling
+                            default: false
+ */
+
+(function(jQuery) {
+
+  jQuery.purr = function(notice, options)
+  {
+    // Convert notice to a jQuery object
+    notice = jQuery(notice);
+
+    // Add a class to denote the notice as not sticky
+    notice.addClass('purr');
+
+    // Get the container element from the page
+    var cont = document.getElementById('purr-container');
+
+    // If the container doesn't yet exist, we need to create it
+    if (!cont)
+    {
+      cont = '<div id="purr-container"></div>';
+    }
+
+    // Convert cont to a jQuery object
+    cont = jQuery(cont);
+
+    // Add the container to the page
+    jQuery('body').append(cont);
+
+    notify();
+
+    function notify ()
+    {
+      // Set up the close button
+      var close = document.createElement('a');
+      jQuery(close).attr({
+          className: 'close',
+          href: '#close'
+          }).appendTo(notice).click(function() {
+              removeNotice();
+              return false;
+          });
+
+      // If ESC is pressed remove notice
+      jQuery(document).keyup(function(e) {
+        if (e.keyCode === 27) {
+          removeNotice();
+        }
+      });
+
+      // Add the notice to the page and keep it hidden initially
+      notice.appendTo(cont).hide();
+
+      //Fade in the notice we just added
+      notice.fadeIn(options.fadeInSpeed);
+
+      // Set up the removal interval for the added notice if that notice is not a sticky
+      if (!options.isSticky)
+      {
+        var topSpotInt = setInterval(function() {
+          // Check to see if our notice is the first non-sticky notice in the list
+          if (notice.prevAll('.purr').length === 0)
+          {
+            // Stop checking once the condition is met
+            clearInterval(topSpotInt);
+
+            // Call the close action after the timeout set in options
+            setTimeout(function() {
+                removeNotice();
+              }, options.removeTimer);
+          }
+        }, 200);
+      }
+    }
+
+    function removeNotice()
+    {
+      // Fade the object out before reducing its height to produce the sliding effect
+      notice.animate({ opacity: '0' },
+        {
+          duration: options.fadeOutSpeed,
+          complete: function ()
+            {
+              notice.animate({ height: '0px' },
+                {
+                  duration: options.fadeOutSpeed,
+                  complete: function()
+                    {
+                      notice.remove();
+                    }
+                }
+              );
+            }
+        }
+      );
+    };
+  };
+
+  jQuery.fn.purr = function(options)
+  {
+    options = options || {};
+    options.fadeInSpeed = options.fadeInSpeed || 500;
+    options.fadeOutSpeed = options.fadeOutSpeed || 500;
+    options.removeTimer = options.removeTimer || 4000;
+    options.isSticky = options.isSticky || false;
+    options.usingTransparentPNG = options.usingTransparentPNG || false;
+
+    this.each(function()
+      {
+        new jQuery.purr( this, options );
+      }
+    );
+
+    return this;
+  };
+})( jQuery );

data/lib/crest_in_place.rb

@@ -0,0 +1,12 @@
+require "crest_in_place/check_version"
+require "crest_in_place/utils"
+require "crest_in_place/helper"
+require "crest_in_place/engine"
+require "crest_in_place/railtie"
+require "crest_in_place/controller_extensions"
+require "crest_in_place/display_methods"
+require "action_view"
+
+module CrestInPlace
+  autoload :TestHelpers, "crest_in_place/test_helpers"
+end

data/lib/crest_in_place/check_version.rb

@@ -0,0 +1,8 @@
+module CrestInPlace
+  module CheckVersion
+    if Rails::VERSION::STRING < "3.1"
+      raise "This version of Best in Place is intended to be used for Rails >= 3.1. If you want to use it with Rails 3.0 or lower, please use the rails-3.0 branch."
+      return
+    end
+  end
+end

data/lib/crest_in_place/controller_extensions.rb

@@ -0,0 +1,28 @@
+module CrestInPlace
+  module ControllerExtensions
+    def respond_with_bip(obj)
+      obj.changed? ? respond_bip_error(obj) : respond_bip_ok(obj)
+    end
+
+  private
+    def respond_bip_ok(obj)
+      if obj.respond_to?(:id)
+        klass = "#{obj.class}_#{obj.id}"
+      else
+        klass = obj.class.to_s
+      end
+      param_key = CrestInPlace::Utils.object_to_key(obj)
+      updating_attr = params[param_key].keys.first
+
+      if renderer = CrestInPlace::DisplayMethods.lookup(klass, updating_attr)
+        render :json => renderer.render_json(obj)
+      else
+        head :no_content
+      end
+    end
+
+    def respond_bip_error(obj)
+      render :json => obj.errors.full_messages, :status => :unprocessable_entity
+    end
+  end
+end

data/lib/crest_in_place/display_methods.rb

@@ -0,0 +1,44 @@
+module CrestInPlace
+  module DisplayMethods
+    extend self
+
+    class Renderer < Struct.new(:opts)
+      def render_json(object)
+        case opts[:type]
+        when :model
+          {:display_as => object.send(opts[:method])}.to_json
+        when :helper
+          value = if opts[:helper_options]
+                    CrestInPlace::ViewHelpers.send(opts[:method], object.send(opts[:attr]), opts[:helper_options])
+                  else
+                    CrestInPlace::ViewHelpers.send(opts[:method], object.send(opts[:attr]))
+                  end
+          {:display_as => value}.to_json
+        when :proc
+          {:display_as => opts[:proc].call(object.send(opts[:attr]))}.to_json
+        else
+          {}.to_json
+        end
+      end
+    end
+
+    @@table = Hash.new { |h,k| h[k] = Hash.new(&h.default_proc) }
+
+    def lookup(klass, attr)
+      foo = @@table[klass.to_s][attr.to_s]
+      foo == {} ? nil : foo
+    end
+
+    def add_model_method(klass, attr, display_as)
+      @@table[klass.to_s][attr.to_s] = Renderer.new :method => display_as.to_sym, :type => :model
+    end
+
+    def add_helper_method(klass, attr, helper_method, helper_options = nil)
+      @@table[klass.to_s][attr.to_s] = Renderer.new :method => helper_method.to_sym, :type => :helper, :attr => attr, :helper_options => helper_options
+    end
+    
+    def add_helper_proc(klass, attr, helper_proc)
+      @@table[klass.to_s][attr.to_s] = Renderer.new :type => :proc, :attr => attr, :proc => helper_proc
+    end
+  end
+end

data/lib/crest_in_place/engine.rb

@@ -0,0 +1,8 @@
+module CrestInPlace
+  class Engine < Rails::Engine
+    initializer "setup for rails" do
+      ActionView::Base.send(:include, CrestInPlace::CrestInPlaceHelpers)
+      ActionController::Base.send(:include, CrestInPlace::ControllerExtensions)
+    end
+  end
+end

data/lib/crest_in_place/helper.rb

@@ -0,0 +1,132 @@
+module CrestInPlace
+  module CrestInPlaceHelpers
+
+    def best_in_place(object, field, opts = {})
+      if opts[:display_as] && opts[:display_with]
+        raise ArgumentError, "Can't use both 'display_as' and 'display_with' options at the same time"
+      end
+
+      if opts[:display_with] && !opts[:display_with].is_a?(Proc) && !ViewHelpers.respond_to?(opts[:display_with])
+        raise ArgumentError, "Can't find helper #{opts[:display_with]}"
+      end
+
+      real_object = real_object_for object
+      opts[:type] ||= :input
+      opts[:collection] ||= []
+      field = field.to_s
+
+      display_value = build_value_for(real_object, field, opts)
+
+      collection = nil
+      value = nil
+      if opts[:type] == :select && !opts[:collection].blank?
+        value = real_object.send(field)
+        display_value = Hash[opts[:collection]].stringify_keys[value.to_s]
+        collection = opts[:collection].to_json
+      end
+      if opts[:type] == :checkbox
+        value = !!real_object.send(field)
+        if opts[:collection].blank? || opts[:collection].size != 2
+          opts[:collection] = ["No", "Yes"]
+        end
+        display_value = value ? opts[:collection][1] : opts[:collection][0]
+        collection = opts[:collection].to_json
+      end
+      classes = ["best_in_place"]
+      unless opts[:classes].nil?
+        # the next three lines enable this opt to handle both a stings and a arrays
+        classes << opts[:classes]
+        classes.flatten!
+      end
+
+      out = "<span class='#{classes.join(" ")}'"
+      out << " id='#{CrestInPlace::Utils.build_best_in_place_id(real_object, field)}'"
+      out << " data-url='#{opts[:path].blank? ? url_for(object) : url_for(opts[:path])}'"
+      out << " data-object='#{opts[:object_name] || CrestInPlace::Utils.object_to_key(real_object)}'"
+      out << " data-collection='#{attribute_escape(collection)}'" unless collection.blank?
+      out << " data-attribute='#{field}'"
+      out << " data-activator='#{opts[:activator]}'" unless opts[:activator].blank?
+      out << " data-ok-button='#{opts[:ok_button]}'" unless opts[:ok_button].blank?
+      out << " data-ok-button-class='#{opts[:ok_button_class]}'" unless opts[:ok_button_class].blank?
+      out << " data-cancel-button='#{opts[:cancel_button]}'" unless opts[:cancel_button].blank?
+      out << " data-cancel-button-class='#{opts[:cancel_button_class]}'" unless opts[:cancel_button_class].blank?
+      out << " data-nil='#{attribute_escape(opts[:nil])}'" unless opts[:nil].blank?
+      out << " data-use-confirm='#{opts[:use_confirm]}'" unless opts[:use_confirm].nil?
+      out << " data-type='#{opts[:type]}'"
+      out << " data-inner-class='#{opts[:inner_class]}'" if opts[:inner_class]
+      out << " data-html-attrs='#{opts[:html_attrs].to_json}'" unless opts[:html_attrs].blank?
+      out << " data-original-content='#{attribute_escape(real_object.send(field))}'" if opts[:display_as] || opts[:display_with]
+      out << " data-value='#{attribute_escape(value)}'" if value
+
+      if opts[:data] && opts[:data].is_a?(Hash)
+        opts[:data].each do |k, v|
+          if !v.is_a?(String) && !v.is_a?(Symbol)
+            v = v.to_json
+          end
+          out << %( data-#{k.to_s.dasherize}="#{v}")
+        end
+      end
+      if !opts[:sanitize].nil? && !opts[:sanitize]
+        out << " data-sanitize='false'>"
+        out << display_value.to_s
+      else
+        out << ">#{h(display_value.to_s)}"
+      end
+      out << "</span>"
+      raw out
+    end
+
+    def best_in_place_if(condition, object, field, opts={})
+      if condition
+        best_in_place(object, field, opts)
+      else
+        build_value_for real_object_for(object), field, opts
+      end
+    end
+
+  private
+    def build_value_for(object, field, opts)
+      return "" if object.send(field).blank?
+
+      klass = if object.respond_to?(:id)
+        "#{object.class}_#{object.id}"
+      else
+        object.class.to_s
+      end
+
+      if opts[:display_as]
+        CrestInPlace::DisplayMethods.add_model_method(klass, field, opts[:display_as])
+        object.send(opts[:display_as]).to_s
+
+      elsif opts[:display_with].try(:is_a?, Proc)
+        CrestInPlace::DisplayMethods.add_helper_proc(klass, field, opts[:display_with])
+        opts[:display_with].call(object.send(field))
+
+      elsif opts[:display_with]
+        CrestInPlace::DisplayMethods.add_helper_method(klass, field, opts[:display_with], opts[:helper_options])
+        if opts[:helper_options]
+          CrestInPlace::ViewHelpers.send(opts[:display_with], object.send(field), opts[:helper_options])
+        else
+          CrestInPlace::ViewHelpers.send(opts[:display_with], object.send(field))
+        end
+
+      else
+        object.send(field).to_s
+      end
+    end
+
+    def attribute_escape(data)
+      return unless data
+
+      data.to_s.
+        gsub("&", "&amp;").
+        gsub("'", "&apos;").
+        gsub(/\r?\n/, "&#10;")
+    end
+
+    def real_object_for(object)
+      (object.is_a?(Array) && object.last.class.respond_to?(:model_name)) ? object.last : object
+    end
+  end
+end
+

data/lib/crest_in_place/railtie.rb

@@ -0,0 +1,7 @@
+module CrestInPlace
+  class Railtie < Rails::Railtie
+    config.after_initialize do
+      CrestInPlace::ViewHelpers = ActionView::Base.new
+    end
+  end
+end

data/lib/crest_in_place/test_helpers.rb

@@ -0,0 +1,42 @@
+module CrestInPlace
+  module TestHelpers
+    
+    include ActionView::Helpers::JavaScriptHelper
+
+    def bip_area(model, attr, new_value)
+      id = CrestInPlace::Utils.build_best_in_place_id model, attr
+      page.execute_script <<-JS
+        jQuery("##{id}").click();
+        jQuery("##{id} form textarea").val('#{escape_javascript new_value.to_s}');
+        jQuery("##{id} form textarea").blur();
+        jQuery("##{id} form textarea").blur();
+      JS
+    end
+
+    def bip_text(model, attr, new_value)
+      id = CrestInPlace::Utils.build_best_in_place_id model, attr
+      page.execute_script <<-JS
+        jQuery("##{id}").click();
+        jQuery("##{id} input[name='#{attr}']").val('#{escape_javascript new_value.to_s}');
+        jQuery("##{id} form").submit();
+      JS
+    end
+
+    def bip_bool(model, attr)
+      id = CrestInPlace::Utils.build_best_in_place_id model, attr
+      page.execute_script("jQuery('##{id}').click();")
+    end
+
+    def bip_select(model, attr, name)
+      id = CrestInPlace::Utils.build_best_in_place_id model, attr
+      page.execute_script <<-JS
+        (function() {
+          jQuery("##{id}").click();
+          var opt_value = jQuery("##{id} select option:contains('#{name}')").attr('value');
+          jQuery("##{id} select option[value='" + opt_value + "']").attr('selected', true);
+          jQuery("##{id} select").change();
+        })();
+      JS
+    end
+  end
+end

data/lib/crest_in_place/utils.rb

@@ -0,0 +1,21 @@
+module CrestInPlace
+  module Utils
+    extend self
+
+    def build_best_in_place_id(object, field)
+      if object.is_a?(Symbol) || object.is_a?(String)
+        return "best_in_place_#{object}_#{field}"
+      end
+
+      id = "best_in_place_#{object_to_key(object)}"
+      id << "_#{object.id}" if object.class.ancestors.include?(ActiveModel::Serializers::JSON)
+      id << "_#{field}"
+      id
+    end
+
+    def object_to_key(object)
+      return object.class.to_s.underscore unless object.class.respond_to?(:model_name)
+      ActiveModel::Naming.param_key(object.class)
+    end
+  end
+end