drg_cms 0.4.39 → 0.4.53

data/app/models/dc_policy_role.rb

@@ -21,8 +21,12 @@
 # WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 #++
 
-#########################################################################
-#
+########################################################################
+# Mongoid::Document model for dc_policy_roles collection.
+# 
+# Documents in this model define all available user roles in the application. Roles 
+# are defined by unique name which is valid for current application or as alternative name (system_name) 
+# which can be persistent, when application is used as Rails plugin. 
 #########################################################################
 class DcPolicyRole
   include Mongoid::Document
@@ -32,16 +36,17 @@ class DcPolicyRole
   field   :system_name, type: String
   field   :active,      type: Boolean, default: true  
   
+  index( { name: 1 }, { unique: true } )
+  index( system_name: 1 )
+  
   validates :name, :length => { :minimum => 4 }  
-
-  index name: 1 
-  index system_name: 1 
+  validates :name, uniqueness: true    
 
 ########################################################################
-# Return choices for select for dc_policy_role_id
+# Return all defined roles as choices for use in select field.
 ########################################################################
 def self.choices4_roles
-  all.inject([]) { |r,role| r << [ role.name, role._id] }
+  where(active: true).order_by(name: 1).inject([]) { |r,role| r << [ role.name, role._id] }
 end
 
 end

data/app/models/dc_policy_rule.rb

@@ -21,6 +21,9 @@
 # WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 #++
 
+#########################################################################
+# ActiveSupport::Concern definition for DcPolicyRule class. 
+#########################################################################
 module DcPolicyRuleConcern
   extend ActiveSupport::Concern
   included do
@@ -30,14 +33,18 @@ module DcPolicyRuleConcern
 
   belongs_to :dc_policy_role
 
-  field      :permission,        type: Integer, default: 0
+  field      :permission,    type: Integer, default: 0
 
-#  embedded_in :dc_policy
-#  embedded_in :dc_permission  
   embedded_in :policy_rules, polymorphic: true 
 
 #########################################################################
 # Returns values for permissions ready to be used in select field.
+#
+# Example (as used in DRG CMS form): 
+#    20:
+#      name: permission
+#      type: select
+#      eval: DcPolicyRule.values_for_permissions
 #########################################################################
 def self.values_for_permissions
   key = 'helpers.label.dc_policy_rule.choices4_permission'
@@ -47,7 +54,20 @@ def self.values_for_permissions
 end
 
 #########################################################################
-# Will return permission name for value.
+# Will return translated permission name for value.
+# 
+# Parameters:
+# [value] Integer. Permission value
+# 
+# Example (as used in DRG CMS form):
+#    result_set:
+#      columns:
+#        2: 
+#          name: permission
+#          eval: DcPolicyRule.permission_name_for_value
+# 
+# Returns:
+# String. Name (description) for value
 #########################################################################
 def self.permission_name_for_value(value)
   values_for_permissions.each {|v| return v.first if v.last.to_i == value.to_i}
@@ -58,7 +78,15 @@ end
 end
 
 #########################################################################
+# Mongoid::Document model for dc_policy_rule documents embedded into documents.
+# 
+# DcPolicyRule documents define policies for accessing data. DRG CMS uses policy rules for
+# defining policies in DcSite, DcPermission and DcFolderPermission documents. 
+# 
+# Since they are defined as polymorphic they can be embedded into any 
+# application specific model by specifying this line in the model:
 # 
+#    embeds_many :dc_policy_rules, as: :policy_rules
 #########################################################################
 class DcPolicyRule
   include DcPolicyRuleConcern

data/app/models/dc_poll.rb

@@ -20,6 +20,14 @@
 # OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
 # WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 #++
+
+########################################################################
+# Mongoid::Document model for dc_poll documents.
+# 
+# DcPoll documents are used for different questionaries and formulars which can
+# be accessed independent or connected with DcPage documents. Entry fields can be defined
+# as DcSimpleItem embedded structure or as DRG CMS form YAML style entered into form field.
+########################################################################
 class DcPoll
   include Mongoid::Document
   include Mongoid::Timestamps

