netzke-basepack 0.2.0.1 → 0.2.2

data/lib/netzke/column.rb

@@ -1,6 +1,7 @@
 module Netzke
+  # TODO: rename this class, or better even, make a module out of it
   class Column
-    def self.default_columns_for_widget(widget)
+    def self.default_dbfields_for_widget(widget, mode = :grid)
       raise ArgumentError, "No data_class_name specified for widget #{widget.config[:name]}" if widget.config[:data_class_name].nil?
 
       # layout = NetzkeLayout.create(:widget_name => widget.id_name, :items_class => self.name, :user_id => NetzkeLayout.user_id)
@@ -26,11 +27,19 @@ module Netzke
       res = []
       for c in columns_for_create
         # finally reverse-merge them with the defaults from the data_class
-        res << data_class.default_column_config(c)
+        res << (mode == :grid ? data_class.default_column_config(c) : data_class.default_field_config(c))
       end
       
       res
     end
+
+    def self.default_columns_for_widget(widget)
+      default_dbfields_for_widget(widget, :grid)
+    end
+    
+    def self.default_fields_for_widget(widget)
+      default_dbfields_for_widget(widget, :form)
+    end
     
     protected
 

data/lib/netzke/form_panel.rb

@@ -0,0 +1,185 @@
+module Netzke
+  class FormPanel < Base
+    interface :submit, :load
+    
+    class << self
+      def js_base_class
+        "Ext.FormPanel"
+      end
+
+      def js_before_constructor
+        <<-JS
+        var fields = config.fields; // TODO: remove hidden fields
+        var recordFields = [];
+        var index = 0;
+        Ext.each(config.fields, function(field){recordFields.push({name:field.name, mapping:index++})});
+        var Record = Ext.data.Record.create(recordFields);
+        this.reader = new Ext.data.RecordArrayReader({}, Record);
+        
+        JS
+      end
+      
+      def js_default_config
+        super.merge({
+          :auto_scroll => true,
+          :bbar => "config.actions".l,
+          # :plugins => "plugins".l,
+          :items => "fields".l,
+          :default_type => 'textfield',
+          :body_style => 'padding:5px 5px 0',
+          :label_width => 150,
+          :listeners => {:afterlayout => {:fn => "this.afterlayoutHandler".l, :scope => this}},
+
+          #custom configs
+          :auto_load_data => true,
+        })
+      end
+      
+      
+    end
+    
+    def self.js_extend_properties
+      {
+        :load_record => <<-JS.l,
+          function(id, neighbour){
+            var proxy = new Ext.data.HttpProxy({url:this.initialConfig.interface.load});
+            proxy.load({id:id, neighbour:neighbour}, this.reader, function(data){
+              if (data){
+                this.form.loadRecord(data.records[0])
+              }
+            }, this)
+          }
+        JS
+        :afterlayout_handler => <<-JS.l,
+          function() {
+            // Load initial data into the form
+            if (this.initialConfig.recordData){
+              var record = this.reader.readRecord(this.initialConfig.recordData);
+              this.form.loadRecord(record);
+            }
+          }
+        JS
+        :refresh_click => <<-JS.l,
+          function() {
+            this.loadRecord(3)
+          }
+        JS
+        :previous => <<-JS.l,
+          function() {
+            var currentId = this.form.getValues().id;
+            this.loadRecord(currentId, 'previous');
+          }
+        JS
+        :next => <<-JS.l,
+          function() {
+            var currentId = this.form.getValues().id;
+            this.loadRecord(currentId, 'next');
+          }
+        JS
+        :submit => <<-JS.l,
+          function() {
+            this.form.submit({
+              url:this.initialConfig.interface.submit
+            })
+          }
+        JS
+      }
+    end
+
+    # default configuration
+    def initial_config
+      {
+        :ext_config => {
+          :config_tool => false, 
+          :border => true
+        },
+        :layout_manager => "NetzkeLayout",
+        :field_manager => "NetzkeFormPanelField"
+      }
+    end
+
+    def tools
+      [{:id => 'refresh', :on => {:click => 'refreshClick'}}]
+    end
+    
+    def actions
+      [{
+        :text => 'Previous', :handler => 'previous'
+      },{
+        :text => 'Next', :handler => 'next'
+      },{
+        :text => 'Apply', :handler => 'submit', :disabled => !@permissions[:update] && !@permissions[:create]
+      }]
+    end
+    
+    def js_config
+      res = super
+      # we pass column config at the time of instantiating the JS class
+      res.merge!(:fields => get_fields || config[:fields]) # first try to get columns from DB, then from config
+      res.merge!(:data_class_name => config[:data_class_name])
+      res.merge!(:record_data => config[:record].to_array(get_fields))
+      res
+    end
+    
+    # get fields from layout manager
+    def get_fields
+      @fields ||=
+      if layout_manager_class && field_manager_class
+        layout = layout_manager_class.by_widget(id_name)
+        layout ||= field_manager_class.create_layout_for_widget(self)
+        layout.items_hash  # TODO: bad name!
+      else
+        Netzke::Column.default_columns_for_widget(self)
+      end
+    end
+    
+    def submit(params)
+      params.delete(:authenticity_token)
+      params.delete(:controller)
+      params.delete(:action)
+      book = Book.find(params[:id])
+      if book.nil?
+        book = Book.create(params)
+      else
+        book.update_attributes(params)
+      end
+    rescue ActiveRecord::UnknownAttributeError # unknown attributes get ignored
+      book.save
+      [book.to_array(get_fields)].to_json
+    end
+    
+    def load(params)
+      logger.debug { "!!! params: #{params.inspect}" }
+      klass = config[:data_class_name].constantize
+      case params[:neighbour]
+      when "previous"
+        book = klass.previous(params[:id])
+      when "next"
+        book = klass.next(params[:id])
+      else
+        book = klass.find(params[:id])
+      end
+      [book && book.to_array(get_fields)].to_json
+    end
+    
+    protected
+    
+    def layout_manager_class
+      config[:layout_manager].constantize
+    rescue NameError
+      nil
+    end
+    
+    def field_manager_class
+      config[:field_manager].constantize
+    rescue NameError
+      nil
+    end
+    
+    def available_permissions
+      %w(read update create delete)
+    end
+    
+      
+  end
+end

