Chris@909: # encoding: utf-8
Chris@909: #
Chris@245: # Redmine - project management software
Chris@1494: # Copyright (C) 2006-2014  Jean-Philippe Lang
Chris@0: #
Chris@0: # This program is free software; you can redistribute it and/or
Chris@0: # modify it under the terms of the GNU General Public License
Chris@0: # as published by the Free Software Foundation; either version 2
Chris@0: # of the License, or (at your option) any later version.
Chris@441: #
Chris@0: # This program is distributed in the hope that it will be useful,
Chris@0: # but WITHOUT ANY WARRANTY; without even the implied warranty of
Chris@0: # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
Chris@0: # GNU General Public License for more details.
Chris@441: #
Chris@0: # You should have received a copy of the GNU General Public License
Chris@0: # along with this program; if not, write to the Free Software
Chris@0: # Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
Chris@0: 
Chris@0: module IssuesHelper
Chris@0:   include ApplicationHelper
Chris@0: 
Chris@0:   def issue_list(issues, &block)
Chris@0:     ancestors = []
Chris@0:     issues.each do |issue|
Chris@0:       while (ancestors.any? && !issue.is_descendant_of?(ancestors.last))
Chris@0:         ancestors.pop
Chris@0:       end
Chris@0:       yield issue, ancestors.size
Chris@0:       ancestors << issue unless issue.leaf?
Chris@0:     end
Chris@0:   end
chris@22: 
chris@22:   # Renders a HTML/CSS tooltip
chris@22:   #
chris@22:   # To use, a trigger div is needed.  This is a div with the class of "tooltip"
chris@22:   # that contains this method wrapped in a span with the class of "tip"
chris@22:   #
chris@22:   #    <div class="tooltip"><%= link_to_issue(issue) %>
chris@22:   #      <span class="tip"><%= render_issue_tooltip(issue) %></span>
chris@22:   #    </div>
chris@22:   #
Chris@0:   def render_issue_tooltip(issue)
Chris@14:     @cached_label_status ||= l(:field_status)
Chris@0:     @cached_label_start_date ||= l(:field_start_date)
Chris@0:     @cached_label_due_date ||= l(:field_due_date)
Chris@0:     @cached_label_assigned_to ||= l(:field_assigned_to)
Chris@0:     @cached_label_priority ||= l(:field_priority)
chris@22:     @cached_label_project ||= l(:field_project)
chris@22: 
Chris@1115:     link_to_issue(issue) + "<br /><br />".html_safe +
Chris@1115:       "<strong>#{@cached_label_project}</strong>: #{link_to_project(issue.project)}<br />".html_safe +
Chris@1115:       "<strong>#{@cached_label_status}</strong>: #{h(issue.status.name)}<br />".html_safe +
Chris@1115:       "<strong>#{@cached_label_start_date}</strong>: #{format_date(issue.start_date)}<br />".html_safe +
Chris@1115:       "<strong>#{@cached_label_due_date}</strong>: #{format_date(issue.due_date)}<br />".html_safe +
Chris@1115:       "<strong>#{@cached_label_assigned_to}</strong>: #{h(issue.assigned_to)}<br />".html_safe +
Chris@1115:       "<strong>#{@cached_label_priority}</strong>: #{h(issue.priority.name)}".html_safe
Chris@0:   end
Chris@441: 
Chris@441:   def issue_heading(issue)
Chris@441:     h("#{issue.tracker} ##{issue.id}")
Chris@441:   end
Chris@441: 
Chris@0:   def render_issue_subject_with_tree(issue)
Chris@0:     s = ''
Chris@441:     ancestors = issue.root? ? [] : issue.ancestors.visible.all
Chris@441:     ancestors.each do |ancestor|
Chris@1115:       s << '<div>' + content_tag('p', link_to_issue(ancestor, :project => (issue.project_id != ancestor.project_id)))
Chris@0:     end
Chris@441:     s << '<div>'
Chris@441:     subject = h(issue.subject)
Chris@441:     if issue.is_private?
Chris@441:       subject = content_tag('span', l(:field_is_private), :class => 'private') + ' ' + subject
Chris@441:     end
Chris@441:     s << content_tag('h3', subject)
Chris@441:     s << '</div>' * (ancestors.size + 1)
Chris@909:     s.html_safe
Chris@0:   end
Chris@441: 
Chris@0:   def render_descendants_tree(issue)
Chris@0:     s = '<form><table class="list issues">'
Chris@441:     issue_list(issue.descendants.visible.sort_by(&:lft)) do |child, level|
Chris@1115:       css = "issue issue-#{child.id} hascontextmenu"
Chris@1115:       css << " idnt idnt-#{level}" if level > 0
Chris@0:       s << content_tag('tr',
Chris@0:              content_tag('td', check_box_tag("ids[]", child.id, false, :id => nil), :class => 'checkbox') +
Chris@1115:              content_tag('td', link_to_issue(child, :truncate => 60, :project => (issue.project_id != child.project_id)), :class => 'subject') +
Chris@0:              content_tag('td', h(child.status)) +
Chris@0:              content_tag('td', link_to_user(child.assigned_to)) +
Chris@0:              content_tag('td', progress_bar(child.done_ratio, :width => '80px')),
Chris@1115:              :class => css)
Chris@0:     end
Chris@1115:     s << '</table></form>'
Chris@909:     s.html_safe
Chris@0:   end
Chris@441: 
Chris@1464:   # Returns an array of error messages for bulk edited issues
Chris@1464:   def bulk_edit_error_messages(issues)
Chris@1464:     messages = {}
Chris@1464:     issues.each do |issue|
Chris@1464:       issue.errors.full_messages.each do |message|
Chris@1464:         messages[message] ||= []
Chris@1464:         messages[message] << issue
Chris@1464:       end
Chris@1464:     end
Chris@1464:     messages.map { |message, issues|
Chris@1464:       "#{message}: " + issues.map {|i| "##{i.id}"}.join(', ')
Chris@1464:     }
Chris@1464:  end
Chris@1464: 
Chris@1115:   # Returns a link for adding a new subtask to the given issue
Chris@1115:   def link_to_new_subtask(issue)
Chris@1115:     attrs = {
Chris@1115:       :tracker_id => issue.tracker,
Chris@1115:       :parent_issue_id => issue
Chris@1115:     }
Chris@1115:     link_to(l(:button_add), new_project_issue_path(issue.project, :issue => attrs))
Chris@1115:   end
Chris@1115: 
Chris@1115:   class IssueFieldsRows
Chris@1115:     include ActionView::Helpers::TagHelper
Chris@1115: 
Chris@1115:     def initialize
Chris@1115:       @left = []
Chris@1115:       @right = []
Chris@1115:     end
Chris@1115: 
Chris@1115:     def left(*args)
Chris@1115:       args.any? ? @left << cells(*args) : @left
Chris@1115:     end
Chris@1115: 
Chris@1115:     def right(*args)
Chris@1115:       args.any? ? @right << cells(*args) : @right
Chris@1115:     end
Chris@1115: 
Chris@1115:     def size
Chris@1115:       @left.size > @right.size ? @left.size : @right.size
Chris@1115:     end
Chris@1115: 
Chris@1115:     def to_html
Chris@1115:       html = ''.html_safe
Chris@1115:       blank = content_tag('th', '') + content_tag('td', '')
Chris@1115:       size.times do |i|
Chris@1115:         left = @left[i] || blank
Chris@1115:         right = @right[i] || blank
Chris@1115:         html << content_tag('tr', left + right)
Chris@1115:       end
Chris@1115:       html
Chris@1115:     end
Chris@1115: 
Chris@1115:     def cells(label, text, options={})
Chris@1115:       content_tag('th', "#{label}:", options) + content_tag('td', text, options)
Chris@1115:     end
Chris@1115:   end
Chris@1115: 
Chris@1115:   def issue_fields_rows
Chris@1115:     r = IssueFieldsRows.new
Chris@1115:     yield r
Chris@1115:     r.to_html
Chris@1115:   end
Chris@1115: 
Chris@0:   def render_custom_fields_rows(issue)
Chris@1464:     values = issue.visible_custom_field_values
Chris@1464:     return if values.empty?
Chris@0:     ordered_values = []
Chris@1464:     half = (values.size / 2.0).ceil
Chris@0:     half.times do |i|
Chris@1464:       ordered_values << values[i]
Chris@1464:       ordered_values << values[i + half]
Chris@0:     end
Chris@0:     s = "<tr>\n"
Chris@0:     n = 0
Chris@0:     ordered_values.compact.each do |value|
Chris@0:       s << "</tr>\n<tr>\n" if n > 0 && (n % 2) == 0
Chris@0:       s << "\t<th>#{ h(value.custom_field.name) }:</th><td>#{ simple_format_without_paragraph(h(show_value(value))) }</td>\n"
Chris@0:       n += 1
Chris@0:     end
Chris@0:     s << "</tr>\n"
Chris@909:     s.html_safe
Chris@0:   end
Chris@441: 
Chris@441:   def issues_destroy_confirmation_message(issues)
Chris@441:     issues = [issues] unless issues.is_a?(Array)
Chris@441:     message = l(:text_issues_destroy_confirmation)
Chris@441:     descendant_count = issues.inject(0) {|memo, i| memo += (i.right - i.left - 1)/2}
Chris@441:     if descendant_count > 0
Chris@441:       issues.each do |issue|
Chris@441:         next if issue.root?
Chris@441:         issues.each do |other_issue|
Chris@441:           descendant_count -= 1 if issue.is_descendant_of?(other_issue)
Chris@441:         end
Chris@441:       end
Chris@441:       if descendant_count > 0
Chris@441:         message << "\n" + l(:text_issues_destroy_descendants_confirmation, :count => descendant_count)
Chris@441:       end
Chris@441:     end
Chris@441:     message
Chris@441:   end
Chris@441: 
Chris@0:   def sidebar_queries
Chris@0:     unless @sidebar_queries
Chris@1464:       @sidebar_queries = IssueQuery.visible.
Chris@1464:         order("#{Query.table_name}.name ASC").
Chris@1115:         # Project specific queries and global queries
Chris@1464:         where(@project.nil? ? ["project_id IS NULL"] : ["project_id IS NULL OR project_id = ?", @project.id]).
Chris@1464:         all
Chris@0:     end
Chris@0:     @sidebar_queries
Chris@0:   end
Chris@0: 
Chris@245:   def query_links(title, queries)
Chris@1464:     return '' if queries.empty?
Chris@245:     # links to #index on issues/show
Chris@245:     url_params = controller_name == 'issues' ? {:controller => 'issues', :action => 'index', :project_id => @project} : params
Chris@441: 
Chris@1464:     content_tag('h3', title) + "\n" +
Chris@1464:       content_tag('ul',
Chris@1464:         queries.collect {|query|
Chris@1464:             css = 'query'
Chris@1464:             css << ' selected' if query == @query
Chris@1464:             content_tag('li', link_to(query.name, url_params.merge(:query_id => query), :class => css))
Chris@1464:           }.join("\n").html_safe,
Chris@1464:         :class => 'queries'
Chris@1464:       ) + "\n"
Chris@245:   end
Chris@441: 
Chris@245:   def render_sidebar_queries
Chris@1115:     out = ''.html_safe
Chris@1464:     out << query_links(l(:label_my_queries), sidebar_queries.select(&:is_private?))
Chris@1464:     out << query_links(l(:label_query_plural), sidebar_queries.reject(&:is_private?))
Chris@245:     out
Chris@245:   end
Chris@245: 
Chris@1464:   def email_issue_attributes(issue, user)
Chris@1464:     items = []
Chris@1464:     %w(author status priority assigned_to category fixed_version).each do |attribute|
Chris@1464:       unless issue.disabled_core_fields.include?(attribute+"_id")
Chris@1464:         items << "#{l("field_#{attribute}")}: #{issue.send attribute}"
Chris@1464:       end
Chris@1464:     end
Chris@1464:     issue.visible_custom_field_values(user).each do |value|
Chris@1464:       items << "#{value.custom_field.name}: #{show_value(value)}"
Chris@1464:     end
Chris@1464:     items
Chris@1464:   end
Chris@1464: 
Chris@1464:   def render_email_issue_attributes(issue, user, html=false)
Chris@1464:     items = email_issue_attributes(issue, user)
Chris@1464:     if html
Chris@1464:       content_tag('ul', items.map{|s| content_tag('li', s)}.join("\n").html_safe)
Chris@1464:     else
Chris@1464:       items.map{|s| "* #{s}"}.join("\n")
Chris@1464:     end
Chris@1464:   end
Chris@1464: 
Chris@1115:   # Returns the textual representation of a journal details
Chris@1115:   # as an array of strings
Chris@1115:   def details_to_strings(details, no_html=false, options={})
Chris@1115:     options[:only_path] = (options[:only_path] == false ? false : true)
Chris@1115:     strings = []
Chris@1115:     values_by_field = {}
Chris@1115:     details.each do |detail|
Chris@1115:       if detail.property == 'cf'
Chris@1464:         field = detail.custom_field
Chris@1115:         if field && field.multiple?
Chris@1464:           values_by_field[field] ||= {:added => [], :deleted => []}
Chris@1115:           if detail.old_value
Chris@1464:             values_by_field[field][:deleted] << detail.old_value
Chris@1115:           end
Chris@1115:           if detail.value
Chris@1464:             values_by_field[field][:added] << detail.value
Chris@1115:           end
Chris@1115:           next
Chris@1115:         end
Chris@1115:       end
Chris@1115:       strings << show_detail(detail, no_html, options)
Chris@1115:     end
Chris@1464:     values_by_field.each do |field, changes|
Chris@1464:       detail = JournalDetail.new(:property => 'cf', :prop_key => field.id.to_s)
Chris@1464:       detail.instance_variable_set "@custom_field", field
Chris@1115:       if changes[:added].any?
Chris@1115:         detail.value = changes[:added]
Chris@1115:         strings << show_detail(detail, no_html, options)
Chris@1115:       elsif changes[:deleted].any?
Chris@1115:         detail.old_value = changes[:deleted]
Chris@1115:         strings << show_detail(detail, no_html, options)
Chris@1115:       end
Chris@1115:     end
Chris@1115:     strings
Chris@1115:   end
Chris@1115: 
Chris@1115:   # Returns the textual representation of a single journal detail
Chris@1115:   def show_detail(detail, no_html=false, options={})
Chris@1115:     multiple = false
Chris@0:     case detail.property
Chris@0:     when 'attr'
Chris@0:       field = detail.prop_key.to_s.gsub(/\_id$/, "")
Chris@0:       label = l(("field_" + field).to_sym)
Chris@1115:       case detail.prop_key
Chris@1115:       when 'due_date', 'start_date'
Chris@0:         value = format_date(detail.value.to_date) if detail.value
Chris@0:         old_value = format_date(detail.old_value.to_date) if detail.old_value
Chris@0: 
Chris@1115:       when 'project_id', 'status_id', 'tracker_id', 'assigned_to_id',
Chris@1115:             'priority_id', 'category_id', 'fixed_version_id'
Chris@0:         value = find_name_by_reflection(field, detail.value)
Chris@0:         old_value = find_name_by_reflection(field, detail.old_value)
Chris@0: 
Chris@1115:       when 'estimated_hours'
Chris@0:         value = "%0.02f" % detail.value.to_f unless detail.value.blank?
Chris@0:         old_value = "%0.02f" % detail.old_value.to_f unless detail.old_value.blank?
Chris@0: 
Chris@1115:       when 'parent_id'
Chris@0:         label = l(:field_parent_issue)
Chris@0:         value = "##{detail.value}" unless detail.value.blank?
Chris@0:         old_value = "##{detail.old_value}" unless detail.old_value.blank?
Chris@441: 
Chris@1115:       when 'is_private'
Chris@441:         value = l(detail.value == "0" ? :general_text_No : :general_text_Yes) unless detail.value.blank?
Chris@441:         old_value = l(detail.old_value == "0" ? :general_text_No : :general_text_Yes) unless detail.old_value.blank?
Chris@0:       end
Chris@0:     when 'cf'
Chris@1464:       custom_field = detail.custom_field
Chris@0:       if custom_field
Chris@1115:         multiple = custom_field.multiple?
Chris@0:         label = custom_field.name
Chris@0:         value = format_value(detail.value, custom_field.field_format) if detail.value
Chris@0:         old_value = format_value(detail.old_value, custom_field.field_format) if detail.old_value
Chris@0:       end
Chris@0:     when 'attachment'
Chris@0:       label = l(:label_attachment)
Chris@1464:     when 'relation'
Chris@1464:       if detail.value && !detail.old_value
Chris@1464:         rel_issue = Issue.visible.find_by_id(detail.value)
Chris@1464:         value = rel_issue.nil? ? "#{l(:label_issue)} ##{detail.value}" :
Chris@1464:                   (no_html ? rel_issue : link_to_issue(rel_issue, :only_path => options[:only_path]))
Chris@1464:       elsif detail.old_value && !detail.value
Chris@1464:         rel_issue = Issue.visible.find_by_id(detail.old_value)
Chris@1464:         old_value = rel_issue.nil? ? "#{l(:label_issue)} ##{detail.old_value}" :
Chris@1464:                           (no_html ? rel_issue : link_to_issue(rel_issue, :only_path => options[:only_path]))
Chris@1464:       end
Chris@1464:       label = l(detail.prop_key.to_sym)
Chris@0:     end
Chris@1115:     call_hook(:helper_issues_show_detail_after_setting,
Chris@1115:               {:detail => detail, :label => label, :value => value, :old_value => old_value })
Chris@0: 
Chris@0:     label ||= detail.prop_key
Chris@0:     value ||= detail.value
Chris@0:     old_value ||= detail.old_value
Chris@441: 
Chris@0:     unless no_html
Chris@0:       label = content_tag('strong', label)
Chris@0:       old_value = content_tag("i", h(old_value)) if detail.old_value
Chris@1464:       if detail.old_value && detail.value.blank? && detail.property != 'relation'
Chris@1464:         old_value = content_tag("del", old_value)
Chris@1464:       end
Chris@1115:       if detail.property == 'attachment' && !value.blank? && atta = Attachment.find_by_id(detail.prop_key)
Chris@0:         # Link to the attachment if it has not been removed
Chris@1115:         value = link_to_attachment(atta, :download => true, :only_path => options[:only_path])
Chris@1115:         if options[:only_path] != false && atta.is_text?
Chris@1115:           value += link_to(
Chris@1115:                        image_tag('magnifier.png'),
Chris@1115:                        :controller => 'attachments', :action => 'show',
Chris@1115:                        :id => atta, :filename => atta.filename
Chris@1115:                      )
Chris@1115:         end
Chris@0:       else
Chris@0:         value = content_tag("i", h(value)) if value
Chris@0:       end
Chris@0:     end
Chris@441: 
Chris@245:     if detail.property == 'attr' && detail.prop_key == 'description'
Chris@245:       s = l(:text_journal_changed_no_detail, :label => label)
Chris@245:       unless no_html
Chris@441:         diff_link = link_to 'diff',
Chris@1115:           {:controller => 'journals', :action => 'diff', :id => detail.journal_id,
Chris@1115:            :detail_id => detail.id, :only_path => options[:only_path]},
Chris@245:           :title => l(:label_view_diff)
Chris@245:         s << " (#{ diff_link })"
Chris@245:       end
Chris@1115:       s.html_safe
Chris@1115:     elsif detail.value.present?
Chris@0:       case detail.property
Chris@0:       when 'attr', 'cf'
Chris@1115:         if detail.old_value.present?
Chris@1115:           l(:text_journal_changed, :label => label, :old => old_value, :new => value).html_safe
Chris@1115:         elsif multiple
Chris@1115:           l(:text_journal_added, :label => label, :value => value).html_safe
Chris@0:         else
Chris@1115:           l(:text_journal_set_to, :label => label, :value => value).html_safe
Chris@0:         end
Chris@1464:       when 'attachment', 'relation'
Chris@1115:         l(:text_journal_added, :label => label, :value => value).html_safe
Chris@0:       end
Chris@0:     else
Chris@1115:       l(:text_journal_deleted, :label => label, :old => old_value).html_safe
Chris@0:     end
Chris@0:   end
Chris@0: 
Chris@0:   # Find the name of an associated record stored in the field attribute
Chris@0:   def find_name_by_reflection(field, id)
Chris@1464:     unless id.present?
Chris@1464:       return nil
Chris@1464:     end
Chris@0:     association = Issue.reflect_on_association(field.to_sym)
Chris@0:     if association
Chris@0:       record = association.class_name.constantize.find_by_id(id)
Chris@1294:       if record
Chris@1294:         record.name.force_encoding('UTF-8') if record.name.respond_to?(:force_encoding)
Chris@1294:         return record.name
Chris@1294:       end
Chris@0:     end
Chris@0:   end
Chris@441: 
Chris@119:   # Renders issue children recursively
Chris@119:   def render_api_issue_children(issue, api)
Chris@119:     return if issue.leaf?
Chris@119:     api.array :children do
Chris@119:       issue.children.each do |child|
Chris@119:         api.issue(:id => child.id) do
Chris@119:           api.tracker(:id => child.tracker_id, :name => child.tracker.name) unless child.tracker.nil?
Chris@119:           api.subject child.subject
Chris@119:           render_api_issue_children(child, api)
Chris@119:         end
Chris@119:       end
Chris@119:     end
Chris@119:   end
Chris@0: end