data/app/models/dc_poll_item.rb

@@ -20,6 +20,12 @@
 # OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
 # WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 #++
+
+########################################################################
+# Mongoid::Document model for dc_poll_item embedded documents.
+# 
+# DcPollItems define entry fields on poll questionary and formulars.
+########################################################################
 class DcPollItem
   include Mongoid::Document
   include Mongoid::Timestamps

data/app/models/dc_simple_menu.rb

@@ -20,6 +20,13 @@
 # OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
 # WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 #++
+
+#########################################################################
+# Mongoid::Document model for dc_simple_menus collection. 
+# 
+# Simple menus were first menu system developed for DRG CMS. They can be only two menu 
+# levels deep. Menus are described in dc_simple_menu_items embedded documents.
+#########################################################################
 class DcSimpleMenu
   include Mongoid::Document
   include Mongoid::Timestamps
@@ -35,12 +42,21 @@ class DcSimpleMenu
   index( { name: 1 }, { unique: true } )
 
   embeds_many :dc_simple_menu_items
-#  belongs_to  :dc_site
   
   validates_length_of :description, minimum: 10
   
 #######################################################################
-#
+# Will return all top level menu items of specified menu. Used in DcPage document for
+# selecting top level selected menu, when document displayed in browser.
+# 
+# Called from DcApplicationHelper :dc_choices4_menu: method.
+# 
+# Parameters: 
+# [Site] DcSite document. Site for which menu belongs to. If site is not specified 
+# all current menus in collection will be returned.
+# 
+# Returns:
+# Array. Of choices prepared for select input field.
 #######################################################################
   def self.choices4_menu(site)
   rez = []
@@ -48,7 +64,6 @@ class DcSimpleMenu
   menus.each do |menu|
     rez << [menu.name, nil]
     menu.dc_simple_menu_items.where(active: true).order_by(:order => 1).each do |menu_item|
-#      next unless menu_item.active
       rez << ['-- ' + menu_item.caption, menu_item._id]
     end
   end

data/app/models/dc_simple_menu_item.rb

@@ -20,6 +20,24 @@
 # OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
 # WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 #++
+
+########################################################################
+# Mongoid::Document model for dc_simple_menu_items embedded documents. 
+# 
+# DcMenuItem documents are embedded in the DcSimpleMenu document and define top
+# level item of menu system. Submenus are simply defined as YAML text in the submenu field.
+# 
+# Submenu example: 
+#    1:
+#      title: Zadnja številka
+#      link: /zadnjastevilka
+#    2:
+#      title: Arhiv
+#      link: /arhivrevij
+#    3:
+#      title: Naročam
+#      link: /clanek/podjetnik-narocilnica
+########################################################################
 class DcSimpleMenuItem
   include Mongoid::Document
   include Mongoid::Timestamps
@@ -30,10 +48,10 @@ class DcSimpleMenuItem
   field :target,    type: String
   field :order,     type: Integer, default: 10
   field :submenu,   type: String
+  field :policy_id, type: BSON::ObjectId
   field :css,       type: String
+
   field :active,    type: Boolean, default: true 
-  field :policy_id, type: BSON::ObjectId
 
   embedded_in :dc_simple_menu
-  
 end

data/app/models/dc_site.rb

@@ -21,7 +21,10 @@
 # WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 #++
 
-module DcSiteCommon
+#########################################################################
+# ActiveSupport::Concern definition for DcSite class. 
+#########################################################################
+module DcSiteConcern
 extend ActiveSupport::Concern
 included do
   include Mongoid::Document
@@ -85,8 +88,15 @@ end
 
 
 ######################################################################
-#
+# Mongoid::Document model for dc_sites collection.
+# 
+# Since DRG CMS can handle multiple sites on single ROR instance, every document
+# in dc_sites collection defines data which defines a site. 
+# 
+# Sites can be aliased which is very usefull in development and test environment. 
+# If 'site.name' document is not found application will search for 'test' document and
+# continue searching with value found in alias_for field. 
 ######################################################################
 class DcSite
-  include DcSiteCommon
+  include DcSiteConcern
 end

