binda 0.1.3 → 0.1.4

data/app/models/binda/string.rb

@@ -1,4 +1,8 @@
 module Binda
+	# This class depends on `Binda::Text` and it's use mainly to differentiate the type of text 
+	#   this class is responsible for.
+	# 
+	# Binda uses this class to store plain text. The field responsible to store `Binda::String` instances is `type="string"`.
 	class String < Text
 	end
 end

data/app/models/binda/structure.rb

@@ -12,7 +12,11 @@ module Binda
 		# Validations
 		validates :name, presence: true
 		validates :slug, uniqueness: true
-		validates :instance_type, presence: true, inclusion: { in: %w(component board), message: "%{value} is not a valid instance" }
+		validates_associated :field_groups
+		validates :instance_type, presence: true, inclusion: { 
+			in: %w(component board), 
+			message: I18n.t('binda.structure.validation_message.instance_type', { arg1: "%{value}" })
+		}
 		accepts_nested_attributes_for :field_groups, allow_destroy: true, reject_if: :is_rejected
 
 		# Slug
@@ -20,7 +24,7 @@ module Binda
 		friendly_id :default_slug, use: [:slugged, :finders]
 
 		after_create :add_default_field_group
-		after_create :add_instance_details
+		after_save :add_instance_details
 		after_create :set_default_position
 
 		# Friendly id preference on slug generation
@@ -28,12 +32,12 @@ module Binda
 		# Method inherited from friendly id 
 		# @see https://github.com/norman/friendly_id/issues/436
 		def should_generate_new_friendly_id?
-			slug.blank? || name_changed?
+			slug.blank?
 		end
 
 		#
 		# Sets the validation rules to accept and save an attribute
-		def is_rejected( attributes )
+		def is_rejected(attributes)
 			attributes['name'].blank?
 		end
 
@@ -41,10 +45,10 @@ module Binda
 		#
 		# It generates 4 possible slugs before falling back to FriendlyId default behaviour
 		def default_slug
-			[ "#{ self.name }",
-				"#{ self.name }-1",
-				"#{ self.name }-2",
-				"#{ self.name }-3" ]
+			[ "#{ self.name.parameterize }",
+				"#{ self.name.parameterize }-1",
+				"#{ self.name.parameterize }-2",
+				"#{ self.name.parameterize }-3" ]
 		end
 
 		# Add a field group as a default
@@ -54,10 +58,10 @@ module Binda
 		# @return [redirect]
 		def add_default_field_group
 			# Creates a default empty field group 
-			field_group = self.field_groups.build( name: 'General Details', position: 1 )
+			field_group = self.field_groups.build(name: I18n.t('binda.default_field_group.name'), position: 1)
 			# Unless there is a problem...
 			unless field_group.save
-				return redirect_to structure_path( self.slug ), flash: { error: 'General Details group hasn\'t been created' }
+				return redirect_to structure_path(self.slug), flash: { error: I18n.t('binda.default_field_group.error_on_create') }
 			end
 		end
 
@@ -68,10 +72,17 @@ module Binda
 		#   It also disable categories (this could be a different method, or method could be more explicit)
 		def add_instance_details
 			if self.instance_type == 'board'
-				self.update_attribute 'has_categories', false
+				self.update_attribute('has_categories', false)
+					add_default_board
+			end
+		end
+
+		# Add default board to a structure if needed
+		def add_default_board
+			if Board.where(structure_id: self.id).empty?
 				board = self.build_board( name: self.name )
 				unless board.save
-					return redirect_to structure_path( self.slug ), flash: { error: 'The board instance hasn\'t been created' }
+					return redirect_to structure_path(self.slug), flash: { error: I18n.t('binda.default_field_group.error_on_create') }
 				end
 			end
 		end
@@ -83,8 +94,8 @@ module Binda
 		# 
 		# @return [object] Repeater instance
 		def set_default_position
-				position = Structure.all.length
-				self.update_attribute 'position', position
+			position = Structure.all.length
+			self.update_attribute('position', position)
 		end
 
 	end

data/app/models/binda/text.rb

@@ -1,9 +1,18 @@
 module Binda
