GitLab steht Mittwoch, den 08. Juli, zwischen 09:00 und 13:00 Uhr aufgrund von Wartungsarbeiten nicht zur Verfügung.

issues_helper.rb 20.3 KB
Newer Older
1 2
# encoding: utf-8
#
3
# Redmine - project management software
jplang's avatar
jplang committed
4
# Copyright (C) 2006-2017  Jean-Philippe Lang
5 6 7 8 9
#
# 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.
10
#
11 12 13 14
# 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.
15
#
16 17 18 19 20
# 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 IssuesHelper
21
  include ApplicationHelper
22
  include Redmine::Export::PDF::IssuesPdfHelper
23

24 25 26 27 28 29 30
  def issue_list(issues, &block)
    ancestors = []
    issues.each do |issue|
      while (ancestors.any? && !issue.is_descendant_of?(ancestors.last))
        ancestors.pop
      end
      yield issue, ancestors.size
31
      ancestors << issue unless issue.leaf?
32 33
    end
  end
edavis10's avatar
edavis10 committed
34

35
  def grouped_issue_list(issues, query, &block)
36
    ancestors = []
37
    grouped_query_results(issues, query) do |issue, group_name, group_count, group_totals|
38 39
      while (ancestors.any? && !issue.is_descendant_of?(ancestors.last))
        ancestors.pop
40
      end
41 42
      yield issue, ancestors.size, group_name, group_count, group_totals
      ancestors << issue unless issue.leaf?
43 44 45
    end
  end

edavis10's avatar
edavis10 committed
46 47 48 49 50 51 52 53 54
  # Renders a HTML/CSS tooltip
  #
  # To use, a trigger div is needed.  This is a div with the class of "tooltip"
  # that contains this method wrapped in a span with the class of "tip"
  #
  #    <div class="tooltip"><%= link_to_issue(issue) %>
  #      <span class="tip"><%= render_issue_tooltip(issue) %></span>
  #    </div>
  #
55
  def render_issue_tooltip(issue)
56
    @cached_label_status ||= l(:field_status)
57 58 59 60
    @cached_label_start_date ||= l(:field_start_date)
    @cached_label_due_date ||= l(:field_due_date)
    @cached_label_assigned_to ||= l(:field_assigned_to)
    @cached_label_priority ||= l(:field_priority)
edavis10's avatar
edavis10 committed
61 62
    @cached_label_project ||= l(:field_project)

63 64 65 66 67
    link_to_issue(issue) + "<br /><br />".html_safe +
      "<strong>#{@cached_label_project}</strong>: #{link_to_project(issue.project)}<br />".html_safe +
      "<strong>#{@cached_label_status}</strong>: #{h(issue.status.name)}<br />".html_safe +
      "<strong>#{@cached_label_start_date}</strong>: #{format_date(issue.start_date)}<br />".html_safe +
      "<strong>#{@cached_label_due_date}</strong>: #{format_date(issue.due_date)}<br />".html_safe +
68
      "<strong>#{@cached_label_assigned_to}</strong>: #{avatar(issue.assigned_to, :size => "13", :title => l(:field_assigned_to)) if issue.assigned_to} #{h(issue.assigned_to)}<br />".html_safe +
69
      "<strong>#{@cached_label_priority}</strong>: #{h(issue.priority.name)}".html_safe
70
  end
71

72 73 74
  def issue_heading(issue)
    h("#{issue.tracker} ##{issue.id}")
  end
75

jplang's avatar
jplang committed
76 77
  def render_issue_subject_with_tree(issue)
    s = ''
jplang's avatar
jplang committed
78
    ancestors = issue.root? ? [] : issue.ancestors.visible.to_a
79
    ancestors.each do |ancestor|
80
      s << '<div>' + content_tag('p', link_to_issue(ancestor, :project => (issue.project_id != ancestor.project_id)))
jplang's avatar
jplang committed
81
    end