data/app/models/dc_stat.rb

@@ -20,7 +20,14 @@
 # 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 DcStat
+
+########################################################################
+# Mongoid::Document model for dc_stat documents.
+# 
+# 
+########################################################################
+
+class DcStat #:nodoc:
   include Mongoid::Document
   include Mongoid::Timestamps
   

data/app/models/dc_user.rb

@@ -21,7 +21,10 @@
 # WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 #++
 
-module DcUserCommon
+#########################################################################
+# ActiveSupport::Concern definition for DcUser class. 
+#########################################################################
+module DcUserConcern
 extend ActiveSupport::Concern
 included do
 
@@ -76,6 +79,9 @@ index 'members' => 1
 validates_length_of :username, minimum: 4
 before_save :do_before_save
 
+##########################################################################
+# before_save callback takes care of name field and ensures that e-mail is unique 
+# when entry is left empty. 
 ##########################################################################
 def do_before_save
   self.name  = "#{self.title} #{self.first_name} #{self.middle_name + ' ' unless self.middle_name.blank?}#{self.last_name}".strip
@@ -86,6 +92,16 @@ end
 end
 end
 
+########################################################################
+# Mongoid::Document model for dc_user documents.
+# 
+# dc_users collection holds data about regitered users. Passwords are encrypted
+# with bcrypt gem. 
+# 
+# This model defines basic fields required for evidence of
+# registerred users. Since it is implemented as ActiveSupport::Concern you are
+# encouraged to further expand model with your own data structures.
+########################################################################
 class DcUser
-  include DcUserCommon
+  include DcUserConcern
 end

data/app/models/dc_user_role.rb

@@ -21,11 +21,18 @@
 # WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 #++
 
+########################################################################
+# Mongoid::Document model for dc_user_role embedded documents.
+# 
+# DcUserRole documents are embedded in DcUser model and define user roles which
+# belong to user.
+########################################################################
 class DcUserRole
   include Mongoid::Document
   include Mongoid::Timestamps
 
   belongs_to :dc_policy_role
+  
   field   :valid_from,        type: Date
   field   :valid_to,          type: Date
   field   :active,            type: Boolean, default: true

data/app/models/dc_visit.rb

@@ -21,6 +21,11 @@
 # WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 #++
 
+######################################################################
+# Mongoid::Document model for dc_visit collection.
+# 
+# DcVisit documents are used to record visits to web site.
+######################################################################
 class DcVisit
   include Mongoid::Document
   

data/app/{helpers → models}/drgcms_form_field.rb

@@ -20,14 +20,60 @@
 # OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
 # WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 #++
+
+###########################################################################
+# DrgcmsFormField module contains definitions of classes used for 
+# rendering data entry fields on DRG CMS forms. 
+# 
+# Every data entry field type written in lowercase in form must have its class 
+# defined in CamelCase in DrgcmsFormField module. 
+# 
+# Each class must have at least render method implemented. All classes can
+# inherit from DrgcmsField class which acts as abstract template class and implements 
+# most of surrounding code.
+# 
+# Render method must create html and javascript code which must be
+# saved to internal @html and @js variables. Field code is then retrived by accessing
+# these two internal variables.
+# 
+# Example. How the field code is generated in form renderer:
+#    klas_string = yaml['type'].camelize
+#    if DrgcmsFormField.const_defined?(klas_string) # check if field type class is defined
+#      klas = DrgcmsFormField.const_get(klas_string)
+#      field = klas.new(self, @record, options).render
+#      javascript << field.js
+#      html << field.html 
+#    end
+# 
+# Example. How to mix DRG CMS field code in Rails views:
+#    <div>User:
+#    <%= 
+#      opts = {'name' => 'user', 'eval' => "dc_choices4('dc_user','name')", 
+#              'html' => { 'include_blank' => true } }
+#      dt = DrgcmsFormField::Select.new(self, {}, opts).render
+#      (dt.html + javascript_tag(dt.js)).html_safe
+#     %></div> 
+###########################################################################
 module DrgcmsFormField
 
 ###########################################################################
