active_scaffold 3.0.0

data/lib/active_scaffold/attribute_params.rb

@@ -0,0 +1,207 @@
+module ActiveScaffold
+  # Provides support for param hashes assumed to be model attributes.
+  # Support is primarily needed for creating/editing associated records using a nested hash structure.
+  #
+  # Paradigm Params Hash (should write unit tests on this):
+  #   params[:record] = {
+  #     # a simple record attribute
+  #     'name' => 'John',
+  #     # a plural association hash
+  #     'roles' => {
+  #       # associate with an existing role
+  #       '5' => {'id' => 5}
+  #       # associate with an existing role and edit it
+  #       '6' => {'id' => 6, 'name' => 'designer'}
+  #       # create and associate a new role
+  #       '124521' => {'name' => 'marketer'}
+  #     }
+  #     # a singular association hash
+  #     'location' => {'id' => 12, 'city' => 'New York'}
+  #   }
+  #
+  # Simpler association structures are also supported, like:
+  #   params[:record] = {
+  #     # a simple record attribute
+  #     'name' => 'John',
+  #     # a plural association ... all ids refer to existing records
+  #     'roles' => ['5', '6'],
+  #     # a singular association ... all ids refer to existing records
+  #     'location' => '12'
+  # }
+  module AttributeParams
+    protected
+    # Takes attributes (as from params[:record]) and applies them to the parent_record. Also looks for
+    # association attributes and attempts to instantiate them as associated objects.
+    #
+    # This is a secure way to apply params to a record, because it's based on a loop over the columns
+    # set. The columns set will not yield unauthorized columns, and it will not yield unregistered columns.
+    def update_record_from_params(parent_record, columns, attributes)
+      crud_type = parent_record.new_record? ? :create : :update
+      return parent_record unless parent_record.authorized_for?(:crud_type => crud_type)
+
+      multi_parameter_attributes = {}
+      attributes.each do |k, v|
+        next unless k.include? '('
+        column_name = k.split('(').first.to_sym
+        multi_parameter_attributes[column_name] ||= []
+        multi_parameter_attributes[column_name] << [k, v]
+      end
+
+      columns.each :for => parent_record, :crud_type => crud_type, :flatten => true do |column|
+        # Set any passthrough parameters that may be associated with this column (ie, file column "keep" and "temp" attributes)
+        unless column.params.empty?
+          column.params.each{|p| parent_record.send("#{p}=", attributes[p]) if attributes.has_key? p}
+        end
+
+        if multi_parameter_attributes.has_key? column.name
+          parent_record.send(:assign_multiparameter_attributes, multi_parameter_attributes[column.name])
+        elsif attributes.has_key? column.name
+          value = column_value_from_param_value(parent_record, column, attributes[column.name]) 
+
+          # we avoid assigning a value that already exists because otherwise has_one associations will break (AR bug in has_one_association.rb#replace)
+          parent_record.send("#{column.name}=", value) unless parent_record.send(column.name) == value
+          
+        # plural associations may not actually appear in the params if all of the options have been unselected or cleared away.
+        # the "form_ui" check is necessary, becuase without it we have problems
+        # with subforms. the UI cuts out deep associations, which means they're not present in the
+        # params even though they're in the columns list. the result is that associations were being
+        # emptied out way too often.
+        elsif column.form_ui and column.plural_association?
+          parent_record.send("#{column.name}=", [])
+        end
+      end
+
+      if parent_record.new_record?
+        parent_record.class.reflect_on_all_associations.each do |a|
+          next unless [:has_one, :has_many].include?(a.macro) and not a.options[:through]
+          next unless association_proxy = parent_record.send(a.name)
+
+          raise ActiveScaffold::ReverseAssociationRequired, "Association #{a.name}: In order to support :has_one and :has_many where the parent record is new and the child record(s) validate the presence of the parent, ActiveScaffold requires the reverse association (the belongs_to)." unless a.reverse
+
+          association_proxy = [association_proxy] if a.macro == :has_one
+          association_proxy.each { |record| record.send("#{a.reverse}=", parent_record) }
+        end
+      end
+
+      parent_record
+    end
+    
+    def manage_nested_record_from_params(parent_record, column, attributes)
+      record = find_or_create_for_params(attributes, column, parent_record)
+      if record
+        record_columns = active_scaffold_config_for(column.association.klass).subform.columns
+        update_record_from_params(record, record_columns, attributes)
+        record.unsaved = true
+      end
+      record
+    end
+    
+    def column_value_from_param_value(parent_record, column, value)
+      # convert the value, possibly by instantiating associated objects
+      if value.is_a?(Hash)
+        column_value_from_param_hash_value(parent_record, column, value)
+      else
+        column_value_from_param_simple_value(parent_record, column, value)
+      end
+    end
+
+    def column_value_from_param_simple_value(parent_record, column, value)
+      if column.singular_association?
+        # it's a single id
+        column.association.klass.find(value) if value and not value.empty?
+      elsif column.plural_association?
+        # it's an array of ids
+        if value and not value.empty?
+          ids = value.select {|id| id.respond_to?(:empty?) ? !id.empty? : true}
+          ids.empty? ? [] : column.association.klass.find(ids)
+        end
+      elsif column.column && column.column.number? && [:i18n_number, :currency].include?(column.options[:format])
+        self.class.i18n_number_to_native_format(value)
+      else
+        # convert empty strings into nil. this works better with 'null => true' columns (and validations),
+        # and 'null => false' columns should just convert back to an empty string.
+        # ... but we can at least check the ConnectionAdapter::Column object to see if nulls are allowed
+        value = nil if value.is_a? String and value.empty? and !column.column.nil? and column.column.null
+        value
+      end
+    end
+
+    def column_value_from_param_hash_value(parent_record, column, value)
+      # this is just for backwards compatibility. we should clean this up in 2.0.
+      if column.form_ui == :select
+        ids = if column.singular_association?
+          value[:id]
+        else
+          value.values.collect {|hash| hash[:id]}
+        end
+        (ids and not ids.empty?) ? column.association.klass.find(ids) : nil
+
+      elsif column.singular_association?
+        manage_nested_record_from_params(parent_record, column, value)
+      elsif column.plural_association?
+        value.collect {|key_value_pair| manage_nested_record_from_params(parent_record, column, key_value_pair[1])}.compact
+      else
+        value
+      end
+    end
+
+    # Attempts to create or find an instance of klass (which must be an ActiveRecord object) from the
+    # request parameters given. If params[:id] exists it will attempt to find an existing object
+    # otherwise it will build a new one.
+    def find_or_create_for_params(params, parent_column, parent_record)
+      current = parent_record.send(parent_column.name)
+      klass = parent_column.association.klass
+      return nil if parent_column.show_blank_record and attributes_hash_is_empty?(params, klass)
+
+      if params.has_key? :id
+        # modifying the current object of a singular association
+        if current and current.is_a? ActiveRecord::Base and current.id.to_s == params[:id]
+          return current
+        # modifying one of the current objects in a plural association
+        elsif current and current.respond_to?(:any?) and current.any? {|o| o.id.to_s == params[:id]}
+          return current.detect {|o| o.id.to_s == params[:id]}
+        # attaching an existing but not-current object
+        else
+          return klass.find(params[:id])
+        end
+      else
+        if klass.authorized_for?(:crud_type => :create)
+          if parent_column.singular_association?
+            return parent_record.send("build_#{parent_column.name}")
+          else
+            return parent_record.send(parent_column.name).build
+          end
+        end
+      end
+    end
+
+    # Determines whether the given attributes hash is "empty".
+    # This isn't a literal emptiness - it's an attempt to discern whether the user intended it to be empty or not.
+    def attributes_hash_is_empty?(hash, klass)
+      ignore_column_types = [:boolean]
+      hash.all? do |key,value|
+        # convert any possible multi-parameter attributes like 'created_at(5i)' to simply 'created_at'
+        parts = key.to_s.split('(')
+        #old style date form management... ignore them too
+        ignore_column_types = [:boolean, :datetime, :date, :time] if parts.length > 1
+        column_name = parts.first
+        column = klass.columns_hash[column_name]
+
+        # booleans and datetimes will always have a value. so we ignore them when checking whether the hash is empty.
+        # this could be a bad idea. but the current situation (excess record entry) seems worse.
+        next true if column and ignore_column_types.include?(column.type)
+
+        # defaults are pre-filled on the form. we can't use them to determine if the user intends a new row.
+        next true if column and value == column.default.to_s
+
+        if value.is_a?(Hash)
+          attributes_hash_is_empty?(value, klass)
+        elsif value.is_a?(Array)
+          value.any? {|id| id.respond_to?(:empty?) ? !id.empty? : true}
+        else
+          value.respond_to?(:empty?) ? value.empty? : false
+        end
+      end
+    end
+  end
+end