jplang's avatar
jplang committed
82 83 84
    s << '<div>'
    subject = h(issue.subject)
    if issue.is_private?
85
      subject = subject + ' ' + content_tag('span', l(:field_is_private), :class => 'private')
jplang's avatar
jplang committed
86 87
    end
    s << content_tag('h3', subject)
88
    s << '</div>' * (ancestors.size + 1)
89
    s.html_safe
jplang's avatar
jplang committed
90
  end
91

jplang's avatar
jplang committed
92
  def render_descendants_tree(issue)
93
    manage_relations = User.current.allowed_to?(:manage_subtasks, issue.project)
94
    s = '<table class="list issues odd-even">'
jplang's avatar
jplang committed
95
    issue_list(issue.descendants.visible.preload(:status, :priority, :tracker, :assigned_to).sort_by(&:lft)) do |child, level|
96
      css = "issue issue-#{child.id} hascontextmenu #{child.css_classes}"
jplang's avatar
jplang committed
97
      css << " idnt idnt-#{level}" if level > 0
98 99 100 101 102 103 104 105 106
      buttons = manage_relations ? link_to(l(:label_delete_link_to_subtask),
                                  issue_path({:id => child.id, :issue => {:parent_issue_id => ''}, :back_url => issue_path(issue.id), :no_flash => '1'}),
                                  :method => :put,
                                  :data => {:confirm => l(:text_are_you_sure)},
                                  :title => l(:label_delete_link_to_subtask),
                                  :class => 'icon-only icon-link-break'
                                  ) : "".html_safe
      buttons << link_to_context_menu

jplang's avatar
jplang committed
107
      s << content_tag('tr',
108
             content_tag('td', check_box_tag("ids[]", child.id, false, :id => nil), :class => 'checkbox') +
109
             content_tag('td', link_to_issue(child, :project => (issue.project_id != child.project_id)), :class => 'subject', :style => 'width: 50%') +
110 111
             content_tag('td', h(child.status), :class => 'status') +
             content_tag('td', link_to_user(child.assigned_to), :class => 'assigned_to') +
112
             content_tag('td', child.disabled_core_fields.include?('done_ratio') ? '' : progress_bar(child.done_ratio), :class=> 'done_ratio') +
113
             content_tag('td', buttons, :class => 'buttons'),
jplang's avatar
jplang committed
114
             :class => css)
jplang's avatar
jplang committed
115
    end
116
    s << '</table>'
117
    s.html_safe
jplang's avatar
jplang committed
118
  end
119

120 121 122 123 124 125 126 127
  # Renders the list of related issues on the issue details view
  def render_issue_relations(issue, relations)
    manage_relations = User.current.allowed_to?(:manage_issue_relations, issue.project)

    s = ''.html_safe
    relations.each do |relation|
      other_issue = relation.other_issue(issue)
      css = "issue hascontextmenu #{other_issue.css_classes}"
128
      buttons = manage_relations ? link_to(l(:label_relation_delete),
129 130 131 132 133 134
                                  relation_path(relation),
                                  :remote => true,
                                  :method => :delete,
                                  :data => {:confirm => l(:text_are_you_sure)},
                                  :title => l(:label_relation_delete),
                                  :class => 'icon-only icon-link-break'
135 136
                                 ) :"".html_safe
      buttons << link_to_context_menu
137 138 139 140 141

      s << content_tag('tr',
             content_tag('td', check_box_tag("ids[]", other_issue.id, false, :id => nil), :class => 'checkbox') +
             content_tag('td', relation.to_s(@issue) {|other| link_to_issue(other, :project => Setting.cross_project_issue_relations?)}.html_safe, :class => 'subject', :style => 'width: 50%') +
             content_tag('td', other_issue.status, :class => 'status') +
142 143
             content_tag('td', format_date(other_issue.start_date), :class => 'start_date') +
             content_tag('td', format_date(other_issue.due_date), :class => 'due_date') +
144
             content_tag('td', other_issue.disabled_core_fields.include?('done_ratio') ? '' : progress_bar(other_issue.done_ratio), :class=> 'done_ratio') +
145
             content_tag('td', buttons, :class => 'buttons'),
146 147 148 149
             :id => "relation-#{relation.id}",
             :class => css)
    end

