tabulatr 0.0.1

data/lib/tabulatr/tabulatr/finder.rb

@@ -0,0 +1,82 @@
+#--
+# Copyright (c) 2010-2011 Peter Horn, Provideal GmbH
+#
+# 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.
+#++
+
+# These are extensions for use from ActionController instances
+module Tabulatr::Finder
+
+  require File.join(File.dirname(__FILE__), 'finder', 'find_for_active_record_table')
+  require File.join(File.dirname(__FILE__), 'finder', 'find_for_mongoid_table')
+
+  # compress the list of ids as good as I could imagine ;)
+  # uses fancy base twisting
+  def self.compress_id_list(list)
+    IdStuffer.stuff(list)
+  end
+
+  # inverse of compress_id_list
+  def self.uncompress_id_list(str)
+    IdStuffer.unstuff(str).map &:to_s
+  end
+
+  class Invoker
+    def initialize(batch_action, ids)
+      @batch_action = batch_action.to_sym
+      @ids = ids
+    end
+
+    def method_missing(name, *args, &block)
+      if @batch_action == name
+        yield(@ids, args)
+      end
+    end
+  end
+
+private
+
+  def self.class_to_param(klaz)
+    klaz.to_s.downcase.gsub("/","_")
+  end
+
+  def self.condition_from(n,v,c)
+    raise "SECURITY violation, field name is '#{n}'" unless /^[\d\w]+(\.[\d\w]+)?$/.match n
+    @like ||= Tabulatr.sql_options[:like]
+    nc = c
+    if v.is_a?(String)
+      if v.present?
+        nc = [c[0] << " AND (#{n} = ?) ", c[1] << v]
+      end
+    elsif v.is_a?(Hash)
+      if v[:like]
+        if v[:like].present?
+          nc = [c[0] << " AND (#{n} #{@like} ?) ", c[1] << "%#{v[:like]}%"]
+        end
+      else
+        nc = [c[0] << " AND (#{n} >= ?) ", c[1] << "#{v[:from]}"] if v[:from].present?
+        nc = [nc[0] << " AND (#{n} <= ?) ", nc[1] << "#{v[:to]}"] if v[:to].present?
+      end
+    else
+      raise "Wrong filter type: #{v.class}"
+    end
+    nc
+  end
+end

data/lib/tabulatr/tabulatr/formattr.rb

@@ -0,0 +1,51 @@
+#--
+# Copyright (c) 2010-2011 Peter Horn, Provideal GmbH
+#
+# 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.
+#++
+
+module Tabulatr::Formattr
+  ALLOWED_METHODS = [:euro, :dollar, :percent, :lamp]
+  
+  def self.format(nam, val)
+    nam = nam.to_sym
+    if ALLOWED_METHODS.member?(nam)
+      self.send nam, val
+    else
+      "[Requested unautorized format '#{nam}' for '#{val}'.]" 
+    end
+  end
+  
+  def self.euro(x)
+    ("%.2f €" % x).gsub(".", ",")
+  end
+  
+  def self.dollar(x)
+    "$ %.2f" % x
+  end
+  
+  def self.percent(x)
+    ("%.2f&thinspace;%%" % 100.0*x).gsub(".", ",")
+  end
+  
+  def self.lamp(x)
+    
+  end
+end

data/lib/tabulatr/tabulatr/header_cell.rb

