agile_rails 0.0.0.1

data/app/models/agile_form_fields/html_field.rb

@@ -0,0 +1,69 @@
+#--
+# Copyright (c) 2024+ Damjan Rems
+#
+# Permission is hereby granted, free of charge, to any person obtaining
+# a copy of this software and associated documentation files (the
+# "Software"), to deal in the Software without restriction, including
+# without limitation the rights to use, copy, modify, merge, publish,
+# distribute, sublicense, and/or sell copies of the Software, and to
+# permit persons to whom the Software is furnished to do so, subject to
+# the following conditions:
+#
+# The above copyright notice and this permission notice shall be
+# included in all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+# MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+# NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+# LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+# OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+# WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+#+
+module AgileFormFields
+
+###########################################################################
+# Implementation of html_field AgileRails form field. 
+# 
+# HtmlField class only implements code for calling actual html edit field code.
+# This is by default agile_rails_html_editor gem which uses CK editor javascript plugin 
+# or any other plugin. Which plugin will be used as html editor is defined by 
+# ar_site.settings html_editor setting.
+# 
+# Example of ar_site.setting used for agile_rails_html_editor gem.
+#    html_editor: ckeditor
+#    ck_editor:
+#      config_file: /files/ck_config.js  
+#      css_file: /files/ck_css.css
+#   file_select: elfinder
+#   
+# Form example:
+#    10:
+#      name: body
+#      type: html_field
+#      options: "height: 500, width: 550, toolbar: 'basic'" 
+###########################################################################
+class HtmlField < AgileFormField
+
+###########################################################################
+# Render html_field AgileRails form field code
+###########################################################################
+def render
+  # html editor is defined on site params
+  editor_string = @env.agile_get_site.params['html_editor'] if @env.agile_get_site
+  editor_string ||= 'ckeditor'
+
+  klas_string = editor_string.camelize
+  if AgileFormFields.const_defined?(klas_string)
+    klas = AgileFormFields::const_get(klas_string)
+    o = klas.new(@env, @record, @yaml).render
+    @js += o.js
+    @html += o.html
+  else
+    @html += 'HTML editor not defined. Check site.settings or include agile_rails_html_editor gem.'
+  end
+  self
+end
+
+end
+end

data/app/models/agile_form_fields/journal_diff.rb

