active_scaffold 3.0.23 → 3.0.24

data/lib/active_scaffold/attribute_params.rb~

@@ -0,0 +1,202 @@
+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
+          
+        elsif 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] || a.options[:finder_sql])
+          next unless association_proxy = parent_record.send(a.name)
+
+          raise ActiveScaffold::ReverseAssociationRequired, "Association #{a.name} in class #{parent_record.class.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)
+      debugger if column.name == :working_days
+      if column.singular_association?
+        # it's a single id
+        column.association.klass.find(value) if value and not value.empty?
+      elsif column.plural_association?
+        column_plural_assocation_value_from_value(column, value)
+      elsif 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_plural_assocation_value_from_value(column, value)
+      # 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
+    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
+      pk = klass.primary_key.to_sym
+      return nil if parent_column.show_blank_record?(current) and attributes_hash_is_empty?(params, klass)
+
+      if params.has_key? pk
+        # modifying the current object of a singular association
+        pk_val = params[pk] 
+        if current and current.is_a? ActiveRecord::Base and current.id.to_s == pk_val
+          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 == pk_val}
+          current.detect {|o| o.id.to_s == pk_val}
+        # attaching an existing but not-current object
+        else
+          klass.find(pk_val)
+        end
+      else
+        build_associated(parent_column, parent_record) if klass.authorized_for?(:crud_type => :create)
+      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/record_select/{lib/record_select_bridge.rb~ → helpers.rb~}

@@ -1,20 +1,9 @@
-module ActiveScaffold
-  module RecordSelectBridge
+class ActiveScaffold::Bridges::RecordSelect
+  module Helpers
     def self.included(base)
       base.class_eval do
         include FormColumnHelpers
         include SearchColumnHelpers
-        include ViewHelpers
-      end
-    end
-
-    module ViewHelpers
-      def self.included(base)
-        base.alias_method_chain :active_scaffold_includes, :record_select
-      end
-
-      def active_scaffold_includes_with_record_select(*args)
-        active_scaffold_includes_without_record_select(*args) + record_select_includes
       end
     end
 