@@ -0,0 +1,94 @@
+#--
+# Copyright (c) 2010-2011 Peter Horn, Provideal GmbH
+#
+# 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.
+#++
+
+class Tabulatr
+
+
+  # the method used to actually define the headers of the columns,
+  # taking the name of the attribute and a hash of options.
+  #
+  # The following options are evaluated here:
+  # <tt>:th_html</tt>:: a hash with html-attributes added to the <th>s created
+  # <tt>:header</tt>:: if present, the value will be output in the header cell,
+  #                    otherwise, the capitalized name is used
+  def header_column(name, opts={}, &block)
+    raise "Not in header mode!" if @row_mode != :header
+    sortparam = "#{@classname}#{@table_form_options[:sort_postfix]}"
+    bid = "#{@classname}#{@table_form_options[:sort_postfix]}"
+    opts = normalize_column_options opts
+    make_tag(:th, opts[:th_html]) do
+      concat(t(opts[:header] || name.to_s.capitalize), :escape_html)
+      if opts[:sortable] and @table_options[:sortable]
+        if @sorting and @sorting[:by].to_s == name.to_s
+          pname = "#{sortparam}[_resort][#{name}][#{@sorting[:direction] == 'asc' ? 'desc' : 'asc'}]"
+          bid = "#{bid}_#{name}_#{@sorting[:direction] == 'asc' ? 'desc' : 'asc'}"
+          psrc = File.join(@table_options[:image_path_prefix], @table_options[@sorting[:direction] == 'desc' ?
+            :sort_down_button : :sort_up_button])
+          make_tag(:input, :type => :hidden,
+            :name => "#{sortparam}[#{name}][#{@sorting[:direction]}]",
+            :value => "#{@sorting[:direction]}")
+        else
+          pname = "#{sortparam}[_resort][#{name}][desc]"
+          bid = "#{bid}_#{name}_desc"
+          psrc = File.join(@table_options[:image_path_prefix], @table_options[:sort_down_button_inactive])
+        end
+        make_tag(:input, :type => 'image',
+          :id => bid,
+          :src => psrc,
+          :name => pname)
+      end
+    end # </th>
+  end
+
+  # the method used to actually define the headers of the columns,
+  # taking the name of the attribute and a hash of options.
+  #
+  # The following options are evaluated here:
+  # <tt>:th_html</tt>:: a hash with html-attributes added to the <th>s created
+  # <tt>:header</tt>:: if present, the value will be output in the header cell,
+  #                    otherwise, the capitalized name is used
+  def header_association(relation, name, opts={}, &block)
+    raise "Not in header mode!" if @row_mode != :header
+    opts = normalize_column_options opts
+    if opts[:sortable] and @table_options[:sortable]
+      # change classes accordingly
+    end
+    make_tag(:th, opts[:th_html]) do
+      concat(t(opts[:header] || "#{relation.to_s.capitalize} #{name.to_s.capitalize}"), :escape_html)
+    end # </th>
+  end
+
+  def header_checkbox(opts={}, &block)
+    raise "Whatever that's for!" if block_given?
+    make_tag(:th, opts[:th_html]) do
+      concat(t(opts[:header] || ""), :escape_html)
+    end
+  end
+
+  def header_action(opts={}, &block)
+    make_tag(:th, opts[:th_html]) do
+      concat(t(opts[:header] || ""), :escape_html)
+    end
+  end
+
+end

data/lib/tabulatr/tabulatr/paginator.rb

@@ -0,0 +1,88 @@
+#--
+# Copyright (c) 2010-2011 Peter Horn, Provideal GmbH
+#
+# 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.
+#++
+
+class Tabulatr
+
+  #render the paginator controls, inputs etc.
+  def render_paginator
+    # get the current pagination state
+    pagination_name = "#{@classname}#{TABLE_FORM_OPTIONS[:pagination_postfix]}"
+    pparams = @records.send(FINDER_INJECT_OPTIONS[:pagination])
+    page = pparams[:page].to_i
+    pages = pparams[:pages].to_i
+    pagesize = pparams[:pagesize].to_i
+    pagesizes = pparams[:pagesizes].map &:to_i
+    # render the 'wrapping' div
+    make_tag(:div, :class => @table_options[:paginator_div_class]) do
+      # << Page Left
+      if page > 1
+        make_tag(:input, :type => 'image', 
+          :src => File.join(@table_options[:image_path_prefix], @table_options[:pager_left_button]),
+          :class => @table_options[:page_left_class],
+          :id => "#{pagination_name}_page_left",
+          :name => "#{pagination_name}[page_left]")
+      else
+        make_tag(:img, 
+          :src => File.join(@table_options[:image_path_prefix], @table_options[:pager_left_button_inactive]),
+          :class => @table_options[:page_left_class])
+      end  # page > 1
+      # current page number
+      concat(make_tag(:input,
+        :type => :hidden,
+        :name => "#{pagination_name}[current_page]",
+        :value => page))
+      concat(make_tag(:input,
+        :type => :text,
+        :size => pages.to_s.length,
+        :name => "#{pagination_name}[page]",
+        :value => page))
+      concat("/#{pages}")
+      # >> Page Right
+      if page < pages
+        make_tag(:input, :type => 'image', 
+          :src => File.join(@table_options[:image_path_prefix], @table_options[:pager_right_button]),
+          :class => @table_options[:page_right_class],
+          :id => "#{pagination_name}_page_right",
+          :name => "#{pagination_name}[page_right]")
+      else
+        make_tag(:img, :src => File.join(@table_options[:image_path_prefix], @table_options[:pager_right_button_inactive]),
+          :class => @table_options[:page_right_class])
+      end  # page < pages
+      if pagesizes.length > 1
+        make_tag(:select, :name => "#{pagination_name}[pagesize]", :class => @table_options[:pagesize_select_class]) do
+          pagesizes.each do |n|
+            make_tag(:option, (n.to_i==pagesize ? {:selected  => :selected} : {}).merge(:value => n)) do
+              concat(n.to_s)
+            end # </option>
+          end # each
+        end # </select>
+      else # just one pagesize
+        concat(make_tag(:input,
+          :type => :hidden,
+          :name => "#{pagination_name}[pagesize]",
+          :value => pagesizes.first))
+      end
+    end # </div>
+  end
+
+end