150
    content_tag('table', s, :class => 'list issues odd-even')
151 152
  end

153
  def issue_estimated_hours_details(issue)
154 155 156 157 158 159 160 161 162 163 164 165 166
    if issue.total_estimated_hours.present?
      if issue.total_estimated_hours == issue.estimated_hours
        l_hours_short(issue.estimated_hours)
      else
        s = issue.estimated_hours.present? ? l_hours_short(issue.estimated_hours) : ""
        s << " (#{l(:label_total)}: #{l_hours_short(issue.total_estimated_hours)})"
        s.html_safe
      end
    end
  end

  def issue_spent_hours_details(issue)
    if issue.total_spent_hours > 0
167 168
      path = project_time_entries_path(issue.project, :issue_id => "~#{issue.id}")

169
      if issue.total_spent_hours == issue.spent_hours
170
        link_to(l_hours_short(issue.spent_hours), path)
171 172
      else
        s = issue.spent_hours > 0 ? l_hours_short(issue.spent_hours) : ""
173
        s << " (#{l(:label_total)}: #{link_to l_hours_short(issue.total_spent_hours), path})"
174 175
        s.html_safe
      end
176 177 178
    end
  end

179 180
  # Returns a link for adding a new subtask to the given issue
  def link_to_new_subtask(issue)
181 182 183
    attrs = {
      :parent_issue_id => issue
    }
184
    attrs[:tracker_id] = issue.tracker unless issue.tracker.disabled_core_fields.include?('parent_issue_id')
185
    link_to(l(:button_add), new_project_issue_path(issue.project, :issue => attrs, :back_url => issue_path(issue)))
186 187
  end

188 189 190 191 192 193 194 195 196 197
  def trackers_options_for_select(issue)
    trackers = issue.allowed_target_trackers
    if issue.new_record? && issue.parent_issue_id.present?
      trackers = trackers.reject do |tracker|
        issue.tracker_id != tracker.id && tracker.disabled_core_fields.include?('parent_issue_id')
      end
    end
    trackers.collect {|t| [t.name, t.id]}
  end

198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218
  class IssueFieldsRows
    include ActionView::Helpers::TagHelper

    def initialize
      @left = []
      @right = []
    end

    def left(*args)
      args.any? ? @left << cells(*args) : @left
    end

    def right(*args)
      args.any? ? @right << cells(*args) : @right
    end

    def size
      @left.size > @right.size ? @left.size : @right.size
    end

    def to_html
219 220 221 222 223
      content =
        content_tag('div', @left.reduce(&:+), :class => 'splitcontentleft') +
        content_tag('div', @right.reduce(&:+), :class => 'splitcontentleft')

      content_tag('div', content, :class => 'splitcontent')
224 225 226
    end

    def cells(label, text, options={})
227 228 229 230
      options[:class] = [options[:class] || "", 'attribute'].join(' ')
      content_tag 'div',
        content_tag('div', label + ":", :class => 'label') + content_tag('div', text, :class => 'value'),
        options
231 232 233 234 235 236 237 238 239
    end
  end

  def issue_fields_rows
    r = IssueFieldsRows.new
    yield r
    r.to_html
  end

240 241
  def render_half_width_custom_fields_rows(issue)
    values = issue.visible_custom_field_values.reject {|value| value.custom_field.full_width_layout?}
242 243
    return if values.empty?
    half = (values.size / 2.0).ceil
244 245 246 247
    issue_fields_rows do |rows|
      values.each_with_index do |value, i|
        css = "cf_#{value.custom_field.id}"
        m = (i < half ? :left : :right)