+	# This class provides support for storing text. It can be called directly to get texts, 
+	#   or referenced to call other classes depending on it that deal differently with text.
+	#   
+	# Binda uses this class to store complex texts usually with rich HTML features. On the admin panel infact 
+	#   this field is represented by a WYSIWYG. But this is just a admin panel convention: the class can infact store 
+	#   a simple string of text as well.
   class Text < ApplicationRecord
 
   	# Associations
   	belongs_to :fieldable, polymorphic: true
   	belongs_to :field_setting
   	
+		validates :fieldable_id, presence: true
+		validates :fieldable_type, presence: true
+  	
   end
 end

data/app/models/binda/video.rb

@@ -1,4 +1,5 @@
 module Binda
+	# This class provides support for uploading videos.
 	class Video < Asset
 
     mount_uploader :video, VideoUploader

data/app/models/concerns/binda/default_helpers.rb

@@ -3,9 +3,6 @@ module Binda
 	module DefaultHelpers
 		extend ActiveSupport::Concern
 
-		included do 
-		end
-
 	  class_methods do
 
 			# Get components
@@ -35,14 +32,14 @@ module Binda
 			# @param slug [string] The slug of the structure to which the components belong
 			# @param slug [array] The slugs of the structures to which the components belongs
 			#   
-			# @return [ActiveRelation Object] if slug is nil or is an array
+			# @return [ActiveRecord::Relation Object] if slug is nil or is an array
 			# 
-			def get_components slug = nil
+			def get_components(slug = nil)
 				if slug.nil?
 					Component.all
 				else
 					# Generate query
-					Component.where( structure_id: Structure.where( slug: slug ) )
+					Component.where(structure_id: Structure.where(slug: slug))
 				end
 			end
 
@@ -64,13 +61,13 @@ module Binda
 			# @param slug [string] The slug of the structure on which the board is based
 			# @param slug [array] The slugs of the structures to which the board belongs
 			#   
-			# @return [ActiveRelation Object] if slug is nil or is an array  
+			# @return [ActiveRecord::Relation Object] if slug is nil or is an array  
 			# 
-			def get_boards slug = nil
+			def get_boards(slug = nil)
 				if slug.nil?
 					Board.all
 				else
-					Board.where( structure_id: Structure.where( slug: slug ) )
+					Board.where(structure_id: Structure.where(slug: slug))
 				end
 			end
 
@@ -92,13 +89,13 @@ module Binda
 			# @param slug [string] The slug of the structure to which categories belong
 			# @param slug [array] The slugs of the structures to which categories belong
 			#   
-			# @return [ActiveRelation Object] 
+			# @return [ActiveRecord::Relation Object] 
 			# 
-			def get_categories slug = nil
+			def get_categories(slug = nil)
 				if slug.nil?
 					Category.all
 				else
-					Category.where( structure_id: Structure.where( slug: slug ) )
+					Category.where(structure_id: Structure.where(slug: slug))
 				end
 			end
 
@@ -112,14 +109,14 @@ module Binda
 			# 	# returns all field settings
 			# 	
 			# 	B.get_field_settings('subtitle')
-			# 	# returns an ActiveRelation (a sort of Array) containing the 'subtitle' field setting
+			# 	# returns an ActiveRecord::Relation (a sort of Array) containing the 'subtitle' field setting
 			# 	
 			# @param slug [string] The slug of a specific field setting
 			# @param slug [array] The slugs of the selected field settings
 			# 
-			# @return [ActiveRelation Object] 
+			# @return [ActiveRecord::Relation] 
 			# 
-			def get_field_settings slug = nil
+			def get_field_settings(slug = nil)
 				if slug.nil?
 					FieldSetting.all
 				else
@@ -134,14 +131,14 @@ module Binda
 			# 
 			# @return [Array] 
 			# 
-			def get_relation_owners field_slug
+			def get_relation_owners(field_slug)
 				owner_class = Structure.includes(field_groups: :field_settings)
-					.where(binda_field_settings: {id: FieldSetting.where(slug: field_slug)})
+					.where(binda_field_settings: { id: FieldSetting.where(slug: field_slug) })
 					.first
 				obj = "Binda::#{owner_class.instance_type.classify}".constantize
 					.distinct
 					.includes(relations: :dependent_components)