data/lib/tabulatr/tabulatr/row_builder.rb

@@ -0,0 +1,115 @@
+#--
+# Copyright (c) 2010-2011 Peter Horn, Provideal GmbH
+#
+# 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.
+#++
+
+# These are extensions for use as a row builder
+# In a seperate class call only for clearity
+
+class Tabulatr
+
+  # called inside the build_table block, branches into data, header,
+  # or filter building methods depending on the current mode
+  def column(name, opts={}, &block)
+    #puts "column: '#{name}'"
+    case @row_mode
+    when :data   then data_column(name, opts, &block)
+    when :header then header_column(name, opts, &block)
+    when :filter then filter_column(name, opts, &block)
+    else raise "Wrong row mode '#{@row_mode}'"
+    end # case
+  end
+
+  # called inside the build_table block, branches into data, header,
+  # or filter building methods depending on the current mode
+  def association(relation, name, opts={}, &block)
+    #puts "assoc: '#{relation}.#{name}'"
+    case @row_mode
+    when :data   then data_association(relation, name, opts, &block)
+    when :header then header_association(relation, name, opts, &block)
+    when :filter then filter_association(relation, name, opts, &block)
+    else raise "Wrong row mode '#{@row_mode}'"
+    end # case
+  end
+
+  # called inside the build_table block, branches into data, header,
+  # or filter building methods depending on the current mode
+  def checkbox(opts={}, &block)
+    #puts "column: '#{name}'"
+    case @row_mode
+    when :data   then data_checkbox(opts, &block)
+    when :header then header_checkbox(opts, &block)
+    when :filter then filter_checkbox(opts, &block)
+    else raise "Wrong row mode '#{@row_mode}'"
+    end # case
+  end
+
+  def action(opts={}, &block)
+    #puts "column: '#{name}'"
+    case @row_mode
+    when :data   then data_action(opts, &block)
+    when :header then header_action(opts, &block)
+    when :filter then filter_action(opts, &block)
+    else raise "Wrong row mode '#{@row_mode}'"
+    end # case
+  end
+
+private
+  # returns self, sets record and row_mode as required for a
+  # data row
+  def data_row_builder(record)
+    @record = record
+    @row_mode = :data
+    self
+  end
+
+  # returns self, sets record to nil and row_mode as required for a
+  # header row
+  def header_row_builder
+    @record = nil
+    @row_mode = :header
+    self
+  end
+
+  # returns self, sets record to nil and row_mode as required for a
+  # filter row
+  def filter_row_builder
+    @record = nil
+    @row_mode = :filter
+    self
+  end
+
+  # some preprocessing of the options
+  def normalize_column_options(opts)
+    opts = Tabulatr::COLUMN_OPTIONS.merge(opts)
+    {:width => 'width', :align => 'text-align', :valign => 'vertical-align'}.each do |key,css|
+      if opts[key]
+        [:th_html, :filter_html, :td_html].each do |set|
+          opts[set] ||= {}
+          opts[set][:style] = (opts[set][:style] ? opts[set][:style] << "; " : "") << "#{css}: #{opts[key]}"
+        end # each
+      end # if
+    end # each
+    # more to come!
+    opts
+  end
+end
+

data/lib/tabulatr/tabulatr/settings.rb

