hbl_tags 0.0.4

data/lib/hbl_tags/tags_helper.rb

@@ -0,0 +1,685 @@
+# frozen_string_literal: true
+# encoding: utf-8
+#
+# hbl_tags provides methods to create complex html tags
+#
+# Copyright © 2021 Stephan Wenzel <stephan.wenzel@drwpatent.de>
+#
+# This program is free software; you can redistribute it and/or
+# modify it under the terms of the GNU General Public License
+# as published by the Free Software Foundation; either version 2
+# of the License, or (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
+#
+module HBLTags
+  module TagsHelper
+  
+    #---------------------------------------------------------------------------------------
+    # creates a check box field
+    #
+    def hbl_check_box( f, model, field, editable, options = {} )
+      check_box_options = options.deep_dup
+      if @bulk && !check_box_options[:nobulk]; return hbl_boolean_select(f, model, field, editable, check_box_options ); end
+      check_box_options[:class] = check_box_options[:class].to_s << " checked_box" if options[:mimic_checked]
+      check_box_options[:label] = label_text(model, field)
+      check_box_options[:disabled] ||= !editable
+      if check_box_options.delete(:boolean)
+        checked = "true"; unchecked = "false"
+      else
+        checked = 1; unchecked = 0
+      end
+      content_tag(:div, :class => ("flash error"  if !model.errors[field].empty? ) ) do
+        content_tag(:p ) do
+          f.check_box( field, check_box_options.compact, checked, unchecked ) + 
+          content_tag(:a, :href =>'#', :class => 'icon icon-help', :title => l(:label_help), :onclick => "$('##{help_tag_id(model, field)}').toggle(); return false;" ) do
+            l(:label_help)
+          end + 
+          tag(:br ) +
+          content_tag(:span, :id => "#{help_tag_id(model, field)}", :class => "info", :style => "display:none;" ) do
+            content_tag(:em, :class => "info") do
+              help_text(model, field)
+            end
+          end
+        end
+      end
+    end #def
+    
+    #---------------------------------------------------------------------------------------
+    # creates a boolean select field 
+    #
+    def hbl_boolean_select(f, model, field, editable, options = {}, html_options={} )
+      hbl_select_field( f, model, field, boolean_values_options(options), options, html_options)
+    end #def
+    
+    def boolean_values_options(options)
+      if @bulk && !options[:nobulk]
+      [ [l(:label_no_change_option),"none"],
+        [l(:label_none),             nil],
+        [l(:general_text_Yes),       1],
+        [l(:general_text_No),        0] ]
+      else
+      [ [],
+        [l(:general_text_Yes),       1],
+        [l(:general_text_No),        0] ]
+      end
+    end
+    
+    #---------------------------------------------------------------------------------------
+    # creates a file select field 
+    #
+    def hbl_file_field( f, model, field, editable, options = {} )
+      file_field_options = options.deep_dup
+      file_field_options[:label] = label_text(model, field)
+      file_field_options[:disabled] ||= !editable
+      content_tag(:div, :class => ("flash error"  if !model.errors[field].empty? ) ) do
+        content_tag(:p ) do
+          f.file_field( field, file_field_options.compact ) + 
+          content_tag(:a, :href =>'#', :class => 'icon icon-help', :title => l(:label_help), :onclick => "$('##{help_tag_id(model, field)}').toggle(); return false;" ) do
+            l(:label_help)
+          end + 
+          tag(:br ) +
+          content_tag(:span, :id => "#{help_tag_id(model, field)}", :class => "info", :style => "display:none;" ) do
+            content_tag(:em, :class => "info") do
+              help_text(model, field)
+            end
+          end
+        end
+      end
+    end #def
+    
+    #---------------------------------------------------------------------------------------
+    # creates a text field 
+    #
+    def hbl_text_field( f, model, field, editable, options = {} )
+     text_field_options = options.deep_dup
+     text_field_options[:label] = label_text(model, field)
+     text_field_options[:placeholder] = placeholder(field, model, options)
+     text_field_options[:size] ||= 32
+     text_field_options[:disabled] ||= !editable
+     content_tag(:div, :class => ("flash error"  if !model.errors[field].empty? ) ) do
+        content_tag(:p ) do
+          f.text_field( field, text_field_options.compact ) +
+          if @bulk && !text_field_options[:nobulk]
+            name = model.class.name.underscore
+            check_box_tag( "#{name}[#{field}]", "none", (model.send(field) == 'none'), :id => nil, :disabled => !editable, :class => 'inline', :data => {:disables => "##{name}_#{field}"} ) + tag(:span, :class=>"icon icon-del")
+          end.to_s + 
+          content_tag(:a, :href =>'#', :class => 'icon icon-help', :title => l(:label_help), :onclick => "$('##{help_tag_id(model, field)}').toggle(); return false;" ) do
+            l(:label_help)
+          end + 
+          tag(:br ) +
+          content_tag(:span, :id => "#{help_tag_id(model, field)}", :class => "info", :style => "display:none;" ) do
+            content_tag(:em, :class => "info") do
+              help_text(model, field)
+            end
+          end
+        end
+      end
+    end #def
+    
+    #---------------------------------------------------------------------------------------
+    # creates a password field 
+    #
+    def hbl_password_field( f, model, field, editable, options = {} )
+     text_field_options = options.deep_dup
+     text_field_options[:label] = label_text(model, field)
+     text_field_options[:value] = model.send(field.to_sym) unless text_field_options[:novalue]
+     text_field_options[:placeholder] = placeholder(field, model, options)
+     text_field_options[:size] ||= 32
+     text_field_options[:disabled] ||= !editable
+     content_tag(:div, :class => ("flash error"  if !model.errors[field].empty? ) ) do
+        content_tag(:p ) do
+          f.password_field( field, text_field_options.compact ) + 
+          if @bulk && !text_field_options[:nobulk]
+            name = model.class.name.underscore
+            check_box_tag( "#{name}[#{field}]", "none", (model.send(field) == 'none'), :id => nil, :disabled => !editable, :class => 'inline', :data => {:disables => "##{name}_#{field}"} ) + tag(:span, :class=>"icon icon-del")
+          end.to_s + 
+          content_tag(:a, :href =>'#', :class => 'icon icon-help', :title => l(:label_help), :onclick => "$('##{help_tag_id(model, field)}').toggle(); return false;" ) do
+            l(:label_help)
+          end + 
+          tag(:br ) +
+          content_tag(:span, :id => "#{help_tag_id(model, field)}", :class => "info", :style => "display:none;" ) do
+            content_tag(:em, :class => "info") do
+              help_text(model, field)
+            end
+          end
+        end
+      end
+    end #def
+    
+    #---------------------------------------------------------------------------------------
+    # creates a date field 
+    #
+    def hbl_date_field( f, model, field, editable, options = {} )
+     date_field_options = options.deep_dup
+     date_field_options[:label] = label_text(model, field)
+     date_field_options[:placeholder] = placeholder(field, model, options)
+     date_field_options[:size] ||= 32
+     date_field_options[:disabled] ||= !editable
+     content_tag(:div, :class => ("flash error"  if !model.errors[field].empty? ) ) do
+        content_tag(:p ) do
+          f.date_field( field, date_field_options.compact ) + 
+          if @bulk && !date_field_options[:nobulk]
+            name = model.class.name.underscore
+            check_box_tag( "#{name}[#{field}]", "none", (model.send(field) == 'none'), :id => nil, :disabled => !editable, :class => 'inline', :data => {:disables => "##{name}_#{field}"} ) + tag(:span, :class=>"icon icon-del")
+          end.to_s + 
+          content_tag(:a, :href =>'#', :class => 'icon icon-help', :title => l(:label_help), :onclick => "$('##{help_tag_id(model, field)}').toggle(); return false;" ) do
+            l(:label_help)
+          end + 
+          tag(:br ) +
+          content_tag(:span, :id => "#{help_tag_id(model, field)}", :class => "info", :style => "display:none;" ) do
+            content_tag(:em, :class => "info") do
+              help_text(model, field)
+            end
+          end
+        end
+      end
+    end #def
+    
+    #---------------------------------------------------------------------------------------
+    # creates an email address field 
+    #
+    def hbl_email_field( f, model, field, editable, options = {} )
+     date_field_options = options.deep_dup
+     date_field_options[:label] = label_text(model, field)
+     date_field_options[:placeholder] = placeholder(field, model, options)
+     date_field_options[:size] ||= 32
+     date_field_options[:disabled] ||= !editable
+     content_tag(:div, :class => ("flash error"  if !model.errors[field].empty? ) ) do
+        content_tag(:p ) do
+          f.email_field( field, date_field_options.compact ) + 
+          if @bulk && !date_field_options[:nobulk]
+            name = model.class.name.underscore
+            check_box_tag( "#{name}[#{field}]", "none", (model.send(field) == 'none'), :id => nil, :disabled => !editable, :class => 'inline', :data => {:disables => "##{name}_#{field}"} ) + tag(:span, :class=>"icon icon-del")
+          end.to_s + 
+          content_tag(:a, :href =>'#', :class => 'icon icon-help', :title => l(:label_help), :onclick => "$('##{help_tag_id(model, field)}').toggle(); return false;" ) do
+            l(:label_help)
+          end + 
+          tag(:br ) +
+          content_tag(:span, :id => "#{help_tag_id(model, field)}", :class => "info", :style => "display:none;" ) do
+            content_tag(:em, :class => "info") do
+              help_text(model, field)
+            end
+          end
+        end
+      end
+    end #def
+    
+    #---------------------------------------------------------------------------------------
+    # creates a telephone numer field 
+    #
+    def hbl_telephone_field( f, model, field, editable, options = {} )
+     field_options = options.deep_dup
+     field_options[:label] = label_text(model, field)
+     field_options[:placeholder] = placeholder(field, model, options)
+     field_options[:size] ||= 32
+     field_options[:disabled] ||= !editable
+     content_tag(:div, :class => ("flash error"  if !model.errors[field].empty? ) ) do
+        content_tag(:p ) do
+          f.telephone_field( field, field_options.compact ) + 
+          if @bulk && !field_options[:nobulk]
+            name = model.class.name.underscore
+            check_box_tag( "#{name}[#{field}]", "none", (model.send(field) == 'none'), :id => nil, :disabled => !editable, :class => 'inline', :data => {:disables => "##{name}_#{field}"} ) + tag(:span, :class=>"icon icon-del")
+          end.to_s + 
+          content_tag(:a, :href =>'#', :class => 'icon icon-help', :title => l(:label_help), :onclick => "$('##{help_tag_id(model, field)}').toggle(); return false;" ) do
+            l(:label_help)
+          end + 
+          tag(:br ) +
+          content_tag(:span, :id => "#{help_tag_id(model, field)}", :class => "info", :style => "display:none;" ) do
+            content_tag(:em, :class => "info") do
+              help_text(model, field)
+            end
+          end
+        end
+      end
+    end #def
+    
+    #---------------------------------------------------------------------------------------
+    # creates a date time field 
+    #
+    def hbl_datetime_field( f, model, field, editable, options = {} )
+     date_field_options = options.deep_dup
+     date_field_options[:label] = label_text(model, field)
+     date_field_options[:placeholder] = placeholder(field, model, options)
+     date_field_options[:size] ||= 32
+     date_field_options[:disabled] ||= !editable
+     content_tag(:div, :class => ("flash error"  if !model.errors[field].empty? ) ) do
+        content_tag(:p ) do
+          f.datetime_field( field, date_field_options.compact ) + 
+          if @bulk && !text_field_options[:nobulk]
+            name = model.class.name.underscore
+            check_box_tag( "#{name}[#{field}]", "none", (model.send(field) == 'none'), :id => nil, :disabled => !editable, :class => 'inline', :data => {:disables => "##{name}_#{field}"} ) + tag(:span, :class=>"icon icon-del")
+          end.to_s + 
+          content_tag(:a, :href =>'#', :class => 'icon icon-help', :title => l(:label_help), :onclick => "$('##{help_tag_id(model, field)}').toggle(); return false;" ) do
+            l(:label_help)
+          end + 
+          tag(:br ) +
+          content_tag(:span, :id => "#{help_tag_id(model, field)}", :class => "info", :style => "display:none;" ) do
+            content_tag(:em, :class => "info") do
+              help_text(model, field)
+            end
+          end
+        end
+      end
+    end #def
+    
+    #---------------------------------------------------------------------------------------
+    # creates a text area  
+    #
+    def hbl_text_area_field( f, model, field, editable, options = {} )
+     text_area_options = options.deep_dup
+     text_area_options[:label] = label_text(model, field)
+     text_area_options[:placeholder] = placeholder(field, model, options)
+     text_area_options[:rows] ||= 4
+     text_area_options[:cols] ||= 29
+     text_area_options[:disabled] ||= !editable
+      content_tag(:div, :class => ("flash error"  if !model.errors[field].empty? ) ) do
+        content_tag(:p ) do
+          f.text_area( field, text_area_options.compact ) + 
+          if @bulk && !text_area_options[:nobulk]
+            name = model.class.name.underscore
+            check_box_tag( "#{name}[#{field}]", "none", (model.send(field) == 'none'), :id => nil, :disabled => !editable, :class => 'inline', :data => {:disables => "##{name}_#{field}"} ) + tag(:span, :class=>"icon icon-del")
+          end.to_s + 
+          content_tag(:a, :href =>'#', :class => 'icon icon-help', :title => l(:label_help), :onclick => "$('##{help_tag_id(model, field)}').toggle(); return false;" ) do
+            l(:label_help)
+          end + 
+          tag(:br ) +
+          content_tag(:span, :id => "#{help_tag_id(model, field)}", :class => "info", :style => "display:none;" ) do
+            content_tag(:em, :class => "info") do
+              help_text(model, field)
+            end
+          end
+        end
+      end
+    end #def
+    
+    #---------------------------------------------------------------------------------------
+    # creates a select drop down menu
+    #
+    def hbl_select_field( f, model, field, values, options={}, html_options={})
+      select_field_options = options.deep_dup
+      select_field_options[:label] = label_text(model, field)
+      select_field_options[:disabled] ||= !options[:editable]
+      
+      if @bulk && !select_field_options[:nobulk] 
+        pvalue = placeholder(field, model, options)
+        option_label = values.map{|l,v| l if v == pvalue }.compact.first
+        values.unshift([(l(:label_no_change_option) + " #{option_label}").html_safe, ''])
+      end
+      
+      content_tag(:div, :class => ("flash error"  if !model.errors[field].empty? ) ) do
+        content_tag(:p ) do
+          f.select( field, values, select_field_options.compact, html_options ) + 
+          content_tag(:a, :href =>'#', :class => 'icon icon-help', :title => l(:label_help), :onclick => "$('##{help_tag_id(model, field)}').toggle(); return false;" ) do
+            l(:label_help)
+          end + 
+          tag(:br ) +
+          content_tag(:span, :id => "#{help_tag_id(model, field)}", :class => "info", :style => "display:none;" ) do
+            content_tag(:em, :class => "info") do
+              help_text(model, field)
+            end
+          end
+        end
+      end
+    end #def
+  
+    #---------------------------------------------------------------------------------------
+    # creates a country select drop down menu
+    #
+    def hbl_country_select_field( f, model, field, values, options={}, html_options={})
+      country_field_options = options.deep_dup
+      country_field_options[:label] ||= label_text(model, field)
+      #country_field_options[:disabled] ||= !editable
+      content_tag(:div, :class => ("flash error"  if !model.errors[field].empty? ) ) do
+        content_tag(:p ) do
+          content_tag(:label, country_field_options[:label]) + 
+          f.country_select( field, values, country_field_options.compact, html_options ) + 
+          content_tag(:a, :href =>'#', :class => 'icon icon-help', :title => l(:label_help), :onclick => "$('##{help_tag_id(model, field)}').toggle(); return false;" ) do
+            l(:label_help)
+          end + 
+          tag(:br ) +
+          content_tag(:span, :id => "#{help_tag_id(model, field)}", :class => "info", :style => "display:none;" ) do
+            content_tag(:em, :class => "info") do
+              help_text(model, field)
+            end
+          end
+        end
+      end
+    end #def
+    
+    #---------------------------------------------------------------------------------------
+    # creates a hidden field
+    #
+    def hbl_hidden_field( f, field, options={})
+      f.hidden_field( field, options )
+    end #def
+     
+    #---------------------------------------------------------------------------------------
+    # creates a tagged field 
+    #
+    def hbl_tagged_fields_hash(f, model, field, editable, options={} )
+     tagged_fields_options = options.deep_dup
+     tagged_fields_options[:label] = label_text(model, field)
+     tagged_fields_options[:size] ||= 32
+     tagged_fields_options[:disabled] ||= !editable
+     content_tag(:div, :class => ("flash error"  if !model.errors[field].empty? ) ) do
+        tags = model.send(field).map do |k, v|
+          case v.class.name
+          when "Array"
+            v.map do |av|
+              content_tag(:p ) do
+                content_tag(:label, get_tagged_fields_hash_name(model, k)) + 
+                text_field_tag( "[#{model.class.name.underscore}][#{field}][#{k}][]", av, tagged_fields_options ) +
+                (editable ? content_tag(:a, "", :href=>"#", :class=>"icon icon-del", :onclick=>"$(this).parent().remove();" ) : "")
+              end
+            end.join("\n").html_safe
+          else
+            content_tag(:p ) do
+              content_tag(:label, get_tagged_fields_hash_name(model, k)) +
+              text_field_tag( "[#{model.class.name.underscore}][#{field}][#{k}]", v, tagged_fields_options ) +
+              (editable ? content_tag(:a, "", :href=>"#", :class=>"icon icon-del", :onclick=>"$(this).parent().remove();" ) : "")
+            end
+          end
+        end
+        tags.join("\n").html_safe
+      end
+    end #def
+    
+    #---------------------------------------------------------------------------------------
+    # creates a tagged field selector
+    #
+    HBL_ADD_TAG_SCRIPT= <<-EOF
+    
+      function hbl_append_tagged_field( url) {
+        $.ajax({
+          url: url,
+          async: false,
+          method: 'get',
+          dataType: 'script'
+        });
+      }
+      
+      var formElements = new Array();
+      var formElementPrefix = "";
+      
+      function hbl_update_selector_field() {
+      
+        /* define variables */
+        var id = "";
+        
+        /* enable all select options */
+        $('#tagged_field_selector').children().removeAttr('disabled');
+        
+        /* collect all current text input tags */
+        formElements = [];
+        $("#entity-tagged_fields-fields :input").each(function(){
+          formElements.push($(this).attr('id'));
+        });
+        
+        /* now diable all elements, not ending with "_", which are not multiple */
+        formElements.forEach( function (item, index) {
+          id = item.replace(formElementPrefix,'');
+          $('#tagged_field_selector').children('option[value="' + id + '"]').attr('disabled', 'disabled');
+        });
+      }
+      
+      EOF
+      
+    def hbl_tagged_fields_selector(project, model, field, tag_id, editable )
+      tagged_fields = TaggedField.of(project)
+      mod           = model.class.name.underscore
+      content_tag(:p) do
+        content_tag(:label, l(:label_new_tagged_field)) +
+        select_tag(
+          "tagged_field_selector", 
+          options_for_select([[l(:label_select_tagged_field),""]] + tagged_fields.collect{ |u| [u.name, u.identifier] } ),
+          :onchange => "hbl_append_tagged_field('#{add_project_tagged_fields_path(project,:m=>mod,:f=>field,:t=>tag_id)}&identifier='+this.value);this.selectedIndex = 0;hbl_update_selector_field();".html_safe,
+          :disabled => !editable
+        ) + 
+        content_tag(:script) do
+          HBL_ADD_TAG_SCRIPT.html_safe + 
+          "formElementPrefix='_#{escape_javascript mod}_#{escape_javascript field.to_s}_';\n".html_safe +
+          "$(function() {hbl_update_selector_field();});"
+        end
+      end
+    end #def
+    
+    #---------------------------------------------------------------------------------------
+    #
+    # edit tags for inline editing
+    #           require: 
+    #                      update_field_of_project_#{model}_path or options[:update_function]
+    #                      edit_#{models} as permission           or options[:edit_permissions]
+    #                      view_#{models} as permission           or options[:view_permissions]
+    #
+    def hbl_edit_string_tag( column, model, value, options={} )
+      
+      klass                = options[:class]           || model.class
+      denominator          = klass.name.underscore
+      
+      project              = model.project             || @project 
+      view_permission      = options[:view_permission] || "view_#{denominator.pluralize}".to_sym
+      edit_permission      = options[:edit_permission] || "edit_#{denominator.pluralize}".to_sym
+      update_function      = options[:update_function] || "update_field_of_project_#{denominator}_path".to_sym
+      width                = options[:width]           || 12
+      value_representation = options[:value]           || value
+      style                = options[:style]           || ""
+      css_class            = options[:css_class]       || "ipmclickempty"
+      data_text            = options[:data_text]       || "\xE2\x80\x8B" # zero width space
+      
+      if User.current.allowed_to?(edit_permission, project) && (model.respond_to?(:editable?) ? model.editable? : true)
+        content_tag( 
+          "div", 
+          value_representation,
+          :field      => column.name.to_s,
+          :id         => "#{denominator}-#{model.id}-#{column.name.to_s}",
+          :onclick    => "editTextField(this, '#{send(update_function, project.identifier, model)}', #{width}); return false;",
+          :class      => css_class,
+          :content_editable => true,
+          :data       => {:text => data_text}, # placeholder text
+          :style      => style
+        )
+      elsif User.current.allowed_to?(view_permission, project) 
+        content_tag( 
+          "div", 
+          value_representation,
+          :id         => "#{column.name.to_s}_#{model.id}"
+        )
+      else
+        content_tag( 
+          "div", 
+          "---x---",
+          :id         => "#{denominator}-#{model.id}-#{column.name.to_s}"
+        )
+      end #if
+    end #def
+    
+    #---------------------------------------------------------------------------------------
+    # creates an edit array tag
+    #
+    def hbl_edit_array_tag( column, model, value, options={} )
+    
+      klass                = options[:class]           || model.class
+      denominator          = klass.name.underscore
+      
+      project              = model.project             || @project 
+      view_permission      = options[:view_permission] || "view_#{denominator.pluralize}".to_sym
+      edit_permission      = options[:edit_permission] || "edit_#{denominator.pluralize}".to_sym
+      update_function      = options[:update_function] || "update_field_of_project_#{denominator}_path".to_sym
+      width                = options[:width]           || 12
+      css_class            = options[:css_class]       || "ipmclickempty"
+      
+      if User.current.allowed_to?(edit_permission, project) && (model.respond_to?(:editable?) ? model.editable? : true)
+        content_tag( 
+          "div", 
+          value.to_s.split(/;|,|\ /).select(&:present?).join(", "),
+          :field      => column.name.to_s,
+          :id         => "#{denominator}-#{model.id}-#{column.name.to_s}",
+          :onclick    => "editTextField(this, '#{send(update_function, project.identifier, model)}', #{width}); return false;",
+          :class      => css_class
+        )
+      elsif User.current.allowed_to?(view_permission, project) 
+        content_tag( 
+          "div", 
+          value.to_s.split(/;|,|\ /).select(&:present?).join(", "),
+          :id         => "#{denominator}-#{model.id}-#{column.name.to_s}",
+        )
+      else
+        content_tag( 
+          "div", 
+          "---x---",
+          :id         => "#{denominator}-#{model.id}-#{column.name.to_s}"
+        )
+      end #if
+    end #def
+    
+    #---------------------------------------------------------------------------------------
+    # creates an edit text tag
+    #
+    def hbl_edit_text_tag( column, model, value, options={} )
+    
+      klass                = options[:class]           || model.class
+      denominator          = klass.name.underscore
+      
+      project              = model.project             || @project 
+      view_permission      = options[:view_permission] || "view_#{denominator.pluralize}".to_sym
+      edit_permission      = options[:edit_permission] || "edit_#{denominator.pluralize}".to_sym
+      update_function      = options[:update_function] || "update_field_of_project_#{denominator}_path".to_sym
+      height               = options[:height]          || 5
+      value_representation = options[:value]           || value
+      css_class            = options[:css_class]       || "ipmclickempty"
+      inner_css_class      = options[:inner_css_class] || "ipmclickpre"
+      
+      if User.current.allowed_to?(edit_permission, project) && (model.respond_to?(:editable?) ? model.editable? : true)
+        content_tag( 
+          "div", 
+          value_representation,
+          #content_tag("pre", value_representation, :class => inner_css_class),
+          :field      => column.name.to_s,
+          :id         => "#{denominator}-#{model.id}-#{column.name.to_s}",
+          :onclick    => "editTextAreaField(this, '#{send(update_function, project.identifier, model)}', #{height}); return false;",
+          :class      => css_class
+        )
+      elsif User.current.allowed_to?(view_permission, project) 
+        content_tag( 
+          "div", 
+          value_representation,
+          :id         => "#{column.name.to_s}_#{model.id}"
+        )
+      else
+        content_tag( 
+          "div", 
+          "---x---",
+          :id         => "#{denominator}-#{model.id}-#{column.name.to_s}"
+        )
+      end #if
+    end #def  
+    
+    
+    #---------------------------------------------------------------------------------------
+    # creates an iframe tag
+    #
+    def ipm_iframe_tag(path, title, id, options={})
+    
+      content_tag(:div, 
+        content_tag(
+          :iframe,
+          "",
+          { :src                  => path,
+            :id                   => id,
+            :title                => title,
+            :frameborder          => "0",
+            :scrolling            => "no",
+            :allowtransparency    => "true",
+            :seamless             => "seamless",
+            :style                => "width:100%;height:16px;",
+            :onload               => "resizeIframe(this);"
+           }
+        ),
+        options
+      )
+    end #def
+              
+    #---------------------------------------------------------------------------------------
+    # private methods
+    #
+    def get_tagged_fields_hash_name(model, k)
+      tagged_fields = TaggedField.of(model.project).where(:identifier => k)
+      return tagged_fields[0].name if tagged_fields.present?
+      return k.to_s.humanize
+    end #def
+    
+    def help_tag_id(model, field)
+      stem = field.to_s.gsub(/_id\z/, "")
+      "help_#{model.class.name.demodulize.underscore}_#{stem}_#{model.id}"
+    end #def
+    
+    def help_text(model, field)
+      stem = field.to_s.gsub(/_id\z/, "")
+      hbl_label( "help_#{stem}".to_sym, model )
+    end #def
+    
+    def label_text(model, field)
+      stem = field.to_s.gsub(/_id\z/, "")
+      hbl_label( "field_#{stem}".to_sym, model )
+    end #def
+    
+    # get placeholder value in the following hierarchy:
+    # 
+    # 1. options[:placeholder]
+    # 2. an instance variable containing a model named #{model.class.name.underscore}_placeholder
+    # 3. an instance variable with a hash contaning attributes with placeholders name #{model.class.name.underscore}_attributes
+    # 4. preset values from init.rb 
+    #
+    def placeholder( field, model, options={} )
+    
+      placeholder   = options[:placeholder]
+      name          = "#{model.class.name.underscore}"
+      attr_model    = instance_variable_get("@#{name}_placeholder")
+      attr_hash     = instance_variable_get("@#{name}_attributes")
+      
+      name          = "#{model.class.base_class.name.underscore}"
+      attr_model  ||= instance_variable_get("@#{name}_placeholder")
+      attr_hash   ||= instance_variable_get("@#{name}_attributes")
+      
+      placeholder ||= (attr_model && attr_model.send(field) rescue "__error__")
+      placeholder ||= attr_hash.symbolize_keys[field.to_sym] if attr_hash.is_a?(Hash)
+      placeholder ||= I18n.translate( "#{model.class.name.underscore}.#{field}".to_sym )
+      
+      placeholder
+    end #def
+    
+    def project_tree_options_array(projects, options = {})
+      s = []
+      if blank_text = options[:include_blank]
+        if blank_text == true
+          blank_text = '&nbsp;'.html_safe
+        end
+        s << [blank_text, '']
+      end
+      Project.project_tree(projects) do |project, level|
+        name_prefix = (level > 0 ? '&nbsp;' * 2 * level + '&#187; ' : '').html_safe
+        s << [name_prefix + h(project), project.id]
+      end
+      s
+    end
+    
+    def currency_options_for_select(blank=true)
+      (blank ? [["(auto)", ""]] : []) + currencies_options
+    end #def
+    
+    def currencies_options
+      ["DE", "US", "CH"].map do |cc|
+        c = ISO3166::Country[cc]; 
+        I18n.with_locale(:de) { [c.currency.name, c.currency.iso_code] }
+      end
+    end #def
+  end 
+end