-#
+# Template method for DRG CMS form field definition. This is abstract class with
+# most of the common code already implemented.
 ###########################################################################
 class DrgcmsField
 attr_reader :html, :js
 
+####################################################################
+# DrgcmsField initialization code.
+# 
+# Parameters:
+# [parent] Controller object. Controller object from where object is created. Usually self is send. 
+# [record] Document object. Document object which holds fields data.
+# [yaml] Hash. Hash object holding field definition data.
+# 
+# Returns: 
+# Self
+####################################################################
 def initialize( parent, record, yaml )
   @parent = parent
   @record = record
@@ -40,7 +86,18 @@ def initialize( parent, record, yaml )
 end
 
 ####################################################################
-# Wrapper for i18 t method, with some spice added
+# Wrapper for i18 t method, with some spice added. If translation is not found English
+# translation value will be returned. And if still not found default value will be returned if passed.
+# 
+# Parameters:
+# [key] String. String to be translated into locale.
+# [default] String. Value returned if translation is not found.
+# 
+# Example:
+#    t('translate.this','Enter text for ....')
+# 
+# Returns: 
+# String. Translated text. 
 ####################################################################
 def t(key, default='')
   c = I18n.t(key)
@@ -53,18 +110,16 @@ def t(key, default='')
 end
 
 ####################################################################
-# Standard code for return on readonly field
+# Standard code for returning readonly field.
 ####################################################################
 def ro_standard(value=nil)
-#  @html << "<span class='dc-readonly'>#{@record[@yaml['name']]}</span>" if @record.respond_to?(@yaml['name'])
   value = @record[@yaml['name']] if value.nil? and @record.respond_to?(@yaml['name']) 
   @html << "<table class='dc-readonly'><td>#{value}</td></table>"
   self
 end
 
 ####################################################################
-# Set value of the field when value is defined by params. Fields may be
-# intialized by setting params with name of the field preceding by p_.
+# Set initial value of the field when initial value is set in url parameters..
 # 
 # Example: Form has field named picture. Field can be initialized by 
 # setting value of param p_picture.
@@ -76,8 +131,23 @@ def set_initial_value(opt1='html', opt2='value')
 end
 
 ####################################################################
-# Will return ruby hash formated as javascript hash which can be used
+# Will return ruby hash formated as javascript string which can be used
 # for passing parameters in javascript code.
+# 
+# Parameters:
+# [Hash] Hash. Ruby hash parameters.
+# 
+# Example: As used in forms
+#    options:
+#      height: 400
+#      width: 800
+#      toolbar: "'basic'"
+#      
+#  => "height:400, width:800, toolbar:'basic'"
+# 
+# Return: 
+# String: Options formated as javascript options.
+#      
 ####################################################################
 def hash_to_options(hash)
   options = hash.to_a.inject('') do |r,v|
@@ -87,8 +157,15 @@ def hash_to_options(hash)
 end
 
 ###########################################################################
-# Default get_data method for retrieving data from object on the form into 
-# record to be saved.
+# Default get_data method for retrieving data from parameters. Class method is called 
+# for every entry field defined on form before field value is saved to database.
+# 
+# Parameters:
+# [params] Controllers params object.
+# [name] Field name
+# 
+# Most of classes will use this default method which returns params['record'][name]. 
+# When field data is more complex class should implement its own get_data method. 
 ###########################################################################
 def self.get_data(params, name)
   params['record'][name]
@@ -97,10 +174,15 @@ end
 end
 
 ###########################################################################
-# Create form field for displaying difference between two fields in journal
+# Implementation of readonly DRG CMS form field. 
+# 
+# Readonly field value is just painted on form.
 ###########################################################################
 class Readonly < DrgcmsField
-def render
+###########################################################################
+# Render readonly field html code
+###########################################################################
+def render 
   @html << @parent.hidden_field('record', @yaml['name']) # retain field as hidden field
   @html << '<table class="dc-readonly"><td>'
   
@@ -120,10 +202,15 @@ end
 end
 
 ###########################################################################