@@ -0,0 +1,221 @@
+#--
+# Copyright (c) 2010-2011 Peter Horn, Provideal GmbH
+#
+# 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.
+#++
+
+require 'whiny_hash'
+
+class Tabulatr
+
+  # Hash keeping the defaults for the table options, may be overriden in the
+  # table_for call
+  TABLE_OPTIONS = WhinyHash.new({ # WhinyHash.new({
+    remote: false,                               # add data-remote="true" to form
+
+    form_class: 'tabulatr_form',                 # class of the overall form
+    table_class: 'tabulatr_table',               # class for the actual data table
+    sortable_class: 'sortable',                  # class for the header of a sortable column
+    sorting_asc_class: 'sorting-asc',            # class for the currently asc sorting column
+    sorting_desc_class: 'sorting-desc',          # class for the currently desc sorting column
+    page_left_class: 'page-left',                # class for the page left button
+    page_right_class: 'page-right',              # class for the page right button
+    page_no_class: 'page-no',                    # class for the page no <input>
+    control_div_class_before: 'table-controls',  # class of the upper div containing the paging and batch action controls
+    control_div_class_after: 'table-controls',   # class of the lower div containing the paging and batch action controls
+    paginator_div_class: 'paginator',            # class of the div containing the paging controls
+    batch_actions_div_class: 'batch-actions',    # class of the div containing the batch action controls
+    select_controls_div_class: 'check-controls',  # class of the div containing the check controls
+    submit_class: 'submit-table',                # class of submit button
+    pagesize_select_class: 'pagesize_select',    # class of the pagesize select element
+    select_all_class: 'select-btn',              # class of the select all button
+    select_none_class: 'select-btn',             # class of the select none button
+    select_visible_class: 'select-btn',          # class of the select visible button
+    unselect_visible_class: 'select-btn',        # class of the unselect visible button
+    select_filtered_class: 'select-btn',         # class of the select filtered button
+    unselect_filtered_class: 'select-btn',       # class of the unselect filteredbutton
+    info_text_class: 'info-text',                # class of the info text div
+
+    batch_actions_label: 'Batch Action: ',       # Text to show in front of the batch action select
+    batch_actions_type: :select,                 # :select or :button depending on the kind of input you want
+    batch_actions_class: 'batch-action-inputs',  # class to apply on the batch action input elements
+    submit_label: 'Apply',                       # Text on the submit button
+    select_all_label: 'Select All',              # Text on the select all button
+    select_none_label: 'Select None',            # Text on the select none button
+    select_visible_label: 'Select visible',      # Text on the select visible button
+    unselect_visible_label: 'Unselect visible',  # Text on the unselect visible button
+    select_filtered_label: 'Select filtered',    # Text on the select filtered button
+    unselect_filtered_label: 'Unselect filtered',# Text on the unselect filtered button
+    info_text: "Showing %1$d, total %2$d, selected %3$d, matching %4$d",
+
+    # which controls to be rendered above and below the tabel and in which order
+    before_table_controls: [:submit, :paginator, :batch_actions, :select_controls, :info_text],
+    after_table_controls: [],
+
+    # whih selecting controls to render in which order
+    select_controls: [:select_all, :select_none, :select_visible, :unselect_visible,
+                      :select_filtered, :unselect_filtered],
+
+
+    image_path_prefix: '/images/tabulatr/',
+    pager_left_button: 'left.gif',
+    pager_left_button_inactive: 'left_off.gif',
+    pager_right_button: 'right.gif',
+    pager_right_button_inactive: 'right_off.gif',
+    sort_up_button: 'up.gif',
+    sort_up_button_inactive: 'up_off.gif',
+    sort_down_button: 'down.gif',
+    sort_down_button_inactive: 'down_off.gif',
+
+    make_form: true,                            # whether or not to wrap the whole table (incl. controls) in a form
+    table_html: false,                          # a hash with html attributes for the table
+    row_html: false,                            # a hash with html attributes for the normal trs
+    header_html: false,                         # a hash with html attributes for the header trs
+    filter_html: false,                         # a hash with html attributes for the filter trs
+    filter: true,                               # false for no filter row at all
+    paginate: true,                             # true to show paginator
+    sortable: true,                             # true to allow sorting (can be specified for every sortable column)
+    selectable: true,                           # true to render "select all", "select none" and the like
+    action: nil,                                # target action of the wrapping form if applicable
+    batch_actions: false,                       # name: value hash of batch action stuff
+    translate: false,                           # call t() for all 'labels' and stuff, possible values are true/:translate or :localize
+    row_classes: ['odd', 'even']                # class for the trs
+  })
+
+  # these settings are considered constant for the whole application, can not be overridden
+  # on a per-table basis.
+  # That's necessary to allow find_for_table to work properly
+  TABLE_FORM_OPTIONS = WhinyHash.new({
+    batch_action_name: 'batch_action',       # name of the batch action param
+    sort_by_key: 'sort_by_key',              # name of key which to search, format is 'id asc'
+    pagination_postfix: '_pagination',       # name of the param w/ the pagination infos
+    filter_postfix: '_filter',               # postfix for name of the filter in the params hash: xxx_filter
+    sort_postfix: '_sort',                   # postfix for name of the filter in the params hash: xxx_filter
+    checked_postfix: '_checked',             # postfix for name of the checked in the params hash: xxx_filter
+    associations_filter: '__association',    # name of the associations in the filter hash
+    method: 'post',                          # http method for that form if applicable
+    batch_postfix: '_batch',                 # postfix for name of the batch action select
+    checked_separator: ','                   # symbol to separate the checked ids
+  })
+
+  # these settings are considered constant for the whole application, can not be overridden
+  # on a per-table basis.
+  # That's necessary to allow find_for_table to work properly
+  PAGINATE_OPTIONS = ActiveSupport::HashWithIndifferentAccess.new({
+    page: 1,
+    pagesize: 10,
+    pagesizes: [10, 20, 50]
+  })
+
+  # Hash keeping the defaults for the column options
+  COLUMN_OPTIONS = ActiveSupport::HashWithIndifferentAccess.new({
+    header: false,                   # a string to write into the header cell
+    width: false,                    # the width of the cell
+    align: false,                    # horizontal alignment
+    valign: false,                   # vertical alignment
+    wrap: true,                      # wraps
+    type: :string,                   # :integer, :date
+    td_html: false,                  # a hash with html attributes for the cells
+    th_html: false,                  # a hash with html attributes for the header cell
+    filter_html: false,              # a hash with html attributes for the filter cell
+    filter: true,                    # false for no filter field,
+                                     # container for options_for_select
+                                     # String from options_from_collection_for_select or the like
+                                     # :range for range spec
+                                     # :checkbox for a 0/1 valued checkbox
+    checkbox_value: '1',             # value if checkbox is checked
+    checkbox_label: '',              # text behind the checkbox
+    filter_width: '97%',             # width of the filter <input>
+    range_filter_symbol: '&ndash;',  # put between the <inputs> of the range filter
+    format: false,                   # a sprintf-string or a proc to do special formatting
+    method: false,                   # if you want to get the column by a different method than its name
+    link: false,                     # proc or symbol to make the content a link
+    join_symbol: ', ',               # symbol used to join the elements of 'many' associations
+    sortable: true                   # if set, sorting-stuff is added to the header cell
+  })
+
+  # these settings are considered constant for the whole application, can not be overridden
+  # on a per-table basis.
+  # That's necessary to allow find_for_table to work properly
+  FINDER_INJECT_OPTIONS = WhinyHash.new({
+    pagination: :__pagination,
+    filters: :__filters,
+    classname: :__classname,
+    sorting: :__sorting,
+    checked: :__checked,
+    store_data: :__store_data
+  })
+
+  # defaults for the find_for_table
+  FINDER_OPTIONS = WhinyHash.new({
+    default_order: false,
+    default_pagesize: false,
+    precondition: false,
+    store_data: false
+  })
+
+  # Stupid hack
+  SQL_OPTIONS = WhinyHash.new({
+    like: 'LIKE'
+  })
+
+  def self.finder_inject_options(n=nil)
+    FINDER_INJECT_OPTIONS.merge!(n) if n
+    FINDER_INJECT_OPTIONS
+  end
+
+  def self.finder_options(n=nil)
+    FINDER_OPTIONS.merge!(n) if n
+    FINDER_OPTIONS
+  end
+
+  def self.column_options(n=nil)
+    COLUMN_OPTIONS.merge!(n) if n
+    COLUMN_OPTIONS
+  end
+
+  def self.table_options(n=nil)
+    TABLE_OPTIONS.merge!(n) if n
+    TABLE_OPTIONS
+  end
+
+  def self.paginate_options(n=nil)
+    PAGINATE_OPTIONS.merge!(n) if n
+    PAGINATE_OPTIONS
+  end
+
+  def self.table_form_options(n=nil)
+    TABLE_FORM_OPTIONS.merge!(n) if n
+    TABLE_FORM_OPTIONS
+  end
+
+  def self.table_design_options(n=nil)
+    raise("table_design_options stopped existing. Use table_options instead.")
+  end
+  def table_design_options(n=nil) self.class.table_design_options(n) end
+
+  def self.sql_options(n=nil)
+    SQL_OPTIONS.merge!(n) if n
+    SQL_OPTIONS
+  end
+  def sql_options(n=nil) self.class.sql_options(n) end
+
+
+end