data/lib/netzke/grid_panel.rb

@@ -18,6 +18,31 @@ module Netzke
     # define connection points between client side and server side of GridPanel. See implementation of equally named methods in the GridPanelInterface module.
     interface :get_data, :post_data, :delete_data, :resize_column, :move_column, :get_cb_choices
 
+    module ClassMethods
+
+      # Global GridPanel configuration
+      def config
+        set_default_config({
+            :column_manager => "NetzkeGridPanelColumn"
+        })
+      end
+
+      def column_manager_class
+        config[:column_manager].constantize
+      rescue
+        nil
+      end
+    end
+    extend ClassMethods
+
+    def layout_manager_class
+      self.class.layout_manager_class
+    end
+
+    def column_manager_class
+      self.class.column_manager_class
+    end
+
     # default grid configuration
     def initial_config
       {
@@ -26,9 +51,11 @@ module Netzke
           :enable_column_filters => Netzke::Base.config[:grid_panel][:filters], 
           :enable_column_move => true, 
           :enable_column_resize => true,
-          :border => true
+          :border => true,
+          :load_mask => true
         },
-        :layout_manager => "NetzkeLayout"
+        :persistent_layout => true,
+        :persistent_config => true
       }
     end
 
@@ -36,7 +63,7 @@ module Netzke
       [{
         :name => 'columns',
         :widget_class_name => "GridPanel", 
-        :data_class_name => column_manager_class_name, 
+        :data_class_name => column_manager_class.name, 
         :ext_config => {:title => false, :config_tool => false},
         :active => true
       },{
@@ -63,25 +90,9 @@ module Netzke
       w = aggregatee_instance(:properties__general)
       w.interface_load_source(params)
     end
-    
-
 
     protected
     
-    def layout_manager_class
-      config[:layout_manager] && config[:layout_manager].constantize
-    end
-    
-    def column_manager_class_name
-      "NetzkeGridPanelColumn"
-    end
-    
-    def column_manager_class
-      column_manager_class_name.constantize
-    rescue NameError
-      nil
-    end
-    
     def available_permissions
       %w(read update create delete)
     end
@@ -91,7 +102,7 @@ module Netzke
     # get columns from layout manager
     def get_columns
       @columns ||=
-      if layout_manager_class && column_manager_class
+      if config[:persistent_layout] && layout_manager_class && column_manager_class
         layout = layout_manager_class.by_widget(id_name)
         layout ||= column_manager_class.create_layout_for_widget(self)
         layout.items_hash  # TODO: bad name!

data/lib/netzke/grid_panel_interface.rb

@@ -104,14 +104,18 @@ module Netzke::GridPanelInterface
     search_params = normalize_params(params)
     raise ArgumentError, "No data_class_name specified for widget '#{config[:name]}'" if !config[:data_class_name]
     records = config[:data_class_name].constantize.all(search_params.clone) # clone needed as searchlogic removes :conditions key from the hash
-    output_array = []
-    records.each do |r|
-      r_array = []
-      self.get_columns.each do |column|
-        r_array << r.send(column[:name])
-      end
-      output_array << r_array
-    end
+    # output_array = []
+    columns = get_columns
+    output_array = records.map{|r| r.to_array(columns)}
+    
+    # records.each do |r|
+    #   r_array = []
+    #   self.get_columns.each do |column|
+    #     r_array << r.send(column[:name])
+    #   end
+    #   output_array << r_array
+    #   output_array << r.to_array(columns)
+    # end
 
     # add total_entries accessor to the result
     class << output_array

data/netzke-basepack.gemspec

@@ -2,18 +2,18 @@
 
 Gem::Specification.new do |s|
   s.name = %q{netzke-basepack}
-  s.version = "0.2.0.1"
+  s.version = "0.2.2"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 1.2") if s.respond_to? :required_rubygems_version=
   s.authors = ["Sergei Kozlov"]
-  s.date = %q{2009-01-07}
+  s.date = %q{2009-01-23}
   s.description = %q{Base Netzke widgets - grid, form, tree, and more}
   s.email = %q{sergei@writelesscode.com}
-  s.extra_rdoc_files = ["CHANGELOG", "lib/app/models/netzke_grid_panel_column.rb", "lib/netzke/accordion_panel.rb", "lib/netzke/ar_ext.rb", "lib/netzke/border_layout_panel.rb", "lib/netzke/column.rb", "lib/netzke/container.rb", "lib/netzke/grid_panel.rb", "lib/netzke/grid_panel_interface.rb", "lib/netzke/grid_panel_js_builder.rb", "lib/netzke/panel.rb", "lib/netzke/preference_grid.rb", "lib/netzke/properties_tool.rb", "lib/netzke/property_grid.rb", "lib/netzke/wrapper.rb", "lib/netzke-basepack.rb", "LICENSE", "README.mdown", "tasks/netzke_basepack_tasks.rake"]
-  s.files = ["CHANGELOG", "css/basepack.css", "generators/netzke_basepack/netzke_basepack_generator.rb", "generators/netzke_basepack/netzke_grid_panel_generator.rb", "generators/netzke_basepack/templates/create_netzke_grid_panel_columns.rb", "generators/netzke_basepack/USAGE", "init.rb", "install.rb", "javascripts/basepack.js", "javascripts/filters.js", "lib/app/models/netzke_grid_panel_column.rb", "lib/netzke/accordion_panel.rb", "lib/netzke/ar_ext.rb", "lib/netzke/border_layout_panel.rb", "lib/netzke/column.rb", "lib/netzke/container.rb", "lib/netzke/grid_panel.rb", "lib/netzke/grid_panel_interface.rb", "lib/netzke/grid_panel_js_builder.rb", "lib/netzke/panel.rb", "lib/netzke/preference_grid.rb", "lib/netzke/properties_tool.rb", "lib/netzke/property_grid.rb", "lib/netzke/wrapper.rb", "lib/netzke-basepack.rb", "LICENSE", "Manifest", "Rakefile", "README.mdown", "tasks/netzke_basepack_tasks.rake", "test/app_root/app/controllers/application.rb", "test/app_root/app/models/book.rb", "test/app_root/app/models/category.rb", "test/app_root/app/models/city.rb", "test/app_root/app/models/continent.rb", "test/app_root/app/models/country.rb", "test/app_root/app/models/genre.rb", "test/app_root/config/boot.rb", "test/app_root/config/database.yml", "test/app_root/config/environment.rb", "test/app_root/config/environments/in_memory.rb", "test/app_root/config/environments/mysql.rb", "test/app_root/config/environments/postgresql.rb", "test/app_root/config/environments/sqlite.rb", "test/app_root/config/environments/sqlite3.rb", "test/app_root/config/routes.rb", "test/app_root/db/migrate/20081222033343_create_books.rb", "test/app_root/db/migrate/20081222033440_create_genres.rb", "test/app_root/db/migrate/20081222035855_create_netzke_preferences.rb", "test/app_root/db/migrate/20081223024935_create_categories.rb", "test/app_root/db/migrate/20081223025635_create_countries.rb", "test/app_root/db/migrate/20081223025653_create_continents.rb", "test/app_root/db/migrate/20081223025732_create_cities.rb", "test/app_root/script/console", "test/ar_ext_test.rb", "test/border_layout_panel_test.rb", "test/column_test.rb", "test/console_with_fixtures.rb", "test/fixtures/books.yml", "test/fixtures/categories.yml", "test/fixtures/cities.yml", "test/fixtures/continents.yml", "test/fixtures/countries.yml", "test/fixtures/genres.yml", "test/grid_panel_test.rb", "test/netzke_basepack_test.rb", "test/schema.rb", "test/test_helper.rb", "uninstall.rb", "netzke-basepack.gemspec"]
+  s.extra_rdoc_files = ["CHANGELOG", "lib/app/models/netzke_form_panel_field.rb", "lib/app/models/netzke_grid_panel_column.rb", "lib/netzke/accordion_panel.rb", "lib/netzke/ar_ext.rb", "lib/netzke/border_layout_panel.rb", "lib/netzke/column.rb", "lib/netzke/container.rb", "lib/netzke/form_panel.rb", "lib/netzke/grid_panel.rb", "lib/netzke/grid_panel_interface.rb", "lib/netzke/grid_panel_js_builder.rb", "lib/netzke/panel.rb", "lib/netzke/preference_grid.rb", "lib/netzke/properties_tool.rb", "lib/netzke/property_grid.rb", "lib/netzke/wrapper.rb", "lib/netzke-basepack.rb", "LICENSE", "README.rdoc", "tasks/netzke_basepack_tasks.rake"]
+  s.files = ["CHANGELOG", "css/basepack.css", "generators/netzke_basepack/netzke_basepack_generator.rb", "generators/netzke_basepack/USAGE", "generators/netzke_form_panel/netzke_form_panel_generator.rb", "generators/netzke_form_panel/templates/create_netzke_form_panel_fields.rb", "generators/netzke_grid_panel/netzke_grid_panel_generator.rb", "generators/netzke_grid_panel/templates/create_netzke_grid_panel_columns.rb", "init.rb", "install.rb", "javascripts/basepack.js", "javascripts/filters.js", "lib/app/models/netzke_form_panel_field.rb", "lib/app/models/netzke_grid_panel_column.rb", "lib/netzke/accordion_panel.rb", "lib/netzke/ar_ext.rb", "lib/netzke/border_layout_panel.rb", "lib/netzke/column.rb", "lib/netzke/container.rb", "lib/netzke/form_panel.rb", "lib/netzke/grid_panel.rb", "lib/netzke/grid_panel_interface.rb", "lib/netzke/grid_panel_js_builder.rb", "lib/netzke/panel.rb", "lib/netzke/preference_grid.rb", "lib/netzke/properties_tool.rb", "lib/netzke/property_grid.rb", "lib/netzke/wrapper.rb", "lib/netzke-basepack.rb", "LICENSE", "Manifest", "Rakefile", "README.rdoc", "tasks/netzke_basepack_tasks.rake", "test/app_root/app/controllers/application.rb", "test/app_root/app/models/book.rb", "test/app_root/app/models/category.rb", "test/app_root/app/models/city.rb", "test/app_root/app/models/continent.rb", "test/app_root/app/models/country.rb", "test/app_root/app/models/genre.rb", "test/app_root/config/boot.rb", "test/app_root/config/database.yml", "test/app_root/config/environment.rb", "test/app_root/config/environments/in_memory.rb", "test/app_root/config/environments/mysql.rb", "test/app_root/config/environments/postgresql.rb", "test/app_root/config/environments/sqlite.rb", "test/app_root/config/environments/sqlite3.rb", "test/app_root/config/routes.rb", "test/app_root/db/migrate/20081222033343_create_books.rb", "test/app_root/db/migrate/20081222033440_create_genres.rb", "test/app_root/db/migrate/20081222035855_create_netzke_preferences.rb", "test/app_root/db/migrate/20081223024935_create_categories.rb", "test/app_root/db/migrate/20081223025635_create_countries.rb", "test/app_root/db/migrate/20081223025653_create_continents.rb", "test/app_root/db/migrate/20081223025732_create_cities.rb", "test/app_root/db/migrate/20090102223630_create_netzke_layouts.rb", "test/app_root/db/migrate/20090102223811_create_netzke_grid_panel_columns.rb", "test/app_root/script/console", "test/app_root/vendor/plugins/acts_as_list/init.rb", "test/app_root/vendor/plugins/acts_as_list/lib/active_record/acts/list.rb", "test/app_root/vendor/plugins/acts_as_list/README", "test/ar_ext_test.rb", "test/border_layout_panel_test.rb", "test/column_test.rb", "test/console_with_fixtures.rb", "test/fixtures/books.yml", "test/fixtures/categories.yml", "test/fixtures/cities.yml", "test/fixtures/continents.yml", "test/fixtures/countries.yml", "test/fixtures/genres.yml", "test/grid_panel_test.rb", "test/netzke_basepack_test.rb", "test/schema.rb", "test/test_helper.rb", "uninstall.rb", "netzke-basepack.gemspec"]
   s.has_rdoc = true
   s.homepage = %q{http://writelesscode.com}
-  s.rdoc_options = ["--line-numbers", "--inline-source", "--title", "Netzke-basepack", "--main", "README.mdown"]
+  s.rdoc_options = ["--line-numbers", "--inline-source", "--title", "Netzke-basepack", "--main", "README.rdoc"]
   s.require_paths = ["lib"]
   s.rubyforge_project = %q{netzke-basepack}
   s.rubygems_version = %q{1.3.1}
@@ -26,13 +26,13 @@ Gem::Specification.new do |s|
 
     if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
       s.add_runtime_dependency(%q<searchlogic>, [">= 1.6.2"])
-      s.add_runtime_dependency(%q<netzke-core>, [">= 0", "= 0.2.1"])
+      s.add_runtime_dependency(%q<netzke-core>, [">= 0", "= 0.2.2"])
     else
       s.add_dependency(%q<searchlogic>, [">= 1.6.2"])
-      s.add_dependency(%q<netzke-core>, [">= 0", "= 0.2.1"])
+      s.add_dependency(%q<netzke-core>, [">= 0", "= 0.2.2"])
     end
   else
     s.add_dependency(%q<searchlogic>, [">= 1.6.2"])
-    s.add_dependency(%q<netzke-core>, [">= 0", "= 0.2.1"])
+    s.add_dependency(%q<netzke-core>, [">= 0", "= 0.2.2"])
   end
 end

data/test/app_root/db/migrate/20090102223630_create_netzke_layouts.rb

@@ -0,0 +1,14 @@
+class CreateNetzkeLayouts < ActiveRecord::Migration
+  def self.up
+    create_table :netzke_layouts do |t|
+      t.string  :widget_name
+      t.string  :items_class
+      t.integer :user_id
+      t.timestamps
+    end
+  end
+
+  def self.down
+    drop_table :netzke_layouts
+  end
+end

data/test/app_root/db/migrate/20090102223811_create_netzke_grid_panel_columns.rb

@@ -0,0 +1,21 @@
+class CreateNetzkeGridPanelColumns < ActiveRecord::Migration
+  def self.up
+    create_table :netzke_grid_panel_columns do |t|
+      t.string    :name
+      t.string    :label
+      t.boolean   :read_only
+      t.integer   :position
+      t.boolean   :hidden
+      t.integer   :width
+      t.string    :editor, :limit => 32
+
+      t.integer   :layout_id
+      
+      t.timestamps
+    end
+  end
+
+  def self.down
+    drop_table :netzke_grid_panel_columns
+  end
+end

data/test/app_root/vendor/plugins/acts_as_list/README

@@ -0,0 +1,23 @@
+ActsAsList
+==========
+
+This acts_as extension provides the capabilities for sorting and reordering a number of objects in a list. The class that has this specified needs to have a +position+ column defined as an integer on the mapped database table.
+
+
+Example
+=======
+
+  class TodoList < ActiveRecord::Base
+    has_many :todo_items, :order => "position"
+  end
+
+  class TodoItem < ActiveRecord::Base
+    belongs_to :todo_list
+    acts_as_list :scope => :todo_list
+  end
+
+  todo_list.first.move_to_bottom
+  todo_list.last.move_higher
+
+
+Copyright (c) 2007 David Heinemeier Hansson, released under the MIT license

data/test/app_root/vendor/plugins/acts_as_list/init.rb

@@ -0,0 +1,3 @@
+$:.unshift "#{File.dirname(__FILE__)}/lib"
+require 'active_record/acts/list'
+ActiveRecord::Base.class_eval { include ActiveRecord::Acts::List }

data/test/app_root/vendor/plugins/acts_as_list/lib/active_record/acts/list.rb

@@ -0,0 +1,256 @@
+module ActiveRecord
+  module Acts #:nodoc:
+    module List #:nodoc:
+      def self.included(base)
+        base.extend(ClassMethods)
+      end
+
+      # This +acts_as+ extension provides the capabilities for sorting and reordering a number of objects in a list.
+      # The class that has this specified needs to have a +position+ column defined as an integer on
+      # the mapped database table.
+      #
+      # Todo list example:
+      #
+      #   class TodoList < ActiveRecord::Base
+      #     has_many :todo_items, :order => "position"
+      #   end
+      #
+      #   class TodoItem < ActiveRecord::Base
+      #     belongs_to :todo_list
+      #     acts_as_list :scope => :todo_list
+      #   end
+      #
+      #   todo_list.first.move_to_bottom
+      #   todo_list.last.move_higher
+      module ClassMethods
+        # Configuration options are:
+        #
+        # * +column+ - specifies the column name to use for keeping the position integer (default: +position+)
+        # * +scope+ - restricts what is to be considered a list. Given a symbol, it'll attach <tt>_id</tt> 
+        #   (if it hasn't already been added) and use that as the foreign key restriction. It's also possible 
+        #   to give it an entire string that is interpolated if you need a tighter scope than just a foreign key.
+        #   Example: <tt>acts_as_list :scope => 'todo_list_id = #{todo_list_id} AND completed = 0'</tt>
+        def acts_as_list(options = {})
+          configuration = { :column => "position", :scope => "1 = 1" }
+          configuration.update(options) if options.is_a?(Hash)
+
+          configuration[:scope] = "#{configuration[:scope]}_id".intern if configuration[:scope].is_a?(Symbol) && configuration[:scope].to_s !~ /_id$/
+
+          if configuration[:scope].is_a?(Symbol)
+            scope_condition_method = %(
+              def scope_condition
+                if #{configuration[:scope].to_s}.nil?
+                  "#{configuration[:scope].to_s} IS NULL"
+                else
+                  "#{configuration[:scope].to_s} = \#{#{configuration[:scope].to_s}}"
+                end
+              end
+            )
+          else
+            scope_condition_method = "def scope_condition() \"#{configuration[:scope]}\" end"
+          end
+
+          class_eval <<-EOV
+            include ActiveRecord::Acts::List::InstanceMethods
+
+            def acts_as_list_class
+              ::#{self.name}
+            end
+
+            def position_column
+              '#{configuration[:column]}'
+            end
+
+            #{scope_condition_method}
+
+            before_destroy :remove_from_list
+            before_create  :add_to_list_bottom
+          EOV
+        end
+      end
+
+      # All the methods available to a record that has had <tt>acts_as_list</tt> specified. Each method works
+      # by assuming the object to be the item in the list, so <tt>chapter.move_lower</tt> would move that chapter
+      # lower in the list of all chapters. Likewise, <tt>chapter.first?</tt> would return +true+ if that chapter is
+      # the first in the list of all chapters.
+      module InstanceMethods
+        # Insert the item at the given position (defaults to the top position of 1).
+        def insert_at(position = 1)
+          insert_at_position(position)
+        end
+
+        # Swap positions with the next lower item, if one exists.
+        def move_lower
+          return unless lower_item
+
+          acts_as_list_class.transaction do
+            lower_item.decrement_position
+            increment_position
+          end
+        end
+
+        # Swap positions with the next higher item, if one exists.
+        def move_higher
+          return unless higher_item
+
+          acts_as_list_class.transaction do
+            higher_item.increment_position
+            decrement_position
+          end
+        end
+
+        # Move to the bottom of the list. If the item is already in the list, the items below it have their
+        # position adjusted accordingly.
+        def move_to_bottom
+          return unless in_list?
+          acts_as_list_class.transaction do
+            decrement_positions_on_lower_items
+            assume_bottom_position
+          end
+        end
+
+        # Move to the top of the list. If the item is already in the list, the items above it have their
+        # position adjusted accordingly.
+        def move_to_top
+          return unless in_list?
+          acts_as_list_class.transaction do
+            increment_positions_on_higher_items
+            assume_top_position
+          end
+        end
+
+        # Removes the item from the list.
+        def remove_from_list
+          if in_list?
+            decrement_positions_on_lower_items
+            update_attribute position_column, nil
+          end
+        end
+
+        # Increase the position of this item without adjusting the rest of the list.
+        def increment_position
+          return unless in_list?
+          update_attribute position_column, self.send(position_column).to_i + 1
+        end
+
+        # Decrease the position of this item without adjusting the rest of the list.
+        def decrement_position
+          return unless in_list?
+          update_attribute position_column, self.send(position_column).to_i - 1
+        end
+
+        # Return +true+ if this object is the first in the list.
+        def first?
+          return false unless in_list?
+          self.send(position_column) == 1
+        end
+
+        # Return +true+ if this object is the last in the list.
+        def last?
+          return false unless in_list?
+          self.send(position_column) == bottom_position_in_list
+        end
+
+        # Return the next higher item in the list.
+        def higher_item
+          return nil unless in_list?
+          acts_as_list_class.find(:first, :conditions =>
+            "#{scope_condition} AND #{position_column} = #{(send(position_column).to_i - 1).to_s}"
+          )
+        end
+
+        # Return the next lower item in the list.
+        def lower_item
+          return nil unless in_list?
+          acts_as_list_class.find(:first, :conditions =>
+            "#{scope_condition} AND #{position_column} = #{(send(position_column).to_i + 1).to_s}"
+          )
+        end
+
+        # Test if this record is in a list
+        def in_list?
+          !send(position_column).nil?
+        end
+
+        private
+          def add_to_list_top
+            increment_positions_on_all_items
+          end
+
+          def add_to_list_bottom
+            self[position_column] = bottom_position_in_list.to_i + 1
+          end
+
+          # Overwrite this method to define the scope of the list changes
+          def scope_condition() "1" end
+
+          # Returns the bottom position number in the list.
+          #   bottom_position_in_list    # => 2
+          def bottom_position_in_list(except = nil)
+            item = bottom_item(except)
+            item ? item.send(position_column) : 0
+          end
+
+          # Returns the bottom item
+          def bottom_item(except = nil)
+            conditions = scope_condition
+            conditions = "#{conditions} AND #{self.class.primary_key} != #{except.id}" if except
+            acts_as_list_class.find(:first, :conditions => conditions, :order => "#{position_column} DESC")
+          end
+
+          # Forces item to assume the bottom position in the list.
+          def assume_bottom_position
+            update_attribute(position_column, bottom_position_in_list(self).to_i + 1)
+          end
+
+          # Forces item to assume the top position in the list.
+          def assume_top_position
+            update_attribute(position_column, 1)
+          end
+
+          # This has the effect of moving all the higher items up one.
+          def decrement_positions_on_higher_items(position)
+            acts_as_list_class.update_all(
+              "#{position_column} = (#{position_column} - 1)", "#{scope_condition} AND #{position_column} <= #{position}"
+            )
+          end
+
+          # This has the effect of moving all the lower items up one.
+          def decrement_positions_on_lower_items
+            return unless in_list?
+            acts_as_list_class.update_all(
+              "#{position_column} = (#{position_column} - 1)", "#{scope_condition} AND #{position_column} > #{send(position_column).to_i}"
+            )
+          end
+
+          # This has the effect of moving all the higher items down one.
+          def increment_positions_on_higher_items
+            return unless in_list?
+            acts_as_list_class.update_all(
+              "#{position_column} = (#{position_column} + 1)", "#{scope_condition} AND #{position_column} < #{send(position_column).to_i}"
+            )
+          end
+
+          # This has the effect of moving all the lower items down one.
+          def increment_positions_on_lower_items(position)
+            acts_as_list_class.update_all(
+              "#{position_column} = (#{position_column} + 1)", "#{scope_condition} AND #{position_column} >= #{position}"
+           )
+          end
+
+          # Increments position (<tt>position_column</tt>) of all items in the list.
+          def increment_positions_on_all_items
+            acts_as_list_class.update_all(
+              "#{position_column} = (#{position_column} + 1)",  "#{scope_condition}"
+            )
+          end
+
+          def insert_at_position(position)
+            remove_from_list
+            increment_positions_on_lower_items(position)
+            self.update_attribute(position_column, position)
+          end
+      end 
+    end
+  end
+end