data/lib/active_scaffold/bridges/ancestry/bridge.rb

@@ -0,0 +1,5 @@
+ActiveScaffold::Bridges.bridge "Ancestry" do
+  install do
+    require File.join(File.dirname(__FILE__), "lib/ancestry_bridge.rb")
+  end
+end

data/lib/active_scaffold/bridges/ancestry/lib/ancestry_bridge.rb

@@ -0,0 +1,38 @@
+ActiveScaffold::Config::Core.class_eval do
+  def initialize_with_ancestry(model_id)
+    initialize_without_ancestry(model_id)
+
+    return unless self.model.respond_to? :ancestry_column
+
+    col_config = self.columns[self.model.ancestry_column]
+    unless col_config.nil?
+      col_config.form_ui = :ancestry
+      create.columns.exclude :ancestry
+      list.columns.exclude :ancestry
+    end
+  end
+
+  alias_method_chain :initialize, :ancestry
+end
+
+module ActiveScaffold
+  module AncestryBridge
+    module FormColumnHelpers
+      def active_scaffold_input_ancestry(column, options)
+        select_options = []
+        traverse_ancestry = proc do|key, value|
+          unless key == @record
+            select_options << ["#{'__' * key.depth}#{key.to_label}", key.id]
+            value.each(&traverse_ancestry) if value.is_a?(Hash) && !value.empty?
+          end
+        end
+        @record.class.arrange.each(&traverse_ancestry)
+        select(:record, :ancestry, select_options, { :selected => @record.send(:ancestry) }, options)
+      end
+    end
+  end
+end
+
+ActionView::Base.class_eval do
+  include ActiveScaffold::AncestryBridge::FormColumnHelpers
+end