-# Dummy HiddenField class so everything works as expected
+# Implementation of hidden DRG CMS form field.
+# 
+# Will create hidden_field on form.
 ###########################################################################
 class HiddenField < DrgcmsField
-def render
+###########################################################################
+# Render hidden_field field html code
+###########################################################################
+def render 
   set_initial_value
   value = @yaml['html']['value'] ? @yaml['html']['value'] : @record[@yaml['name']]
   @parent.hidden_field('record', @yaml['name'], value: value)
@@ -131,22 +218,24 @@ end
 end
 
 ###########################################################################
-# Creates html required to paint embedded object on input form.
+# Implementation of embedded DRG CMS form field.
+#
+# Creates html required to paint embedded object on form.
 ###########################################################################
 class Embedded < DrgcmsField
-
-def render
+###########################################################################
+# Render embedded field html code
+###########################################################################
+def render 
   return self if @record.new_record?  # would be in error
 # HTML defaults. Some must be set    
   @yaml['html'] ||= {}
   @yaml['html']['height'] ||= 300
   @yaml['html']['width']  ||= '99%'
 # defaults both way 
-#  p '**********************'
-#  p [@yaml['table'],@yaml['formname']]
   @yaml['table']    ||= @yaml['formname'] if @yaml['formname']
   @yaml['formname'] ||= @yaml['table'] if @yaml['table']
-#  p [@yaml['table'],@yaml['formname']]
+# 
   html = ''  
   @yaml['html'].each {|k,v| html << "#{k}=\"#{v}\" "}
 #  
@@ -166,16 +255,15 @@ end
 end
 
 ###########################################################################
-# Alias for Embedded. EmbeddedIframe will be deprecated.
+# Implementation of journal_diff DRG CMS form field.
+# 
+# journal_diff field is used to show differences between two fields in DcJournal collection.
 ###########################################################################
-class EmbeddedIframe < Embedded 
-end
-
+class JournalDiff < DrgcmsField
 ###########################################################################
-# Create form field for displaying difference between two fields in journal
+# Render journal_diff field html code
 ###########################################################################
-class JournalDiff < DrgcmsField
-def render
+def render 
   @yaml['name'] = 'old' if @record[@yaml['name']].nil?
   @html << '<table width="99%">'
   JSON.parse(@record[@yaml['name']]).each do |k,v|
@@ -189,12 +277,15 @@ end
 end
 
 ###########################################################################
-# Create form field for multitext_autocomplete
+# Implementation of multitext_autocomplete DRG CMS form field.
+# 
+# multitext_autocomplete field is complex data entry field which uses autocomplete
+# function when selecting multiple values for Array MongoDB field.
 ###########################################################################
 class MultitextAutocomplete < DrgcmsField
 
 ###########################################################################
-# returns value for readonly field
+# Returns value for readonly field
 ###########################################################################
 def ro_standard(table, search)
   result = ''
@@ -207,9 +298,9 @@ def ro_standard(table, search)
 end
 
 ###########################################################################
-# 
+# Render multitext_autocomplete field html code
 ###########################################################################
-def render
+def render 
 # search field name
   if @yaml['search'].match(/\./)
     table, search = @yaml['search'].split('.') 
@@ -304,7 +395,7 @@ EOJS
 end
 
 ###########################################################################
-# Method for retrieving data from multitext_autocomplete form field.
+# Class method for retrieving data from multitext_autocomplete form field.
 ###########################################################################
 def self.get_data(params, name)
   r = []
@@ -319,12 +410,12 @@ end
 end
   
 ###########################################################################
-# Create form field for select
+# Implementation of select DRG CMS form field.
 ###########################################################################
 class Select < DrgcmsField
   
 ###########################################################################
-# Return values, when choices options will be returned by avaluating expression
+# Return values, when choices options will be returned by evaluating expression
 ###########################################################################
 def do_eval(e)
   e.strip!
@@ -336,7 +427,7 @@ def do_eval(e)
 end
   
 ###########################################################################
-# Return choices array for fields with choices
+# Crete choices array for select field.
 ###########################################################################
 def get_choices
   begin
@@ -359,7 +450,7 @@ def get_choices
 end
 
 ###########################################################################