@@ -50,15 +39,17 @@ module ActiveScaffold
         record_select_options.merge!(column.options)
         if options['data-update_url']
           record_select_options[:onchange] = %|function(id, label) {
-              ActiveScaffold.update_column($("##{options[:id]}"), "#{options['data-update_url']}", #{options['data-update_send_form'].to_json}, "#{options[:id]}", id);
+              ActiveScaffold.update_column(null, "#{options['data-update_url']}", #{options['data-update_send_form'].to_json}, "#{options[:id]}", id);
             }|
         end
  
-        if multiple
+        html = if multiple
           record_multi_select_field(options[:name], value || [], record_select_options)
         else
           record_select_field(options[:name], value || column.association.klass.new, record_select_options)
         end
+        html = self.class.field_error_proc.call(html, self) if @record.errors[column.name].any?
+        html
       end
     end
 
@@ -87,4 +78,4 @@ module ActiveScaffold
   end
 end
 
-ActionView::Base.class_eval { include ActiveScaffold::RecordSelectBridge }
+ActionView::Base.class_eval { include ActiveScaffold::Bridges::RecordSelect::Helpers }

data/lib/active_scaffold/bridges/shared/date_bridge.rb~

@@ -0,0 +1,209 @@
+module ActiveScaffold
+  module Bridges
+    module Shared
+      module DateBridge
+        module SearchColumnHelpers
+          def active_scaffold_search_date_bridge(column, options)
+            current_search = {'from' => nil, 'to' => nil, 'opt' => 'BETWEEN',
+                              'number' => 1, 'unit' => 'DAYS', 'range' => nil}
+            current_search.merge!(options[:value]) unless options[:value].nil?
+            tags = []
+            tags << active_scaffold_search_date_bridge_comparator_tag(column, options, current_search)
+            tags << active_scaffold_search_date_bridge_trend_tag(column, options, current_search)
+            tags << active_scaffold_search_date_bridge_numeric_tag(column, options, current_search)
+            tags << active_scaffold_search_date_bridge_range_tag(column, options, current_search)
+            tags.join("&nbsp;").html_safe
+          end
+          
+          def active_scaffold_search_date_bridge_comparator_options(column)
+            select_options = ActiveScaffold::Finder::DateComparators.collect {|comp| [as_(comp.downcase.to_sym), comp]}
+            select_options + ActiveScaffold::Finder::NumericComparators.collect {|comp| [as_(comp.downcase.to_sym), comp]}
+          end
+          
+          def active_scaffold_search_date_bridge_comparator_tag(column, options, current_search)
+            select_tag("#{options[:name]}[opt]", options_for_select(active_scaffold_search_date_bridge_comparator_options(column),current_search['opt']), :id => "#{options[:id]}_opt", :class => "as_search_range_option as_search_date_time_option")
+          end
+          
+          def active_scaffold_search_date_bridge_numeric_tag(column, options, current_search)
+            numeric_controls = "" << 
+            active_scaffold_search_date_bridge_calendar_control(column, options, current_search, 'from') <<
+            content_tag(:span, (" - " + active_scaffold_search_date_bridge_calendar_control(column, options, current_search, 'to')).html_safe,
+              :id => "#{options[:id]}_between", :class => "as_search_range_between", :style => "display:#{current_search['opt'] == 'BETWEEN' ? '' : 'none'}")  
+            content_tag("span", numeric_controls.html_safe, :id => "#{options[:id]}_numeric", :style => "display:#{ActiveScaffold::Finder::NumericComparators.include?(current_search['opt']) ? '' : 'none'}")
+          end
+  
+          def active_scaffold_search_date_bridge_trend_tag(column, options, current_search)
+            active_scaffold_date_bridge_trend_tag(column, options, 
+                                                 {:name_prefix => 'search',
+                                                  :number_value => current_search['number'],
+                                                  :unit_value => current_search["unit"],
+                                                  :show => (current_search['opt'] == 'PAST' || current_search['opt'] == 'FUTURE')})
+          end
+
+          def active_scaffold_date_bridge_trend_tag(column, options, trend_options)
+            trend_controls = text_field_tag("#{trend_options[:name_prefix]}[#{column.name}][number]", trend_options[:number_value], :class => 'text-input', :size => 10, :autocomplete => 'off') << " " <<
+            select_tag("#{trend_options[:name_prefix]}[#{column.name}][unit]",
+             options_for_select(active_scaffold_search_date_bridge_trend_units(column), trend_options[:unit_value]),
+             :class => 'text-input')
+            content_tag("span", trend_controls.html_safe, :id => "#{options[:id]}_trend", :style => "display:#{trend_options[:show] ? '' : 'none'}")
+          end
+
+          def active_scaffold_search_date_bridge_trend_units(column)
+             options = ActiveScaffold::Finder::DateUnits.collect{|unit| [as_(unit.downcase.to_sym), unit]}
+             options = ActiveScaffold::Finder::TimeUnits.collect{|unit| [as_(unit.downcase.to_sym), unit]} + options if column_datetime?(column)
+             options
+          end
+          
+          def active_scaffold_search_date_bridge_range_tag(column, options, current_search)
+            range_controls = select_tag("search[#{column.name}][range]", 
+              options_for_select( ActiveScaffold::Finder::DateRanges.collect{|range| [as_(range.downcase.to_sym), range]}, current_search["range"]), 
+             :class => 'text-input')
+            content_tag("span", range_controls.html_safe, :id => "#{options[:id]}_range", :style => "display:#{(current_search['opt'] == 'RANGE') ? '' : 'none'}")
+          end
+          
+          def column_datetime?(column)
+            (!column.column.nil? && [:datetime, :time].include?(column.column.type))
+          end
+        end
+
+        module HumanConditionHelpers
+          def active_scaffold_human_condition_date_bridge(column, value)
+            case value[:opt]
+            when 'RANGE'
+              range_type, range = value[:range].downcase.split('_')
+              format = active_scaffold_human_condition_date_bridge_range_format(range_type, range)
+              from, to = controller.class.date_bridge_from_to(column, value)
+              "#{column.active_record_class.human_attribute_name(column.name)} = #{as_(value[:range].downcase).downcase} (#{I18n.l(from, :format => format)})"
+            when 'PAST', 'FUTURE'
+              from, to = controller.class.date_bridge_from_to(column, value)
+              "#{column.active_record_class.human_attribute_name(column.name)} #{as_('BETWEEN'.downcase).downcase} #{I18n.l(from)} - #{I18n.l(to)}"
+            else
+              from, to = controller.class.date_bridge_from_to(column, value)
+              "#{column.active_record_class.human_attribute_name(column.name)} #{as_(value[:opt].downcase).downcase} #{I18n.l(from)} #{value[:opt] == 'BETWEEN' ? '- ' + I18n.l(to) : ''}"
+            end
+          end
+
+          def active_scaffold_human_condition_date_bridge_range_format(range_type, range)
+            case range
+            when 'week'
+              first_day_of_week = I18n.translate 'active_scaffold.date_picker_options.firstDay'
+              if first_day_of_week == 1
+                '%W %Y'
+              else
+                '%U %Y'
+              end
+            when 'month'
+              '%b %Y'
+            when 'year'
+              '%Y'
+            else
+              I18n.translate 'date.formats.default'
+            end
+          end
+        end
+        
+        module Finder
+          module ClassMethods
+            def condition_for_date_bridge_type(column, value, like_pattern)
+              operator = ActiveScaffold::Finder::NumericComparators.include?(value[:opt]) && value[:opt] != 'BETWEEN' ? value[:opt] : nil
+              from_value, to_value = date_bridge_from_to(column, value)
+              
+              if column.search_sql.is_a? Proc
+                column.search_sql.call(from_value, to_value, operator)
+              else
+                unless operator.nil?
+                  ["#{column.search_sql} #{value[:opt]} ?", from_value.to_s(:db)] unless from_value.nil?
+                else
+                  ["#{column.search_sql} BETWEEN ? AND ?", from_value.to_s(:db), to_value.to_s(:db)] unless from_value.nil? && to_value.nil?  
+                end
+              end
+            end
+            
+            def date_bridge_from_to(column, value)
+              conversion = column.column.type == :date ? :to_date : :to_time
+              case value[:opt]
+              when 'RANGE'
+                date_bridge_from_to_for_range(column, value).collect(&conversion)
+              when 'PAST', 'FUTURE'
+                date_bridge_from_to_for_trend(column, value).collect(&conversion)
+              else
+                ['from', 'to'].collect { |field| condition_value_for_datetime(value[field], conversion)}
+              end
+            end
+
+            def date_bridge_now
+              Time.zone.now
+            end
+            
+            def date_bridge_from_to_for_trend(column, value)
+              case value['opt']
+              when "PAST"
+                trend_number = [value['number'].to_i,  1].max
+                now = date_bridge_now
+                if date_bridge_column_date?(column)
+                  from = now.beginning_of_day.ago((trend_number).send(value['unit'].downcase.singularize.to_sym))
+                  to = now.end_of_day
+                else
+                  from = now.ago((trend_number).send(value['unit'].downcase.singularize.to_sym))
+                  to = now
+                end
+                return from, to
+              when "FUTURE"
+                trend_number = [value['number'].to_i,  1].max
+                now = date_bridge_now
+                if date_bridge_column_date?(column)
+                  from = now.beginning_of_day
+                  to = now.end_of_day.in((trend_number).send(value['unit'].downcase.singularize.to_sym))
+                else
+                  from = now
+                  to = now.in((trend_number).send(value['unit'].downcase.singularize.to_sym))
+                end
+                return from, to
+              end
+            end
+            
+            def date_bridge_from_to_for_range(column, value)
+              case value[:range]
+              when 'TODAY'
+                return date_bridge_now.beginning_of_day, date_bridge_now.end_of_day
+              when 'YESTERDAY'
+                return date_bridge_now.ago(1.day).beginning_of_day, date_bridge_now.ago(1.day).end_of_day
+              when 'TOMORROW'
+                return date_bridge_now.in(1.day).beginning_of_day, date_bridge_now.in(1.day).end_of_day
+              else
+                range_type, range = value[:range].downcase.split('_')
+                raise ArgumentError unless ['week', 'month', 'year'].include?(range)
+                case range_type
+                when 'this'
+                  return date_bridge_now.send("beginning_of_#{range}".to_sym), date_bridge_now.send("end_of_#{range}")
+                when 'prev'
+                  return date_bridge_now.ago(1.send(range.to_sym)).send("beginning_of_#{range}".to_sym), date_bridge_now.ago(1.send(range.to_sym)).send("end_of_#{range}".to_sym)
+                when 'next'
+                  return date_bridge_now.in(1.send(range.to_sym)).send("beginning_of_#{range}".to_sym), date_bridge_now.in(1.send(range.to_sym)).send("end_of_#{range}".to_sym)
+                else
+                  return nil, nil    
+                end
+              end
+            end
+
+            def date_bridge_column_date?(column)
+              if [:date_picker, :datetime_picker].include? column.form_ui
+                column.form_ui == :date_picker
+              else
+                (!column.column.nil? && [:date].include?(column.column.type))
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end
+
+ActiveScaffold::Finder.const_set('DateComparators', ["PAST", "FUTURE", "RANGE"])
+ActiveScaffold::Finder.const_set('DateUnits', ["DAYS", "WEEKS", "MONTHS", "YEARS"])
+ActiveScaffold::Finder.const_set('TimeUnits', ["SECONDS", "MINUTES", "HOURS"])
+ActiveScaffold::Finder.const_set('DateRanges', ["TODAY", "YESTERDAY", "TOMORROW",
+                                                "THIS_WEEK", "PREV_WEEK", "NEXT_WEEK",
+                                                "THIS_MONTH", "PREV_MONTH", "NEXT_MONTH",
+                                                "THIS_YEAR", "PREV_YEAR", "NEXT_YEAR"])

data/lib/active_scaffold/config/create.rb

@@ -4,7 +4,7 @@ module ActiveScaffold::Config
     def initialize(*args)
       super
       self.persistent = self.class.persistent
-      self.edit_after_create = self.class.edit_after_create
+      self.action_after_create = self.class.action_after_create
       self.refresh_list = self.class.refresh_list
     end
 
@@ -24,8 +24,8 @@ module ActiveScaffold::Config
     @@persistent = false
 
     # whether update form is opened after a create or not
-    cattr_accessor :edit_after_create
-    @@edit_after_create = false
+    cattr_accessor :action_after_create
+    @@action_after_create = false
 
     # whether we should refresh list after create or not
     cattr_accessor :refresh_list
@@ -43,7 +43,7 @@ module ActiveScaffold::Config
     attr_accessor :persistent
 
     # whether the form stays open after a create or not
-    attr_accessor :edit_after_create
+    attr_accessor :action_after_create
 
     # whether we should refresh list after create or not
     attr_accessor :refresh_list

data/lib/active_scaffold/config/nested.rb

@@ -23,6 +23,7 @@ module ActiveScaffold::Config
       unless column.nil? || column.association.nil?
         options.reverse_merge! :security_method => :nested_authorized?, :label => column.association.klass.model_name.human({:count => 2, :default => column.association.klass.name.pluralize}) 
         action_link = @core.link_for_association(column, options)
+        action_link.action ||= :index
         @core.action_links.add_to_group(action_link, action_group) unless action_link.nil?
       else
         

data/lib/active_scaffold/config/nested.rb~

@@ -0,0 +1,41 @@
+module ActiveScaffold::Config
+  class Nested < Base
+    self.crud_type = :read
+
+    def initialize(core_config)
+      super
+      @label = :add_existing_model
+      self.shallow_delete = self.class.shallow_delete
+      @action_group = self.class.action_group.clone if self.class.action_group
+    end
+
+    # global level configuration
+    # --------------------------
+    cattr_accessor :shallow_delete
+    @@shallow_delete = true
+
+    # instance-level configuration
+    # ----------------------------
+    attr_accessor :shallow_delete
+
+    # Add a nested ActionLink
+    def add_link(attribute, options = {})
+      column = @core.columns[attribute.to_sym]
+      unless column.nil? || column.association.nil?
+        options.reverse_merge! :security_method => :nested_authorized?, :label => column.association.klass.model_name.human({:count => 2, :default => column.association.klass.name.pluralize}) 
+        action_link = @core.link_for_association(column, options)
+        @core.action_links.add_to_group(action_link, action_group) unless action_link.nil?
+      else
+        
+      end
+    end
+    
+    def add_scoped_link(named_scope, options = {})
+      action_link = @core.link_for_association_as_scope(named_scope.to_sym, options)
+      @core.action_links.add_to_group(action_link, action_group) unless action_link.nil?
+    end
+
+    # the label for this Nested action. used for the header.
+    attr_writer :label
+  end
+end

data/lib/active_scaffold/config/search.rb~

@@ -0,0 +1,74 @@
+module ActiveScaffold::Config
+  class Search < Base
+    self.crud_type = :read
+
+    def initialize(core_config)
+      super
+      @text_search = self.class.text_search
+      @live = self.class.live?
+      @split_terms = self.class.split_terms
+
+      # start with the ActionLink defined globally
+      @link = self.class.link.clone
+      @action_group = self.class.action_group.clone if self.class.action_group
+    end
+
+
+    # global level configuration
+    # --------------------------
+    # the ActionLink for this action
+    cattr_accessor :link
+    @@link = ActiveScaffold::DataStructures::ActionLink.new('show_search', :label => :search, :type => :collection, :security_method => :search_authorized?, :ignore_method => :search_ignore?)
+
+    # A flag for how the search should do full-text searching in the database:
+    # * :full: LIKE %?%
+    # * :start: LIKE ?%
+    # * :end: LIKE %?
+    # * false: LIKE ?
+    # Default is :full
+    cattr_accessor :text_search
+    @@text_search = :full
+
+    # whether submits the search as you type
+    cattr_writer :live
+    def self.live?
+      @@live
+    end
+
+    # instance-level configuration
+    # ----------------------------
+
+    # provides access to the list of columns specifically meant for the Search to use
+    def columns
+      # we want to delay initializing to the @core.columns set for as long as possible. Too soon and .search_sql will not be available to .searchable?
+      unless @columns
+        debugger
+        self.columns = @core.columns.collect{|c| c.name if @core.columns._inheritable.include?(c.name) and c.searchable? and c.column and c.column.text?}.compact
+      end
+      @columns
+    end
+
+    public :columns=
+
+    # A flag for how the search should do full-text searching in the database:
+    # * :full: LIKE %?%
+    # * :start: LIKE ?%
+    # * :end: LIKE %?
+    # * false: LIKE ?
+    # Default is :full
+    attr_accessor :text_search
+
+    @@split_terms = " "
+    cattr_accessor :split_terms
+    attr_accessor :split_terms
+
+    # the ActionLink for this action
+    attr_accessor :link
+
+    # whether submits the search as you type
+    attr_writer :live
+    def live?
+      @live
+    end
+  end
+end