data/lib/active_scaffold/bridges/bridge.rb

@@ -0,0 +1,52 @@
+module ActiveScaffold
+  module Bridges
+    def self.bridge(name, &block)
+      ActiveScaffold::Bridges::Bridge.new(name, &block)
+    end
+    
+    class Bridge
+      attr_accessor :name
+      cattr_accessor :bridges
+      cattr_accessor :bridges_run
+      self.bridges = []
+      
+      def initialize(name, &block)
+        self.name = name
+        @install = nil
+        # by convention and default, use the bridge name as the required constant for installation
+        @install_if = lambda { Object.const_defined?(name) }
+        self.instance_eval(&block)
+        
+        ActiveScaffold::Bridges::Bridge.bridges << self
+      end
+      
+      # Set the install block
+      def install(&block)
+        @install = block
+      end
+      
+      # Set the install_if block (to check to see whether or not to install the block)
+      def install?(&block)
+        @install_if = block
+      end
+      
+      
+      def run
+        raise(ArgumentError, "install and install? not defined for bridge #{name}" ) unless @install && @install_if
+        @install.call if @install_if.call
+      end
+      
+      def self.run_all
+        return false if self.bridges_run
+        ActiveScaffold::Bridges::Bridge.bridges.each{|bridge|
+          bridge.run
+        }
+        self.bridges_run=true
+      end
+    end
+  end
+end
+
+Dir[File.join(File.dirname(__FILE__), "*/bridge.rb")].each{|bridge_require|
+  require bridge_require
+} 

data/lib/active_scaffold/bridges/calendar_date_select/bridge.rb

@@ -0,0 +1,16 @@
+ActiveScaffold::Bridges.bridge "CalendarDateSelect" do
+  install do
+    # check to see if the old bridge was installed.  If so, warn them
+    # we can detect this by checking to see if the bridge was installed before calling this code
+       
+    if ActiveScaffold::Config::Core.instance_methods.include?("initialize_with_calendar_date_select")
+      raise RuntimeError, "We've detected that you have active_scaffold_calendar_date_select_bridge installed.  This plugin has been moved to core.  Please remove active_scaffold_calendar_date_select_bridge to prevent any conflicts"
+    end
+    
+    require File.join(File.dirname(__FILE__), "lib/as_cds_bridge.rb")
+  end
+  
+  install? do
+    Object.const_defined?(name) && ActiveScaffold.js_framework == :prototype
+  end
+end

data/lib/active_scaffold/bridges/calendar_date_select/lib/as_cds_bridge.rb