-# Return value only when readonly is required
+# Return value when readonly is required
 ###########################################################################
 def ro_standard
   value = @record.respond_to?(@yaml['name']) ? @record[@yaml['name']] : nil
@@ -376,7 +467,7 @@ def ro_standard
 end
 
 ###########################################################################
-#
+# Render select field html code
 ###########################################################################
 def render
   return ro_standard if @readonly
@@ -390,12 +481,12 @@ end
 end
 
 ###########################################################################
-# Create form field for select
+# Implementation of check_box DRG CMS form field.
 ###########################################################################
 class CheckBox < DrgcmsField
   
 ###########################################################################
-#
+# Render check_box field html code
 ###########################################################################
 def render
   set_initial_value('html','default')
@@ -416,12 +507,12 @@ end
 end
 
 ###########################################################################
-# Create comment form field
+# Implementation of comment DRG CMS form field.
 ###########################################################################
 class Comment < DrgcmsField
   
 ###########################################################################
-#
+# Render comment field html code
 ###########################################################################
 def render
   @html << @yaml['text']
@@ -430,16 +521,16 @@ end
 end
 
 ###########################################################################
-# Create link_to form field
+# Implementation of link_to DRG CMS form field.
 ###########################################################################
 class LinkTo < DrgcmsField
   
 ###########################################################################
-#
+# Render link_to field html code
 ###########################################################################
 def render
   @yaml['html'] ||= {}
-  @yaml['html']['class'] ||= 'dc-submit'
+  @yaml['html']['class'] ||= 'dc-link dc-animate'
   @yaml['html'].symbolize_keys!
 #
   url = @yaml['url'] || "#{@yaml[:controller]}/#{@yaml[:action]}/#{@yaml[:id]}"
@@ -447,7 +538,8 @@ def render
   url = '/' + @yaml['url'] unless url[0,1] == '/' # no leading /
   url.chop if url[0,-1] == '/'                    # remove trailing /
 #
-  @html << @parent.link_to(@yaml['text'], url, @yaml['html'])
+  caption = @yaml['caption'] || @yaml['text']
+  @html << @parent.link_to(caption, url, @yaml['html'])
   self
 end
 end
@@ -458,7 +550,7 @@ end
 class SubmitTag < DrgcmsField
   
 ###########################################################################
-#
+# Render submit_tag field html code
 ###########################################################################
 def render
   @yaml['html'] ||= {}
@@ -473,12 +565,12 @@ end
 end
 
 ###########################################################################
-# Create Password form field
+# Implementation of password DRG CMS form field.
 ###########################################################################
 class PasswordField < DrgcmsField
   
 ###########################################################################
-#
+# Render password field html code
 ###########################################################################
 def render
   return self if @readonly
@@ -489,12 +581,12 @@ end
 end
 
 ###########################################################################
-# Create date_select form field
+# Implementation of date_select DRG CMS form field.
 ###########################################################################
 class DateSelect < DrgcmsField
    
 ###########################################################################
-#
+# Render date_select field html code
 ###########################################################################
 def render
 #  return ro_standard if @readonly
@@ -510,7 +602,7 @@ def render
 end
 
 ####################################################################
-# Get data for DateTime field
+# Get data for DateSelect field
 # According to  https://gist.github.com/315227
 ####################################################################
 def self.get_data(params, name)
@@ -521,7 +613,7 @@ def self.get_data(params, name)
   end.compact.sort_by(&:first).map(&:last)
 # Return nil if error
   begin
-    Time.zone.local(*attrs) unless attrs.empty?
+    Time.zone.local(*attrs) #unless attrs.empty?
   rescue 
     nil
   end
@@ -530,12 +622,12 @@ end
 end
 
 ###########################################################################
-# Create date_select form field
+# Create datetime_select form field
 ###########################################################################
 class DatetimeSelect < DrgcmsField
   
 ###########################################################################
-#
+# Render datetime_select field html code
 ###########################################################################
 def render
   return ro_standard( @parent.dc_format_value(@record[@yaml['name']])) if @readonly