248
        rows.send m, custom_field_name_tag(value.custom_field), custom_field_value_tag(value), :class => css
249 250
      end
    end
251
  end
252

253 254 255 256
  def render_full_width_custom_fields_rows(issue)
    values = issue.visible_custom_field_values.select {|value| value.custom_field.full_width_layout?}
    return if values.empty?

jplang's avatar
jplang committed
257
    s = ''.html_safe
258
    values.each_with_index do |value, i|
259 260
      attr_value_tag = custom_field_value_tag(value)
      next if attr_value_tag.blank?
261

262 263 264
      content =
          content_tag('hr') +
          content_tag('p', content_tag('strong', custom_field_name_tag(value.custom_field) )) +
265
          content_tag('div', attr_value_tag, class: 'value')
266 267
      s << content_tag('div', content, class: "cf_#{value.custom_field.id} attribute")
    end
jplang's avatar
jplang committed
268
    s
269 270
  end

271 272 273
  # Returns the path for updating the issue form
  # with project as the current project
  def update_issue_form_path(project, issue)
274
    options = {:format => 'js'}
275
    if issue.new_record?
276 277 278 279 280
      if project
        new_project_issue_path(project, options)
      else
        new_issue_path(options)
      end
281
    else
282
      edit_issue_path(issue, options)
283 284 285
    end
  end

286 287 288 289 290 291 292
  # Returns the number of descendants for an array of issues
  def issues_descendant_count(issues)
    ids = issues.reject(&:leaf?).map {|issue| issue.descendants.ids}.flatten.uniq
    ids -= issues.map(&:id)
    ids.size
  end

293 294 295
  def issues_destroy_confirmation_message(issues)
    issues = [issues] unless issues.is_a?(Array)
    message = l(:text_issues_destroy_confirmation)
296

297
    descendant_count = issues_descendant_count(issues)
298
    if descendant_count > 0
299
      message << "\n" + l(:text_issues_destroy_descendants_confirmation, :count => descendant_count)
300 301 302
    end
    message
  end
303

304 305 306
  # Returns an array of users that are proposed as watchers
  # on the new issue form
  def users_for_new_issue_watchers(issue)
307
    users = issue.watcher_users.select{|u| u.status == User::STATUS_ACTIVE}
308 309 310 311 312 313
    if issue.project.users.count <= 20
      users = (users + issue.project.users.sort).uniq
    end
    users
  end

314
  def email_issue_attributes(issue, user, html)
315
    items = []