@@ -0,0 +1,79 @@
+module ActiveScaffold::Config
+  class Core < Base
+
+    def initialize_with_calendar_date_select(model_id)
+      initialize_without_calendar_date_select(model_id)
+      
+      calendar_date_select_fields = self.model.columns.collect{|c| c.name.to_sym if [:date, :datetime].include?(c.type) }.compact
+      # check to see if file column was used on the model
+      return if calendar_date_select_fields.empty?
+      
+      # automatically set the forum_ui to a file column
+      calendar_date_select_fields.each{|field|
+        self.columns[field].form_ui = :calendar_date_select
+      }
+    end
+    
+    alias_method_chain :initialize, :calendar_date_select
+    
+  end
+end
+
+
+module ActiveScaffold
+  module Bridges
+    module CalendarDateSelectBridge
+      # Helpers that assist with the rendering of a Form Column
+      module FormColumnHelpers
+        def active_scaffold_input_calendar_date_select(column, options)
+          options[:class] = "#{options[:class]} text-input".strip
+          calendar_date_select("record", column.name, options.merge(column.options))
+        end      
+      end
+      
+      module SearchColumnHelpers
+        def active_scaffold_search_date_bridge_calendar_control(column, options, current_search, name)
+          if current_search.is_a? Hash
+            value = controller.class.condition_value_for_datetime(current_search[name], column.column.type == :date ? :to_date : :to_time)
+          else
+            value = current_search
+          end
+          calendar_date_select("record", column.name, 
+            {:name => "#{options[:name]}[#{name}]",
+             :value => (value ? l(value) : nil),
+             :class => 'text-input',
+             :id => "#{options[:id]}_#{name}",
+             :time => column_datetime?(column) ? true : false,
+             :style => "display:#{(options[:show].nil? || options[:show]) ? '' : 'none'}"})
+        end
+      end
+  
+      module ViewHelpers
+        # Provides stylesheets to include with +stylesheet_link_tag+
+        def active_scaffold_stylesheets(frontend = :default)
+          super + [calendar_date_select_stylesheets]
+        end
+  
+        # Provides stylesheets to include with +stylesheet_link_tag+
+        def active_scaffold_javascripts(frontend = :default)
+          super + [calendar_date_select_javascripts]
+        end
+      end
+    end
+  end
+end
+
+ActionView::Base.class_eval do
+  include ActiveScaffold::Bridges::CalendarDateSelectBridge::FormColumnHelpers
+  include ActiveScaffold::Bridges::Shared::DateBridge::SearchColumnHelpers
+  alias_method :active_scaffold_search_calendar_date_select, :active_scaffold_search_date_bridge
+  include ActiveScaffold::Bridges::Shared::DateBridge::HumanConditionHelpers
+  alias_method :active_scaffold_human_condition_calendar_date_select, :active_scaffold_human_condition_date_bridge
+  include ActiveScaffold::Bridges::CalendarDateSelectBridge::SearchColumnHelpers
+  include ActiveScaffold::Bridges::CalendarDateSelectBridge::ViewHelpers
+end
+
+ActiveScaffold::Finder::ClassMethods.module_eval do
+  include ActiveScaffold::Bridges::Shared::DateBridge::Finder::ClassMethods
+  alias_method :condition_for_calendar_date_select_type, :condition_for_date_bridge_type
+end

data/lib/active_scaffold/bridges/carrierwave/bridge.rb

@@ -0,0 +1,7 @@
+ActiveScaffold::Bridges.bridge "CarrierWave" do
+  install do
+    require File.join(File.dirname(__FILE__), "lib/form_ui")
+    require File.join(File.dirname(__FILE__), "lib/list_ui")
+    ActiveScaffold::Config::Core.send :include, ActiveScaffold::Bridges::Carrierwave::Lib::CarrierwaveBridge
+  end
+end

data/lib/active_scaffold/bridges/carrierwave/lib/carrierwave_bridge.rb

@@ -0,0 +1,38 @@
+module ActiveScaffold
+  module Bridges
+    module Carrierwave
+      module Lib
+        module CarrierwaveBridge
+          def initialize_with_carrierwave(model_id)
+            initialize_without_carrierwave(model_id)
+            return unless self.model.respond_to?(:uploaders) && self.model.uploaders.present?
+      
+            self.update.multipart = true
+            self.create.multipart = true
+      
+            self.model.uploaders.keys.each do |field|
+              configure_carrierwave_field(field.to_sym)
+              # define the "delete" helper for use with active scaffold, unless it's already defined
+              ActiveScaffold::Bridges::Carrierwave::Lib::CarrierwaveBridgeHelpers.generate_delete_helper(self.model, field)
+            end
+          end
+      
+          def self.included(base)
+            base.alias_method_chain :initialize, :carrierwave
+          end
+      
+          private
+          def configure_carrierwave_field(field)
+            self.columns << field
+            self.columns[field].form_ui ||= :carrierwave
+            self.columns[field].params.add "delete_#{field}"
+      
+#            [:file_name, :content_type, :file_size, :updated_at].each do |f|
+#              self.columns.exclude("#{field}_#{f}".to_sym)
+#            end
+          end
+        end
+      end
+    end
+  end
+end