@@ -0,0 +1,62 @@
+#--
+# Copyright (c) 2024+ Damjan Rems
+#
+# Permission is hereby granted, free of charge, to any person obtaining
+# a copy of this software and associated documentation files (the
+# "Software"), to deal in the Software without restriction, including
+# without limitation the rights to use, copy, modify, merge, publish,
+# distribute, sublicense, and/or sell copies of the Software, and to
+# permit persons to whom the Software is furnished to do so, subject to
+# the following conditions:
+#
+# The above copyright notice and this permission notice shall be
+# included in all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+# MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+# NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+# LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+# OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+# WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+#+
+module AgileFormFields
+
+###########################################################################
+# Implementation of journal_diff AgileRails form field. journal_diff field is used to 
+# show differences between two fields in ArJournal collection.
+#
+# Internal use.
+#
+# ===Form options:
+# * +name:+ field name (required)
+# * +type:+ journal_diff (required)
+# 
+# Form example:
+#    10:
+#      name: diff
+#      type: journal_diff
+#      html:
+#        size: 100x25
+###########################################################################
+class JournalDiff < AgileFormField
+
+###########################################################################
+# Render journal_diff AgileRails form field code
+###########################################################################
+def render 
+  @yaml['name'] = 'old' if @record[@yaml['name']].nil?
+  @html += '<div class="ar-journal">'
+  JSON.parse(@record[@yaml['name']]).each do |k, v|
+    old_value = v.class == Array ? v[0] : v
+    new_value = v.class == Array ? v[1] : v
+    @html += %(<div class="field">#{@env.check_box('select', k)} #{k}</div>
+               <div class="diff-m">#{@env.mi_icon('remove red')}<div>#{old_value}</div></div>
+               <div class="diff-p">#{@env.mi_icon('add green')}<div>#{new_value}</div></div>)
+  end
+  @html += '</div>'
+  self
+end
+end
+
+end

data/app/models/agile_form_fields/link_to.rb

@@ -0,0 +1,69 @@
+#--
+# Copyright (c) 2024+ Damjan Rems
+#
+# Permission is hereby granted, free of charge, to any person obtaining
+# a copy of this software and associated documentation files (the
+# "Software"), to deal in the Software without restriction, including
+# without limitation the rights to use, copy, modify, merge, publish,
+# distribute, sublicense, and/or sell copies of the Software, and to
+# permit persons to whom the Software is furnished to do so, subject to
+# the following conditions:
+#
+# The above copyright notice and this permission notice shall be
+# included in all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+# MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+# NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+# LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+# OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+# WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+#+
+module AgileFormFields
+
+###########################################################################
+# Implementation of link_to AgileRails form field. link_to form field is mostly used by polls but can
+# be also incorporated anywhere on the form.
+# 
+# ===Form options:
+# * +type:+ link_to (required)
+# * +caption:+ Link caption 
+# * +icon:+ Link icon
+# * +url:+ direct url link
+# * +controller:+ controller name
+# * +action:+ action name 
+# * +html:+ html options which apply to link_to (optional)
+#      
+# Form example:
+#    30:
+#      type: link_to
+#      caption: Some action
+#      icon: cogs
+#      controller: my_controller
+#      action: my_action
+#      id: id # will be replaced by record.id
+###########################################################################
+class LinkTo < AgileFormField
+  
+###########################################################################
+# Render link_to AgileRails form field code
+###########################################################################
+def render
+  @yaml['html'] ||= {}
+  @yaml['html']['class'] ||= 'ar-link'
+  @yaml['html'].symbolize_keys!
+
+  @yaml[:id] = record.id if @yaml[:id] == 'id'
+  url = @yaml['url'] || "#{@yaml[:controller]}/#{@yaml[:action]}/#{@yaml[:id]}"
+  url.gsub!('//','/')                             # no action and id
+  url = '/' + @yaml['url'] unless url[0,1] == '/' # no leading /
+  url.chop if url[0,-1] == '/'                    # remove trailing /
+
+  caption = @yaml['caption'] || @yaml['text']
+  @html += @env.agile_link_to(caption, @yaml['icon'], url, @yaml['html'])
+  self
+end
+end
+
+end

data/app/models/agile_form_fields/method.rb

@@ -0,0 +1,66 @@
+#--
+# Copyright (c) 2024+ Damjan Rems
+#
+# Permission is hereby granted, free of charge, to any person obtaining
+# a copy of this software and associated documentation files (the
+# "Software"), to deal in the Software without restriction, including
+# without limitation the rights to use, copy, modify, merge, publish,
+# distribute, sublicense, and/or sell copies of the Software, and to
+# permit persons to whom the Software is furnished to do so, subject to
+# the following conditions:
+#
+# The above copyright notice and this permission notice shall be
+# included in all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+# MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+# NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+# LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+# OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+# WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+#+
+module AgileFormFields
+
+###########################################################################
+# Implementation of custom AgileRails form field. Method field will call method or class method
+# defined in eval option and add returned code to HTML output code.
+#
+# It can be used in case when form contains complex data structure. For example set of pictures which can not
+# be simply displayed by any other AgileRails Forms field.
+#   
+# Form example:
+#    50:
+#      name: galery
+#      type: method
+#      eval: show_gallery
+#      or
+#      eval: MyClass.show_gallery
+#      
+###########################################################################
+class Method < AgileFormField
+
+###########################################################################
+# Render file_select AgileRails form field code
+###########################################################################
+def render
+  # might be defined as my_method or MyClass.my_method
+  clas, method = @yaml['eval'].split(/\.|\,/).map(&:strip)
+  if method.nil?
+    if @env.respond_to?(clas)
+      @html += @env.send(clas, @record, @yaml, @readonly)
+      return self
+    end
+  else
+    klass = clas.camelize.constantize
+    if klass.respond_to?(method)
+      @html += klass.send(method, @record, @yaml, @readonly)
+      return self
+    end
+  end   
+  @html += "Error: #{@yaml['name']} : #{@yaml['eval']} not defined!"
+  self
+end
+
+end
+end

data/app/models/agile_form_fields/multitext_autocomplete.rb

@@ -0,0 +1,215 @@
+#--
+# Copyright (c) 2024+ Damjan Rems
+#
+# Permission is hereby granted, free of charge, to any person obtaining
+# a copy of this software and associated documentation files (the
+# "Software"), to deal in the Software without restriction, including
+# without limitation the rights to use, copy, modify, merge, publish,
+# distribute, sublicense, and/or sell copies of the Software, and to
+# permit persons to whom the Software is furnished to do so, subject to
+# the following conditions:
+#
+# The above copyright notice and this permission notice shall be
+# included in all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+# MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+# NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+# LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+# OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+# WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+#+
+module AgileFormFields
+
+###########################################################################
+# Implementation of multitext_autocomplete AgileRails Form field.
+# 
+# multitext_autocomplete field is complex data entry field which uses autocomplete
+# function when selecting multiple values for MongoDB Array field. Array typically holds
+#  id's of selected documents and control typically displays value of the field name 
+# defined by search options.
+# 
+# ===Form options:
+# * +name:+ field name (required)
+# * +type:+ multitext_autocomplete (required)
+# * +table+ Model (table) name which must contain searched field name.
+# * +search:+ Search may consist of three parameters from which are separated either by dot (.) or comma(,)
+#   * search_field_name; when table option is defined search must define field name which will be used for search query
+#   * collection_name.search_field_name; Same as above except that table options must be ommited.
+#   * collection_name.search_field_name.method_name; When searching is more complex custom search
+#   method may be defined in CollectionName model which will provide dataset for search.
+# * +with_new+ Will add an icon for shortcut to add new document to collection
+#      
+# Form example:
+#      90:
+#        name: kats
+#        type: multitext_autocomplete
+#        search: ar_category.name
+#        with_new: model_name
+#        size: 30
+###########################################################################
+class MultitextAutocomplete < AgileFormField
+
+###########################################################################
+# Returns value for readonly field
+###########################################################################
+def ro_standard(table, search)
+  current_values = @record.send(@yaml['name'])
+  return self if current_values.blank?
+
+  table  = table.classify.constantize
+  search = search.split(/\.|\,/).first if search.match(/\.|\,/)
+  html   = current_values.map { |element| table.find(element)[search] + '<br>' }.join
+  super(html)
+end
+
+###########################################################################
+# Render multitext_autocomplete AgileRails form field code
+###########################################################################
+def render
+  # get field name
+  if @yaml['search'].class.to_s == 'Hash'
+    #if @yaml['search'].kind_of?(Hash)
+    table      = @yaml['search']['table']
+    field_name = @yaml['search']['field']
+    method     = @yaml['search']['method']
+    search     = method.nil? ? field_name : "#{field_name}.#{method}"
+  elsif @yaml['search'].to_s.match(/[.,]/)
+    table, field_name, method = @yaml['search'].split(/[.,]/).map(&:strip)
+    search = method.nil? ? field_name : "#{field_name}.#{method}"
+  else # search and table name are separated
+    search = field_name = @yaml['search']
+  end
+  # get table name
+  if @yaml['table']
+    table = if @yaml['table'].class == String
+              @yaml['table']
+              # eval(how_to_get_my_table_name)
+            elsif @yaml['table']['eval']
+              eval @yaml['table']['eval']
+            else
+              Rails.logger.error "Field #{@yaml['name']}: Invalid table parameter!"
+              nil
+            end
+  end
+
+  if table.blank? || search.blank?
+    @html += 'Table or search field not defined!'
+    return self
+  end
+
+  # does collection exists
+  collection = table.classify.constantize rescue nil
+  if collection.nil?
+    @html += "Invalid table name: #{table}"
+    return self
+  end
+
+  # does field exists
+  unless @record.respond_to?(@yaml['name'])
+    @html += "Invalid field name: #{@yaml['name']}"
+    return self
+  end
+
+  # search data entry
+  @yaml['html'] ||= {}
+  @yaml['html']['value'] = ''   # must be. Otherwise it will look into record and return error
+  @yaml['html']['placeholder'] = t('agile.search_placeholder')
+  _name = '_' + @yaml['name']
+  @html += '<div class="ui-autocomplete-border">'
+  @html += @env.link_to(@env.mi_icon('plus-square-o green'), '#', onclick: 'return false;') # dummy add. But it is useful.
+
+  # text_field for autocomplete
+  record = record_text_for(@yaml['name'])
+  @html += '<span class="ar-text-autocomplete">' + @env.text_field(record, _name, @yaml['html']) + '<span></span></span>'
+
+  # link for adding new documents to searched collection
+  if @yaml['with_new'] && !@readonly
+    @html += ' ' +
+      @env.mi_icon('plus-square-o', class: 'in-edit-add', title: t('agile.new'),
+                    style: "vertical-align: top;", 'data-table' => @yaml['with_new'] )
+  end
+
+  # div to list active selections
+  @html += %(<div id ="#{record}#{@yaml['name']}">)
+  # fill with current values
+  current_values = @record.send(@yaml['name'])
+  unless current_values.nil?
+    current_values.each do |element|
+      # this is quick and dirty trick. We have model ar_big_table which can be used for retrive
+      # more complicated options
+      # TODO retrieve choices from big_table
+      rec = if table == 'ar_big_table'
+              collection.find(@yaml['name'], @env.session)
+            else
+              collection.find(element)
+            end
+
+      @html += if rec
+                 link  = @env.link_to(@env.mi_icon('remove_circle red'), '#',
+                                      onclick: %($('##{rec.id}').hide(); let v = $('##{record}_#{@yaml['name']}_#{rec.id}'); v.val("-" + v.val());return false;))
+                 link  = @env.mi_icon('check green') if @readonly
+                 field = @env.hidden_field(record, "#{@yaml['name']}_#{rec.id}", value: element)
+                 %(<div id="#{rec.id}" style="padding:4px;">#{link} #{rec.send(field_name)}<br>#{field}</div>)
+               else
+                 '** error **'  # Related data is missing. It happends.
+               end
+    end
+  end
+  @html += "</div></div>"
+
+  # Create text for new div when new category is added
+  link    = @env.link_to(@env.mi_icon('remove_circle red'), '#',
+            onclick: %($('#rec_id').hide(); let v = $('##{record}_#{@yaml['name']}_rec_id'); v.val("-" + v.val());return false;"))
+  field   = @env.hidden_field(record, "#{@yaml['name']}_rec_id", value: 'rec_id')
+  one_div = %(<div id="rec_id" style="padding:4px;">#{link} rec_search<br>#{field}</div>)
+
+# JS stuff    
+  @js += <<EOJS
+$(document).ready(function() {
+  $("##{record}_#{_name}").autocomplete( {
+    source: function(request, response) {
+      $.ajax({
+        url: "#{ @env.url_for( controller: 'agile_common', action: 'autocomplete' )}",
+        type: "POST",
+        dataType: "json",
+        data: { input: request.term, table: "#{table}", search: "#{search}" #{(',id: "' + @yaml['id'] + '"') if @yaml['id']} },
+        success: function(data) {
+          response( $.map( data, function(key) {
+            return key;
+          }));
+        }
+      });
+    },
+    change: function (event, ui) { 
+      let div = '#{one_div}';
+      div = div.replace(/rec_id/g, ui.item.id)
+      div = div.replace('rec_search', ui.item.value)
+      $("##{record}#{@yaml['name']}").append(div);
+      $("##{record}_#{_name}").val('');
+      $("##{record}_#{_name}").focus();
+    },
+    minLength: 2
+  });
+});
+EOJS
+
+  self 
+end
+
+###########################################################################
+# Class method for retrieving data from multitext_autocomplete form field.
+###########################################################################
+def self.get_data(params, name)
+  r = []
+  params['record'].each do |k, v|
+    # if it starts with - then it was removed
+    r << v if k.match("#{name}_") && v[0] != '-'
+    r
+  end
+  r.uniq
+end
+
+end
+end

data/app/models/agile_form_fields/number_field.rb

@@ -0,0 +1,92 @@
+#--
+# Copyright (c) 2024+ Damjan Rems
+#
+# Permission is hereby granted, free of charge, to any person obtaining
+# a copy of this software and associated documentation files (the
+# "Software"), to deal in the Software without restriction, including
+# without limitation the rights to use, copy, modify, merge, publish,
+# distribute, sublicense, and/or sell copies of the Software, and to
+# permit persons to whom the Software is furnished to do so, subject to
+# the following conditions:
+#
+# The above copyright notice and this permission notice shall be
+# included in all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+# MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+# NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+# LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+# OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+# WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+#+
+module AgileFormFields
+
+###########################################################################
+# Implementation of number_field AgileRails form field. Number fields can be 
+# formated for display with thousands delimiters and decimal separators and 
+# can have currency symbol.
+# 
+# ===Form options:
+# * +type:+ number_field (required)
+# * +name:+ Field name (required) 
+# * +format:+ Format options
+# *   +decimals:+ No of decimal places
+# *   +separator:+ decimal separator (yes no , .) Default yes if decimals > 0
+# *   +delimiter:+ Thousands delimiter (yes no , .) Default defind by locals
+# *   +currency:+ Currency sign (yes no sign) Default no. If yes defined by locals
+# * +html:+ html options which apply to text_field field (optional)
+# 
+# Form example:
+#    10:
+#      name: title
+#      type: number_field
+#      size: 10
+#      format:
+#        decimals: 2
+#        delimiter: false
+###########################################################################
+class NumberField < AgileFormField
+  
+###########################################################################
+# Render text_field AgileRails form field
+###########################################################################
+def render
+  set_initial_value
+
+  record = record_text_for(@yaml['name'])
+  @yaml['html'] ||= {}
+  @yaml['html']['class'] = 'ar-number'
+  if @yaml['format'].class == String
+    format = @yaml['format']
+    @yaml['format'] = {}
+    @yaml['format']['decimal']   = format[1].blank? ? 2 : format[1].to_i
+    @yaml['format']['separator'] = format[2].blank? ? I18n.t('number.currency.format.separator') : format[2]
+    @yaml['format']['delimiter'] = format[3].blank? ? I18n.t('number.currency.format.delimiter') : format[3]
+  end
+  @yaml['html']['data-decimal']   = @yaml.dig('format', 'decimal') || 2
+  @yaml['html']['data-delimiter'] = @yaml.dig('format', 'delimiter') || I18n.t('number.currency.format.delimiter')
+  @yaml['html']['data-separator'] = @yaml.dig('format', 'separator') || I18n.t('number.currency.format.separator')
+
+  value = @yaml['html']['value'] || @record.send(@yaml['name']) || 0
+  @yaml['html']['value'] = AgileHelper.format_number(value, @yaml['html']['data-decimal'], @yaml['html']['data-separator'], @yaml['html']['data-delimiter'] )
+  
+  return ro_standard(@yaml['html']['value']) if @readonly
+
+  @yaml['html']['autocomplete'] ||= 'off'
+  @html += @env.hidden_field( record, @yaml['name'], value: value )
+  @html += @env.text_field( nil, "record_#{@yaml['name']}_", @yaml['html'])
+  self
+end
+
+###########################################################################
+# Return value. Return nil if input field is empty
+###########################################################################
+def self.get_data(params, name)
+  return 0 if params['record'][name].blank?
+
+  params['record'][name].match('.') ? params['record'][name].to_f : params['record'][name].to_i
+end
+
+end
+end

data/app/models/agile_form_fields/password_field.rb

@@ -0,0 +1,63 @@
+#--
+# Copyright (c) 2024+ Damjan Rems
+#
+# Permission is hereby granted, free of charge, to any person obtaining
+# a copy of this software and associated documentation files (the
+# "Software"), to deal in the Software without restriction, including
+# without limitation the rights to use, copy, modify, merge, publish,
+# distribute, sublicense, and/or sell copies of the Software, and to
+# permit persons to whom the Software is furnished to do so, subject to
+# the following conditions:
+#
+# The above copyright notice and this permission notice shall be
+# included in all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+# MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+# NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+# LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+# OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+# WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+#+
+module AgileFormFields
+
+###########################################################################
+# Implementation of password AgileRails form field.
+# 
+# ===Form options:
+# * +type:+ password_field (required)
+# * +name:+ Field name (required) 
+# * +html:+ html options which apply to password field (optional)
+# 
+# Form example:
+#    20:
+#      name: password
+#      type: pasword_field
+#      html:
+#        size: 20
+#        
+#    30:
+#      name: password_confirmation
+#      type: pasword_field
+#      html:
+#        size: 20
+#        
+###########################################################################
+class PasswordField < AgileFormField
+  
+###########################################################################
+# Render password AgileRails form field code
+###########################################################################
+def render
+  return self if @readonly
+
+  @yaml['html'] ||= {}
+  @yaml['html']['size'] ||= @yaml['size']
+  record = record_text_for(@yaml['name'])  
+  @html += @env.password_field(record, @yaml['name'], @yaml['html'])
+  self
+end
+end
+
+end