316 317
    %w(author status priority assigned_to category fixed_version start_date due_date).each do |attribute|
      if issue.disabled_core_fields.grep(/^#{attribute}(_id)?$/).empty?
318 319 320 321 322
        if html
          items << content_tag('strong', "#{l("field_#{attribute}")}: ") + (issue.send attribute)
        else
          items << "#{l("field_#{attribute}")}: #{issue.send attribute}"
        end
323 324 325
      end
    end
    issue.visible_custom_field_values(user).each do |value|
326 327 328 329 330
      if html
        items << content_tag('strong', "#{value.custom_field.name}: ") + show_value(value, false)
      else
        items << "#{value.custom_field.name}: #{show_value(value, false)}"
      end
331 332 333 334 335
    end
    items
  end

  def render_email_issue_attributes(issue, user, html=false)
336
    items = email_issue_attributes(issue, user, html)
337
    if html
338
      content_tag('ul', items.map{|s| content_tag('li', s)}.join("\n").html_safe, :class => "details")
339 340 341 342 343
    else
      items.map{|s| "* #{s}"}.join("\n")
    end
  end

344 345
  MultipleValuesDetail = Struct.new(:property, :prop_key, :custom_field, :old_value, :value)

346 347
  # Returns the textual representation of a journal details
  # as an array of strings
348 349
  def details_to_strings(details, no_html=false, options={})
    options[:only_path] = (options[:only_path] == false ? false : true)
350 351 352 353
    strings = []
    values_by_field = {}
    details.each do |detail|
      if detail.property == 'cf'
354
        field = detail.custom_field
355
        if field && field.multiple?
356
          values_by_field[field] ||= {:added => [], :deleted => []}
357
          if detail.old_value
358
            values_by_field[field][:deleted] << detail.old_value
359 360
          end
          if detail.value
361
            values_by_field[field][:added] << detail.value
362 363 364 365
          end
          next
        end
      end
366
      strings << show_detail(detail, no_html, options)
367
    end
368 369 370
    if values_by_field.present?
      values_by_field.each do |field, changes|
        if changes[:added].any?
371
          detail = MultipleValuesDetail.new('cf', field.id.to_s, field)
372 373 374 375
          detail.value = changes[:added]
          strings << show_detail(detail, no_html, options)
        end
        if changes[:deleted].any?
376
          detail = MultipleValuesDetail.new('cf', field.id.to_s, field)
377 378 379
          detail.old_value = changes[:deleted]
          strings << show_detail(detail, no_html, options)
        end
380 381 382 383 384 385
      end
    end
    strings
  end

  # Returns the textual representation of a single journal detail
386
  def show_detail(detail, no_html=false, options={})
387
    multiple = false
388
    show_diff = false
389
    no_details = false
390

391 392
    case detail.property
    when 'attr'
393 394
      field = detail.prop_key.to_s.gsub(/\_id$/, "")
      label = l(("field_" + field).to_sym)
jplang's avatar
jplang committed
395 396
      case detail.prop_key
      when 'due_date', 'start_date'
397 398
        value = format_date(detail.value.to_date) if detail.value
        old_value = format_date(detail.old_value.to_date) if detail.old_value
399

jplang's avatar
jplang committed
400 401
      when 'project_id', 'status_id', 'tracker_id', 'assigned_to_id',
            'priority_id', 'category_id', 'fixed_version_id'
402 403
        value = find_name_by_reflection(field, detail.value)
        old_value = find_name_by_reflection(field, detail.old_value)
404

jplang's avatar
jplang committed
405
      when 'estimated_hours'
406 407
        value = l_hours_short(detail.value.to_f) unless detail.value.blank?
        old_value = l_hours_short(detail.old_value.to_f) unless detail.old_value.blank?
408

jplang's avatar
jplang committed
409
      when 'parent_id'
410 411 412
        label = l(:field_parent_issue)
        value = "##{detail.value}" unless detail.value.blank?
        old_value = "##{detail.old_value}" unless detail.old_value.blank?
413

jplang's avatar
jplang committed
414
      when 'is_private'
jplang's avatar
jplang committed
415 416
        value = l(detail.value == "0" ? :general_text_No : :general_text_Yes) unless detail.value.blank?
        old_value = l(detail.old_value == "0" ? :general_text_No : :general_text_Yes) unless detail.old_value.blank?
417 418 419

      when 'description'
        show_diff = true
420 421
      end
    when 'cf'
422
      custom_field = detail.custom_field
423 424
      if custom_field
        label = custom_field.name
425 426 427
        if custom_field.format.class.change_no_details
          no_details = true
        elsif custom_field.format.class.change_as_diff
428 429 430 431 432 433
          show_diff = true
        else
          multiple = custom_field.multiple?
          value = format_value(detail.value, custom_field) if detail.value
          old_value = format_value(detail.old_value, custom_field) if detail.old_value
        end
434
      end
435 436
    when 'attachment'
      label = l(:label_attachment)
437 438
    when 'relation'
      if detail.value && !detail.old_value
439
        rel_issue = Issue.visible.find_by_id(detail.value)
440
        value = rel_issue.nil? ? "#{l(:label_issue)} ##{detail.value}" :
441
                  (no_html ? rel_issue : link_to_issue(rel_issue, :only_path => options[:only_path]))
442
      elsif detail.old_value && !detail.value
443
        rel_issue = Issue.visible.find_by_id(detail.old_value)
444
        old_value = rel_issue.nil? ? "#{l(:label_issue)} ##{detail.old_value}" :
445
                          (no_html ? rel_issue : link_to_issue(rel_issue, :only_path => options[:only_path]))
446
      end
447 448
      relation_type = IssueRelation::TYPES[detail.prop_key]
      label = l(relation_type[:name]) if relation_type
449
    end
450 451
    call_hook(:helper_issues_show_detail_after_setting,
              {:detail => detail, :label => label, :value => value, :old_value => old_value })
452

453 454 455
    label ||= detail.prop_key
    value ||= detail.value
    old_value ||= detail.old_value
456

jplang's avatar
jplang committed
457
    unless no_html
458 459
      label = content_tag('strong', label)
      old_value = content_tag("i", h(old_value)) if detail.old_value
460 461 462
      if detail.old_value && detail.value.blank? && detail.property != 'relation'
        old_value = content_tag("del", old_value)
      end
463 464
      if detail.property == 'attachment' && value.present? &&
          atta = detail.journal.journalized.attachments.detect {|a| a.id == detail.prop_key.to_i}
465
        # Link to the attachment if it has not been removed
466 467
        value = link_to_attachment(atta, only_path: options[:only_path])
        if options[:only_path] != false
468
          value += ' '
469
          value += link_to_attachment atta, class: 'icon-only icon-download', title: l(:button_download), download: true
470
        end
471 472 473
      else
        value = content_tag("i", h(value)) if value
      end
474
    end
475

476 477 478
    if no_details
      s = l(:text_journal_changed_no_detail, :label => label).html_safe
    elsif show_diff
479 480
      s = l(:text_journal_changed_no_detail, :label => label)
      unless no_html
481
        diff_link = link_to 'diff',
482
          diff_journal_url(detail.journal_id, :detail_id => detail.id, :only_path => options[:only_path]),
483 484 485
          :title => l(:label_view_diff)
        s << " (#{ diff_link })"
      end
486
      s.html_safe
jplang's avatar
jplang committed
487
    elsif detail.value.present?
488 489
      case detail.property
      when 'attr', 'cf'
jplang's avatar
jplang committed
490
        if detail.old_value.present?
491
          l(:text_journal_changed, :label => label, :old => old_value, :new => value).html_safe
492 493
        elsif multiple
          l(:text_journal_added, :label => label, :value => value).html_safe
494
        else
495
          l(:text_journal_set_to, :label => label, :value => value).html_safe
496
        end
497
      when 'attachment', 'relation'
498
        l(:text_journal_added, :label => label, :value => value).html_safe
499 500
      end
    else
501
      l(:text_journal_deleted, :label => label, :old => old_value).html_safe
502
    end
jplang's avatar
jplang committed
503
  end
504 505 506

  # Find the name of an associated record stored in the field attribute
  def find_name_by_reflection(field, id)
507 508 509
    unless id.present?
      return nil
    end
510 511
    @detail_value_name_by_reflection ||= Hash.new do |hash, key|
      association = Issue.reflect_on_association(key.first.to_sym)
512
      name = nil
513
      if association
514
        record = association.klass.find_by_id(key.last)
515
        if record
516
          name = record.name.force_encoding('UTF-8')
517
        end
518
      end
519
      hash[key] = name
520
    end
521
    @detail_value_name_by_reflection[[field, id]]
522
  end
523

524 525 526 527 528 529 530 531 532 533 534 535 536
  # Renders issue children recursively
  def render_api_issue_children(issue, api)
    return if issue.leaf?
    api.array :children do
      issue.children.each do |child|
        api.issue(:id => child.id) do
          api.tracker(:id => child.tracker_id, :name => child.tracker.name) unless child.tracker.nil?
          api.subject child.subject
          render_api_issue_children(child, api)
        end
      end
    end
  end
jplang's avatar
jplang committed
537
end