-					.where(binda_relations: {field_setting_id: FieldSetting.where(slug: field_slug)})
+					.where(binda_relations: { field_setting_id: FieldSetting.where(slug: field_slug) })
 				raise ArgumentError, "There isn't any instance with a relation associated to the current slug (#{field_slug}).", caller if obj.nil?
 				return obj
 			end
@@ -162,25 +159,37 @@ module Binda
 			# 
 			# @return [Array] 
 			# 
-			def get_relation_dependents field_slug, instance_type = nil
+			def get_relation_dependents(field_slug, instance_type = nil)
 				raise ArgumentError, "There isn't any instance named: #{instance_type}. Make sure is either 'component' or 'board'", caller if !instance_type.nil? && ['board','component'].include?(instance_type)
 				
-				dependents = []
-				if instance_type != 'board'
-					dependent_components = Component.distinct
-						.includes(:owner_components)
-						.where(binda_relations: {field_setting_id: FieldSetting.where(slug: field_slug)})
-					dependents = [ *dependents, *dependent_components ]
-				elsif instance_type != 'component'
-					dependent_boards = Board.distinct
-						.includes(:owner_components)
-						.where(binda_relations: {field_setting_id: FieldSetting.where(slug: field_slug)})
-					dependents = [ *dependents, *dependent_boards ]
-				end
+				dependents = get_dependents(instance_type, field_slug)
 				
 				raise ArgumentError, "There isn't any instance with a relation associated to the current slug (#{field_slug}).", caller unless dependents.any?
 				return dependents
 			end
+
+			private
+
+				# Get dependents based on slug and instance type
+				# 
+				# @param instance_type [string] The instance type of the record (either board or component)
+				# @param field_slug [string] The record slug
+				# @return [array] Array of ActiveRecord dependents
+				def get_dependents(instance_type, field_slug)
+					dependents = []
+					if instance_type != 'board'
+						dependent_components = Component.distinct
+							.includes(:owner_components)
+							.where(binda_relations: { field_setting_id: FieldSetting.where(slug: field_slug) })
+						dependents = [ *dependents, *dependent_components ]
+					elsif instance_type != 'component'
+						dependent_boards = Board.distinct
+							.includes(:owner_components)
+							.where(binda_relations: { field_setting_id: FieldSetting.where(slug: field_slug) })
+						dependents = [ *dependents, *dependent_boards ]
+					end
+					return dependents
+				end
 	  end
 	end
 end

data/app/models/concerns/binda/deprecations.rb

@@ -0,0 +1,6 @@
+Binda::Deprecation
+	.new
+	.deprecate_methods(
+  	Binda::FieldableAssociations, 
+  	get_selection_choice: :get_selection_choices
+  )

data/app/models/concerns/binda/fieldable_association_helpers.rb