@@ -550,7 +642,7 @@ def render
 end
 
 ###########################################################################
-#
+# DatetimeSelect get_data method.
 ###########################################################################
 def self.get_data(params, name)
   DateSelect.get_data(params, name)
@@ -559,12 +651,12 @@ end
 end
 
 ###########################################################################
-# Create datetime_picker form field
+# Implementation of date_picker DRG CMS form field.
 ###########################################################################
 class DatePicker < DrgcmsField
   
 ###########################################################################
-#
+# Render date_picker field html code
 ###########################################################################
 def render
 #  return ro_standard if @readonly
@@ -592,7 +684,7 @@ EOJS
 end
 
 ###########################################################################
-#
+# DatePicker get_data method.
 ###########################################################################
 def self.get_data(params, name)
   t = params['record'][name].to_datetime 
@@ -601,12 +693,12 @@ end
 
 end
 ###########################################################################
-# Create datetime_picker form field
+# Implementation of date_time_picker DRG CMS form field.
 ###########################################################################
 class DatetimePicker < DrgcmsField
   
 ###########################################################################
-#
+# Render date_time_picker field html code
 ###########################################################################
 def render
 #  return ro_standard if @readonly
@@ -633,7 +725,7 @@ EOJS
 end
 
 ###########################################################################
-#
+# DateTimePicker get_data method.
 ###########################################################################
 def self.get_data(params, name)
   t = params['record'][name].to_datetime 
@@ -643,12 +735,12 @@ end
 end
 
 ###########################################################################
-# Create text_autocomplete form field
+# Implementation of text_autocomplete DRG CMS form field.
 ###########################################################################
 class TextAutocomplete < DrgcmsField
   
 ###########################################################################
-#
+# Render text_autocomplete field html code
 ###########################################################################
 def render
 # Return descriptive text and put it into input field
@@ -735,12 +827,12 @@ end
 end
 
 ###########################################################################
-# Create text_area form field
+# Implementation of text_area DRG CMS form field.
 ###########################################################################
 class TextArea < DrgcmsField
   
 ###########################################################################
-#
+# Render text_area field html code
 ###########################################################################
 def render
   return ro_standard if @readonly
@@ -754,12 +846,12 @@ end
 end
 
 ###########################################################################
-# Create text_field form field
+# Implementation of text_field DRG CMS form field.
 ###########################################################################
 class TextField < DrgcmsField
   
 ###########################################################################
-#
+# Render text_field field html code
 ###########################################################################
 def render
   return ro_standard if @readonly
@@ -771,12 +863,14 @@ end
 end
 
 ###########################################################################
-# Create text_field plus select with optional values for the field
+# Implementation of text_with_select DRG CMS form field.
+# 
+# Create text_field with select dropdown box with optional values for the field
 ###########################################################################
 class TextWithSelect < Select
 
 ###########################################################################
-# 
+# Render text_with_select field html code
 ###########################################################################
 def render
   return ro_standard if @readonly  
@@ -803,16 +897,16 @@ end
 end
 
 ###########################################################################
-# Create html_field form field
+# Implementation of html_field DRG CMS form field.
 # 
-# Class implements redirection for calling actual edit field code.
+# HtmlField class implements redirection for calling actual html edit field code.
 # This can be drg_default_html_editor's ckeditor or any other code defined
 # by dc_site.settings html_editor setting.
 ###########################################################################
 class HtmlField < DrgcmsField
 
 ###########################################################################
-# 
+# Render html_field field html code
 ###########################################################################
 def render
   return ro_standard if @readonly  
@@ -834,12 +928,16 @@ end
 end
 
 ###########################################################################
-# Create text_field plus select with optional values for the field
+# Implementation of file_select DRG CMS form field.
+# 
+# FileSelect like HtmlField implements redirection for calling document manager edit field code.
+# This can be drg_default_html_editor's elfinder or any other code defined
+# by dc_site.settings file_select setting.
 ###########################################################################
 class FileSelect < DrgcmsField
 
 ###########################################################################
-# 
+# Render file_select field html code
 ###########################################################################
 def render
   return ro_standard if @readonly