Contents

module DynamicFieldsets
  # Stores a collection of fields and other fieldsets
  #
  # @author Jeremiah Hemphill, Ethan Pemble
  class Fieldset < ActiveRecord::Base
    # Relations
    has_many :fieldset_associators
    belongs_to :parent_fieldset, :class_name => "Fieldset", :foreign_key => "parent_fieldset_id"
    has_many :child_fieldsets, :class_name => "Fieldset", :foreign_key => "parent_fieldset_id"
    has_many :fields

    # Validations
    validates_presence_of :name
    validates_presence_of :description
    validates_presence_of :nkey
    validates_uniqueness_of :nkey
    validates_presence_of :order_num, :if => lambda { !self.root? }
    validate :cannot_be_own_parent

    # looks recursively up the parent_fieldset value to check if it sees itself
    def cannot_be_own_parent
      parent = self.parent_fieldset
      while !parent.nil?
        if parent == self
          self.errors.add(:parent_fieldset, "Parent fieldsets must not create a cycle.")
          parent = nil
        else
          parent = parent.parent_fieldset
        end
      end
    end
    
    # @return [Array] Scope: parent-less fieldsets
    scope :roots, :conditions => ["parent_fieldset_id IS NULL"]
    
    # @return [Array] An array of name, id pairs to be used in select tags
    def self.parent_fieldset_list
      all.collect { |f| [f.name, f.id] }
    end

    # @return [Boolean] True if fieldset has no parent
    def root?
      return parent_fieldset.nil?
    end
    
    # The collected descendents of a fieldset.  This group is sorted first by order number, 
    # then alphabetically by name in the case of duplicate order numbers.
    # @return [Array] Ordered collection of descendent fields and fieldsets.
    def children
      collected_children = []
      fields.reject{|f| !f.enabled}.each{ |field| collected_children.push field }
      child_fieldsets.each{ |fieldset| collected_children.push fieldset }
      return collected_children.sort_by{ |child| [child.order_num, child.name] }
    end

  end
end

Version data entries

2 entries across 2 versions & 1 rubygems

Version	Path
dynamic_fieldsets-0.0.3	app/models/dynamic_fieldsets/fieldset.rb
dynamic_fieldsets-0.0.2	app/models/dynamic_fieldsets/fieldset.rb