@@ -0,0 +1,366 @@
+module Binda
+	module FieldableAssociationHelpers
+
+		extend ActiveSupport::Concern
+
+		# Get the object related to that field setting
+		# If the object doesn't exists yet it will return nil
+		# 
+		# @param  field_slug [string] The slug of the field setting
+		# @return [string] Returns the content of the text 
+		# @return [error]  Raise an error if no record is found
+		def get_text(field_slug)
+			obj = self.texts.find{ |t| t.field_setting_id == FieldSetting.get_id( field_slug ) && t.type != 'Binda::String' }	
+			unless obj.nil?
+				obj.content
+			else
+				check_text_error field_slug
+			end
+		end
+
+		# Check why get_text doesn't return a value
+		# This method isn't supposed to be used by anything other than get_text method
+		def check_text_error(field_slug)
+			you_mean_string = !self.strings.find{ |t| t.field_setting_id == FieldSetting.get_id( field_slug ) && t.type = 'Binda::String' }.nil?
+			if you_mean_string
+				raise ArgumentError, "This slug (#{field_slug}) is associated to a string not a text. Use get_string() instead on instance (#{self.class.name} ##{self.id}).", caller
+			else
+				raise ArgumentError, "There isn't any text associated to the current slug (#{field_slug}) on instance (#{self.class.name} ##{self.id}).", caller
+			end
+		end
+
+		# Get the object related to that field setting
+		# 
+		# @param field_slug [string] The slug of the field setting
+		# @return [boolean]
+		def has_text(field_slug)
+			obj = self.texts.find{ |t| t.field_setting_id == FieldSetting.get_id( field_slug ) && t.type != 'Binda::String' }
+			raise ArgumentError, "There isn't any text associated to the current slug (#{field_slug}) on instance (#{self.class.name} ##{self.id}).", caller if obj.nil?
+			if obj.present?
+				return !obj.content.nil?
+			else
+				return false
+			end
+		end
+
+		# Get the object related to that field setting
+		# If the object doesn't exists yet it will return nil
+		# 
+		# @param  field_slug [string] The slug of the field setting
+		# @return [string] Returns the content of the string 
+		# @return [error]  Raise an error if no record is found
+		def get_string(field_slug)
+			obj = self.strings.find{ |t| t.field_setting_id == FieldSetting.get_id( field_slug ) && t.type == 'Binda::String' }
+			unless obj.nil?
+				obj.content
+			else
+				check_string_error field_slug
+			end
+		end
+
+		# Check why get_string doesn't return a value
+		# This method isn't supposed to be used by anything other than get_string method
+		def check_string_error(field_slug)
+			you_mean_text = !self.strings.find{ |t| t.field_setting_id == FieldSetting.get_id( field_slug ) && t.type = 'Binda::Text' }.nil?
+			if you_mean_text
+				raise ArgumentError, "This slug (#{field_slug}) is associated to a text not a string. Use get_text() instead on instance (#{self.class.name} ##{self.id}).", caller
+			else
+				raise ArgumentError, "There isn't any string associated to the current slug (#{field_slug}) on instance (#{self.class.name} ##{self.id}).", caller
+			end
+		end
+
+		# Get the object related to that field setting
+		# 
+		# @param field_slug [string] The slug of the field setting
+		# @return [boolean]
+		def has_string(field_slug)
+			obj = self.strings.find{ |t| t.field_setting_id == FieldSetting.get_id( field_slug ) && t.type == 'Binda::String' }
+			raise ArgumentError, "There isn't any string associated to the current slug (#{field_slug}) on instance (#{self.class.name} ##{self.id}).", caller if obj.nil?
+			if obj.present?
+				return !obj.content.nil?
+			else
+				return false
+			end
+		end
+
+		# Check if the field has an attached image
+		# 
+		# @param field_slug [string] The slug of the field setting
+		# @return [boolean]
+		def has_image(field_slug)
+			obj = self.images.find{ |t| t.field_setting_id == FieldSetting.get_id( field_slug ) }
+			# Alternative query
+			# obj = Image.where(field_setting_id: FieldSetting.get_id( field_slug ), fieldable_id: self.id, fieldable_type: self.class.to_s ).first
+			raise ArgumentError, "There isn't any image associated to the current slug (#{field_slug}) on instance (#{self.class.name} ##{self.id}).", caller if obj.nil?
+			return obj.image.present?
+		end
+
+		# Get the image url based on the size provided, 
+		#   default is Carrierwave default (usually the real size)
+		# 
+		# @param field_slug [string] The slug of the field setting
+		# @param size [string] The size. It can be 'thumb' 200x200 cropped, 
+		#   'medium' 700x700 max size, 'large' 1400x1400 max size, or blank
+		# @return [string] The url of the image
+		def get_image_url(field_slug, size = '')
+			get_image_info( field_slug, size, 'url' )
+		end
+
+		# Get the image path based on the size provided, 
+		#   default is Carrierwave default (usually the real size)
+		# 
+		# @param field_slug [string] The slug of the field setting
+		# @param size [string] The size. It can be 'thumb' 200x200 cropped, 
+		#   'medium' 700x700 max size, 'large' 1400x1400 max size, or blank
+		# @return [string] The url of the image
+		def get_image_path(field_slug, size = '')
+			get_image_info( field_slug, size, 'path' )
+		end
+
+		# Get the object related to that field setting
+		# 
+		# @param field_slug [string] The slug of the field setting
+		# @param size [string] The size. It can be 'thumb' 200x200 cropped, 
+		#   'medium' 700x700 max size, 'large' 1400x1400 max size, or blank
+		# @param info [string] String of the info to be retrieved
+		# @return [string] The info requested if present
+		# @return [boolean] Returns false if no info is found or if image isn't found
+		def get_image_info(field_slug, size, info)
+			obj = self.images.find{ |t| t.field_setting_id == FieldSetting.get_id( field_slug ) }
+			# Alternative query
+			# obj = Image.where(field_setting_id: FieldSetting.get_id( field_slug ), fieldable_id: self.id, fieldable_type: self.class.to_s ).first
+			raise ArgumentError, "There isn't any image associated to the current slug (#{field_slug}) on instance (#{self.class.name} ##{self.id}).", caller if obj.nil?
+			if obj.image.present? && obj.image.respond_to?(size) && %w[thumb medium large].include?(size)
+					obj.image.send(size).send(info)
+			elsif obj.image.present?
+				obj.image.send(info)
+			else
+				raise "Looks like the image you are looking for isn't present. See field setting with slug=\"#{field_slug}\" on component with id=\"self.id\""
+			end
+		end
+
+		def get_image_dimension(field_slug)
+			obj = self.images.find{ |t| t.field_setting_id == FieldSetting.get_id( field_slug ) }
+
+			raise ArgumentError, "There isn't any image associated to  the current slug (#{field_slug}) on instance (#{self.class.name} ##{self.id}).", caller if obj.nil?
+			if obj.image.present? && obj.image.respond_to?(size) && %w[thumb medium large].include?(size)
+					obj.image.send(size).send(info)
+			elsif obj.image.present?
+				obj.image.send(info)
+			else
+				raise "Looks like the image you are looking for isn't present. See field setting with slug=\"#{field_slug}\" on component with id=\"self.id\""
+			end
+		end
+
+		# Check if the field has an attached video
+		# 
+		# @param field_slug [string] The slug of the field setting
+		# @return [boolean]
+		def has_video(field_slug)
+			obj = self.videos.find{ |t| t.field_setting_id == FieldSetting.get_id( field_slug ) }
+			# Alternative query
+			# obj = Image.where(field_setting_id: FieldSetting.get_id( field_slug ), fieldable_id: self.id, fieldable_type: self.class.to_s ).first
+			raise ArgumentError, "There isn't any video associated to the current slug (#{field_slug}) on instance (#{self.class.name} ##{self.id}).", caller if obj.nil?
+			return obj.video.present?
+		end
+
+		# Get the video url based on the size provided, 
+		#   default is Carrierwave default (usually the real size)
+		# 
+		# @param field_slug [string] The slug of the field setting
+		# @param size [string] The size. It can be 'thumb' 200x200 cropped, 
+		#   'medium' 700x700 max size, 'large' 1400x1400 max size, or blank
+		# @return [string] The url of the video
+		def get_video_url(field_slug)
+			get_video_info( field_slug, 'url' )
+		end
+
+		# Get the video path based on the size provided, 
+		#   default is Carrierwave default (usually the real size)
+		# 
+		# @param field_slug [string] The slug of the field setting
+		# @param size [string] The size. It can be 'thumb' 200x200 cropped, 
+		#   'medium' 700x700 max size, 'large' 1400x1400 max size, or blank
+		# @return [string] The url of the video
+		def get_video_path(field_slug)
+			get_video_info( field_slug, 'path' )
+		end
+
+		# Get the object related to that field setting
+		# 
+		# @param field_slug [string] The slug of the field setting
+		# @param info [string] String of the info to be retrieved
+		# @return [string] The info requested if present
+		# @return [boolean] Returns false if no info is found or if image isn't found
+		def get_video_info(field_slug, info)
+			obj = self.videos.find{ |t| t.field_setting_id == FieldSetting.get_id( field_slug ) }
+			# Alternative query
+			# obj = video.where(field_setting_id: FieldSetting.get_id( field_slug ), fieldable_id: self.id, fieldable_type: self.class.to_s ).first
+			raise ArgumentError, "There isn't any video associated to the current slug (#{field_slug}) on instance (#{self.class.name} ##{self.id}).", caller if obj.nil?
+			if obj.video.present?
+				obj.video.send(info)
+			end
+		end
+
+		# Check if the field has an attached date
+		# 
+		# @param field_slug [string] The slug of the field setting
+		# @return [datetime] The date
+		# @return [boolean] Reutrn false if nothing is found
+		def has_date(field_slug)
+			obj = self.dates.find{ |t| t.field_setting_id == FieldSetting.get_id( field_slug ) }
+			raise ArgumentError, "There isn't any date associated to the current slug (#{field_slug}) on instance (#{self.class.name} ##{self.id}).", caller if obj.nil?
+			if obj.present?
+				return !obj.date.nil?
+			else
+				return false
+			end
+		end
+
+		# Get the object related to that field setting
+		# 
+		# @param field_slug [string] The slug of the field setting
+		# @return [boolean]
+		def get_date(field_slug)
+			obj = self.dates.find{ |t| t.field_setting_id == FieldSetting.get_id( field_slug ) }
+			raise ArgumentError, "There isn't any date associated to the current slug (#{field_slug}) on instance (#{self.class.name} ##{self.id}).", caller if obj.nil?
+			obj.date
+		end
+
+		# Check if exists any repeater with that slug
+		# 
+		# @param field_slug [string] The slug of the field setting
+		# @return [boolean]
+		def has_repeater(field_slug)
+			obj = self.repeaters.find_all{ |t| t.field_setting_id == FieldSetting.get_id( field_slug ) }
+			raise ArgumentError, "There isn't any repeater associated to the current slug (#{field_slug}) on instance (#{self.class.name} ##{self.id}).", caller if obj.nil?
+			return obj.present?
+		end
+
+		# Get the all repeater instances sorted by position
+		# 
+		# @param field_slug [string] The slug of the field setting
+		# @return [array] An array of repeater items which have all sorts of fields attached
+		def get_repeater(field_slug)
+			obj = self.repeaters.find_all{ |t| t.field_setting_id == FieldSetting.get_id( field_slug ) }
+			raise ArgumentError, "There isn't any repeater associated to the current slug (#{field_slug}) on instance (#{self.class.name} ##{self.id}).", caller if obj.nil?
+			obj.sort_by(&:position)
+		end
+
+		# Get the radio choice
+		# 
+		# If by mistake the Radio instance has many choices associated, 
+		#   only the first one will be retrieved.
+		# 
+		# @param field_slug [string] The slug of the field setting
+		# @return [hash] A hash of containing the label and value of the selected choice. `{ label: 'the label', value: 'the value'}`
+		def get_radio_choice(field_slug)
+			field_setting = FieldSetting.find_by(slug:field_slug)
+			obj = self.radios.find{ |t| t.field_setting_id == field_setting.id }
+			raise ArgumentError, "There isn't any radio associated to the current slug (#{field_slug}) on instance (#{self.class.name} ##{self.id}).", caller if obj.nil?
+			raise "There isn't any choice available for the current radio (#{field_slug}) on instance (#{self.class.name} ##{self.id})." unless obj.choices.any?
+			return { label: obj.choices.first.label, value: obj.choices.first.value }
+		end
+
+		# Get the select choices
+		# 
+		# @param field_slug [string] The slug of the field setting
+		# @return [hash] A hash of containing the label and value of the selected choice. `{ label: 'the label', 'value': 'the value'}`
+		def get_selection_choice(field_slug)
+			field_setting = FieldSetting.find_by(slug:field_slug)
+			obj = self.selections.find{ |t| t.field_setting_id == field_setting.id }
+			raise ArgumentError, "There isn't any selection associated to the current slug (#{field_slug}) on instance (#{self.class.name} ##{self.id}).", caller if obj.nil?
+			raise "There isn't any choice available for the current selection (#{field_slug}) on instance (#{self.class.name} ##{self.id})." unless field_setting.choices.any?
+			return { label: obj.choices.first.label, value: obj.choices.first.value }
+		end
+
+		# Get the select choices
+		# 
+		# @param field_slug [string] The slug of the field setting
+		# @return [array] An array of hashes of containing label and value of the selected choices. `{ label: 'the label', 'value': 'the value'}`
+		def get_selection_choices(field_slug)
+			field_setting = FieldSetting.find_by(slug:field_slug)
+			obj = self.selections.find{ |t| t.field_setting_id == field_setting.id }
+			raise ArgumentError, "There isn't any selection associated to the current slug (#{field_slug}) on instance (#{self.class.name} ##{self.id}).", caller if obj.nil?
+			raise "There isn't any choice available for the current selection (#{field_slug}) on instance (#{self.class.name} ##{self.id})." unless field_setting.choices.any?
+			return obj.choices.map{|choice| { label: choice.label, value: choice.value }}
+		end
+
+		# Get the checkbox choice
+		# 
+		# @param field_slug [string] The slug of the field setting
+		# @return [array] An array of labels and values of the selected choices. `[{ label: '1st label', value: '1st-value'}, { label: '2nd label', value: '2nd-value'}]`
+		def get_checkbox_choices(field_slug)
+			field_setting = FieldSetting.find_by(slug:field_slug)
+			obj = self.checkboxes.find{ |t| t.field_setting_id == field_setting.id }
+			raise ArgumentError, "There isn't any checkbox associated to the current slug (#{field_slug}) on instance (#{self.class.name} ##{self.id}).", caller if obj.nil?
+			raise "There isn't any choice available for the current checkbox (#{field_slug}) on instance (#{self.class.name} ##{self.id})." unless field_setting.choices.any?
+			obj_array = []
+			obj.choices.order('label').each do |o|
+				obj_array << { label: o.label, value: o.value }
+			end
+			return obj_array
+		end
+
+		# Check if has related components
+		# 
+		# @param field_slug [string] The slug of the field setting
+		# @return [boolean]
+		def has_related_components(field_slug)
+			obj = self.relations.find{ |t| t.field_setting_id == FieldSetting.get_id( field_slug ) }
+			raise ArgumentError, "There isn't any related field associated to the current slug (#{field_slug}) on instance (#{self.class.name} ##{self.id}).", caller if obj.nil?
+			return obj.dependent_relations.any?
+		end
+
+		# Alias for has_related_components
+		def has_dependent_components(field_slug)
+			has_related_components(field_slug)
+		end
+
+		# Get related components
+		# 
+		# @param field_slug [string] The slug of the field setting
+		# @return [array] An array of components
+		def get_related_components(field_slug)
+			obj = self.relations.find{ |t| t.field_setting_id == FieldSetting.get_id( field_slug ) }
+			raise ArgumentError, "There isn't any related field associated to the current slug (#{field_slug}) on instance (#{self.class.name} ##{self.id}).", caller if obj.nil?
+			return obj.dependent_relations.map{|relation| relation.dependent}
+		end
+
+		# Alias for get_related_components
+		def get_dependent_components(field_slug)
+			get_related_components(field_slug)
+		end
+
+		# Get all components which owns a relation where the current instance is a dependent
+		# 
+		# @param field_slug [string] The slug of the field setting of the relation
+		# @return [array] An array of components and/or boards
+		def get_owner_components(field_slug)
+			# obj = self.owner_relations.find{ |t| t.field_setting_id == FieldSetting.get_id( field_slug ) }
+			obj = Relation.where(field_setting_id: B.get_field_settings(field_slug)).includes(dependent_relations: :dependent).where(binda_relation_links: {dependent_type: self.class.name})
+			raise ArgumentError, "There isn't any relation associated to the current slug (#{field_slug}) where the current instance (#{self.class.name} ##{self.id}) is a dependent.", caller if obj.nil?
+			return obj
+		end
+
+		# Check if has related boards
+		# 
+		# @param field_slug [string] The slug of the field setting
+		# @return [boolean]
+		def has_related_boards(field_slug)
+			obj = self.relations.find{ |t| t.field_setting_id == FieldSetting.get_id( field_slug ) }
+			raise ArgumentError, "There isn't any related field associated to the current slug (#{field_slug}) on instance (#{self.class.name} ##{self.id}).", caller if obj.nil?
+			return obj.dependent_relations.any?
+		end
+
+		# Get related boards
+		# 
+		# @param field_slug [string] The slug of the field setting
+		# @return [array] An array of boards
+		def get_related_boards(field_slug)
+			obj = self.relations.find{ |t| t.field_setting_idid == FieldSetting.get_id( field_slug ) }
+			raise ArgumentError, "There isn't any related field associated to the current slug (#{field_slug}) on instance (#{self.class.name} ##{self.id}).", caller if obj.nil?
+			return obj.dependent_relations.map{|relation| relation.dependent}
+		end
+	end
+end