123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644 |
- # frozen_string_literal: true
-
- # Redmine - project management software
- # Copyright (C) 2006-2020 Jean-Philippe Lang
- #
- # 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 IssuesHelper
- include ApplicationHelper
- include Redmine::Export::PDF::IssuesPdfHelper
-
- 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
- ancestors << issue unless issue.leaf?
- end
- end
-
- def grouped_issue_list(issues, query, &block)
- ancestors = []
- grouped_query_results(issues, query) do |issue, group_name, group_count, group_totals|
- while ancestors.any? &&
- !issue.is_descendant_of?(ancestors.last)
- ancestors.pop
- end
- yield issue, ancestors.size, group_name, group_count, group_totals
- ancestors << issue unless issue.leaf?
- end
- end
-
- # 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>
- #
- def render_issue_tooltip(issue)
- @cached_label_status ||= l(:field_status)
- @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)
- @cached_label_project ||= l(:field_project)
-
- 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) + (" (#{format_date(issue.closed_on)})" if issue.closed?)}<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 +
- "<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 +
- "<strong>#{@cached_label_priority}</strong>: #{h(issue.priority.name)}".html_safe
- end
-
- def issue_heading(issue)
- h("#{issue.tracker} ##{issue.id}")
- end
-
- def render_issue_subject_with_tree(issue)
- s = +''
- ancestors = issue.root? ? [] : issue.ancestors.visible.to_a
- ancestors.each do |ancestor|
- s << '<div>' + content_tag('p', link_to_issue(ancestor, :project => (issue.project_id != ancestor.project_id)))
- end
- s << '<div>'
- subject = h(issue.subject)
- if issue.is_private?
- subject = subject + ' ' + content_tag('span', l(:field_is_private), :class => 'badge badge-private private')
- end
- s << content_tag('h3', subject)
- s << '</div>' * (ancestors.size + 1)
- s.html_safe
- end
-
- def render_descendants_tree(issue)
- manage_relations = User.current.allowed_to?(:manage_subtasks, issue.project)
- s = +'<table class="list issues odd-even">'
- issue_list(
- issue.descendants.visible.
- preload(:status, :priority, :tracker,
- :assigned_to).sort_by(&:lft)) do |child, level|
- css = +"issue issue-#{child.id} hascontextmenu #{child.css_classes}"
- css << " idnt idnt-#{level}" if level > 0
- buttons =
- if 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'
- )
- else
- "".html_safe
- end
- buttons << link_to_context_menu
- s <<
- content_tag(
- 'tr',
- content_tag('td', check_box_tag("ids[]", child.id, false, :id => nil),
- :class => 'checkbox') +
- content_tag('td',
- link_to_issue(
- child,
- :project => (issue.project_id != child.project_id)),
- :class => 'subject') +
- content_tag('td', h(child.status), :class => 'status') +
- content_tag('td', format_date(child.start_date), :class => 'start_date') +
- content_tag('td', format_date(child.due_date), :class => 'due_date') +
- content_tag('td', link_to_user(child.assigned_to), :class => 'assigned_to') +
- content_tag('td',
- (if child.disabled_core_fields.include?('done_ratio')
- ''
- else
- progress_bar(child.done_ratio)
- end),
- :class=> 'done_ratio') +
- content_tag('td', buttons, :class => 'buttons'),
- :class => css)
- end
- s << '</table>'
- s.html_safe
- end
-
- # 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}"
- buttons =
- if manage_relations
- link_to(
- l(:label_relation_delete),
- 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'
- )
- else
- "".html_safe
- end
- buttons << link_to_context_menu
- 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') +
- content_tag('td', other_issue.status, :class => 'status') +
- content_tag('td', format_date(other_issue.start_date), :class => 'start_date') +
- content_tag('td', format_date(other_issue.due_date), :class => 'due_date') +
- content_tag('td', link_to_user(other_issue.assigned_to), :class => 'assigned_to') +
- content_tag('td',
- (if other_issue.disabled_core_fields.include?('done_ratio')
- ''
- else
- progress_bar(other_issue.done_ratio)
- end),
- :class=> 'done_ratio') +
- content_tag('td', buttons, :class => 'buttons'),
- :id => "relation-#{relation.id}",
- :class => css)
- end
- content_tag('table', s, :class => 'list issues odd-even')
- end
-
- def issue_estimated_hours_details(issue)
- 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
- path = project_time_entries_path(issue.project, :issue_id => "~#{issue.id}")
-
- if issue.total_spent_hours == issue.spent_hours
- link_to(l_hours_short(issue.spent_hours), path)
- else
- s = issue.spent_hours > 0 ? l_hours_short(issue.spent_hours) : ""
- s += " (#{l(:label_total)}: #{link_to l_hours_short(issue.total_spent_hours), path})"
- s.html_safe
- end
- end
- end
-
- def issue_due_date_details(issue)
- return if issue&.due_date.nil?
- s = format_date(issue.due_date)
- s += " (#{due_date_distance_in_words(issue.due_date)})" unless issue.closed?
- s
- end
-
- # Returns a link for adding a new subtask to the given issue
- def link_to_new_subtask(issue)
- attrs = {
- :parent_issue_id => issue
- }
- attrs[:tracker_id] = issue.tracker unless issue.tracker.disabled_core_fields.include?('parent_issue_id')
- link_to(l(:button_add), new_project_issue_path(issue.project, :issue => attrs, :back_url => issue_path(issue)))
- end
-
- def trackers_options_for_select(issue)
- trackers = trackers_for_select(issue)
- trackers.collect {|t| [t.name, t.id]}
- end
-
- def trackers_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
- end
-
- 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
- content =
- content_tag('div', @left.reduce(&:+), :class => 'splitcontentleft') +
- content_tag('div', @right.reduce(&:+), :class => 'splitcontentleft')
-
- content_tag('div', content, :class => 'splitcontent')
- end
-
- def cells(label, text, options={})
- options[:class] = [options[:class] || "", 'attribute'].join(' ')
- content_tag(
- 'div',
- content_tag('div', label + ":", :class => 'label') +
- content_tag('div', text, :class => 'value'),
- options)
- end
- end
-
- def issue_fields_rows
- r = IssueFieldsRows.new
- yield r
- r.to_html
- end
-
- def render_half_width_custom_fields_rows(issue)
- values = issue.visible_custom_field_values.reject {|value| value.custom_field.full_width_layout?}
- return if values.empty?
- half = (values.size / 2.0).ceil
- issue_fields_rows do |rows|
- values.each_with_index do |value, i|
- m = (i < half ? :left : :right)
- rows.send m, custom_field_name_tag(value.custom_field), custom_field_value_tag(value), :class => value.custom_field.css_classes
- end
- end
- end
-
- 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?
- s = ''.html_safe
- values.each_with_index do |value, i|
- attr_value_tag = custom_field_value_tag(value)
- next if attr_value_tag.blank?
- content =
- content_tag('hr') +
- content_tag('p', content_tag('strong', custom_field_name_tag(value.custom_field) )) +
- content_tag('div', attr_value_tag, class: 'value')
- s << content_tag('div', content, class: "#{value.custom_field.css_classes} attribute")
- end
- s
- end
-
- # Returns the path for updating the issue form
- # with project as the current project
- def update_issue_form_path(project, issue)
- options = {:format => 'js'}
- if issue.new_record?
- if project
- new_project_issue_path(project, options)
- else
- new_issue_path(options)
- end
- else
- edit_issue_path(issue, options)
- end
- end
-
- # 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
-
- def issues_destroy_confirmation_message(issues)
- issues = [issues] unless issues.is_a?(Array)
- message = l(:text_issues_destroy_confirmation)
-
- descendant_count = issues_descendant_count(issues)
- if descendant_count > 0
- message << "\n" + l(:text_issues_destroy_descendants_confirmation, :count => descendant_count)
- end
- message
- end
-
- # Returns an array of users that are proposed as watchers
- # on the new issue form
- def users_for_new_issue_watchers(issue)
- users = issue.watcher_users.select{|u| u.status == User::STATUS_ACTIVE}
- project = issue.project
- scope_users = project.users
- scope_groups = project.principals.merge(Group.givable)
- if scope_users.count + scope_groups.count <= 20
- users = (users + scope_users.sort + scope_groups.sort).uniq
- end
- users
- end
-
- def email_issue_attributes(issue, user, html)
- items = []
- %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?
- attr_value = (issue.send attribute).to_s
- next if attr_value.blank?
- if html
- items << content_tag('strong', "#{l("field_#{attribute}")}: ") + attr_value
- else
- items << "#{l("field_#{attribute}")}: #{attr_value}"
- end
- end
- end
- issue.visible_custom_field_values(user).each do |value|
- cf_value = show_value(value, false)
- next if cf_value.blank?
- if html
- items << content_tag('strong', "#{value.custom_field.name}: ") + cf_value
- else
- items << "#{value.custom_field.name}: #{cf_value}"
- end
- end
- items
- end
-
- def render_email_issue_attributes(issue, user, html=false)
- items = email_issue_attributes(issue, user, html)
- if html
- content_tag('ul', items.map{|s| content_tag('li', s)}.join("\n").html_safe, :class => "details")
- else
- items.map{|s| "* #{s}"}.join("\n")
- end
- end
-
- MultipleValuesDetail = Struct.new(:property, :prop_key, :custom_field, :old_value, :value)
-
- # Returns the textual representation of a journal details
- # as an array of strings
- def details_to_strings(details, no_html=false, options={})
- options[:only_path] = !(options[:only_path] == false)
- strings = []
- values_by_field = {}
- details.each do |detail|
- if detail.property == 'cf'
- field = detail.custom_field
- if field && field.multiple?
- values_by_field[field] ||= {:added => [], :deleted => []}
- if detail.old_value
- values_by_field[field][:deleted] << detail.old_value
- end
- if detail.value
- values_by_field[field][:added] << detail.value
- end
- next
- end
- end
- strings << show_detail(detail, no_html, options)
- end
- if values_by_field.present?
- values_by_field.each do |field, changes|
- if changes[:added].any?
- detail = MultipleValuesDetail.new('cf', field.id.to_s, field)
- detail.value = changes[:added]
- strings << show_detail(detail, no_html, options)
- end
- if changes[:deleted].any?
- detail = MultipleValuesDetail.new('cf', field.id.to_s, field)
- detail.old_value = changes[:deleted]
- strings << show_detail(detail, no_html, options)
- end
- end
- end
- strings
- end
-
- # Returns the textual representation of a single journal detail
- def show_detail(detail, no_html=false, options={})
- multiple = false
- show_diff = false
- no_details = false
-
- case detail.property
- when 'attr'
- field = detail.prop_key.to_s.gsub(/\_id$/, "")
- label = l(("field_" + field).to_sym)
- case detail.prop_key
- when 'due_date', 'start_date'
- value = format_date(detail.value.to_date) if detail.value
- old_value = format_date(detail.old_value.to_date) if detail.old_value
-
- when 'project_id', 'status_id', 'tracker_id', 'assigned_to_id',
- 'priority_id', 'category_id', 'fixed_version_id'
- value = find_name_by_reflection(field, detail.value)
- old_value = find_name_by_reflection(field, detail.old_value)
-
- when 'estimated_hours'
- 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?
-
- when 'parent_id'
- label = l(:field_parent_issue)
- value = "##{detail.value}" unless detail.value.blank?
- old_value = "##{detail.old_value}" unless detail.old_value.blank?
-
- when 'is_private'
- 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?
-
- when 'description'
- show_diff = true
- end
- when 'cf'
- custom_field = detail.custom_field
- if custom_field
- label = custom_field.name
- if custom_field.format.class.change_no_details
- no_details = true
- elsif custom_field.format.class.change_as_diff
- 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
- end
- when 'attachment'
- label = l(:label_attachment)
- when 'relation'
- if detail.value && !detail.old_value
- rel_issue = Issue.visible.find_by_id(detail.value)
- value =
- if rel_issue.nil?
- "#{l(:label_issue)} ##{detail.value}"
- else
- (no_html ? rel_issue : link_to_issue(rel_issue, :only_path => options[:only_path]))
- end
- elsif detail.old_value && !detail.value
- rel_issue = Issue.visible.find_by_id(detail.old_value)
- old_value =
- if rel_issue.nil?
- "#{l(:label_issue)} ##{detail.old_value}"
- else
- (no_html ? rel_issue : link_to_issue(rel_issue, :only_path => options[:only_path]))
- end
- end
- relation_type = IssueRelation::TYPES[detail.prop_key]
- label = l(relation_type[:name]) if relation_type
- end
- call_hook(:helper_issues_show_detail_after_setting,
- {:detail => detail, :label => label, :value => value, :old_value => old_value })
-
- label ||= detail.prop_key
- value ||= detail.value
- old_value ||= detail.old_value
-
- unless no_html
- label = content_tag('strong', label)
- old_value = content_tag("i", h(old_value)) if detail.old_value
- if detail.old_value && detail.value.blank? && detail.property != 'relation'
- old_value = content_tag("del", old_value)
- end
- if detail.property == 'attachment' && value.present? &&
- atta = detail.journal.journalized.attachments.detect {|a| a.id == detail.prop_key.to_i}
- # Link to the attachment if it has not been removed
- value = link_to_attachment(atta, only_path: options[:only_path])
- if options[:only_path] != false
- value += ' '
- value += link_to_attachment atta, class: 'icon-only icon-download', title: l(:button_download), download: true
- end
- else
- value = content_tag("i", h(value)) if value
- end
- end
-
- if no_details
- s = l(:text_journal_changed_no_detail, :label => label).html_safe
- elsif show_diff
- s = l(:text_journal_changed_no_detail, :label => label)
- unless no_html
- diff_link =
- link_to(
- 'diff',
- diff_journal_url(detail.journal_id, :detail_id => detail.id,
- :only_path => options[:only_path]),
- :title => l(:label_view_diff))
- s << " (#{diff_link})"
- end
- s.html_safe
- elsif detail.value.present?
- case detail.property
- when 'attr', 'cf'
- if detail.old_value.present?
- l(:text_journal_changed, :label => label, :old => old_value, :new => value).html_safe
- elsif multiple
- l(:text_journal_added, :label => label, :value => value).html_safe
- else
- l(:text_journal_set_to, :label => label, :value => value).html_safe
- end
- when 'attachment', 'relation'
- l(:text_journal_added, :label => label, :value => value).html_safe
- end
- else
- l(:text_journal_deleted, :label => label, :old => old_value).html_safe
- end
- end
-
- # Find the name of an associated record stored in the field attribute
- def find_name_by_reflection(field, id)
- return nil if id.blank?
- @detail_value_name_by_reflection ||= Hash.new do |hash, key|
- association = Issue.reflect_on_association(key.first.to_sym)
- name = nil
- if association
- record = association.klass.find_by_id(key.last)
- if record
- name = record.name.force_encoding('UTF-8')
- end
- end
- hash[key] = name
- end
- @detail_value_name_by_reflection[[field, id]]
- end
-
- # 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
-
- # Issue history tabs
- def issue_history_tabs
- tabs = []
- if @journals.present?
- journals_without_notes = @journals.select{|value| value.notes.blank?}
- journals_with_notes = @journals.reject{|value| value.notes.blank?}
-
- tabs << {:name => 'history', :label => :label_history, :onclick => 'showIssueHistory("history", this.href)', :partial => 'issues/tabs/history', :locals => {:issue => @issue, :journals => @journals}}
- tabs << {:name => 'notes', :label => :label_issue_history_notes, :onclick => 'showIssueHistory("notes", this.href)'} if journals_with_notes.any?
- tabs << {:name => 'properties', :label => :label_issue_history_properties, :onclick => 'showIssueHistory("properties", this.href)'} if journals_without_notes.any?
- end
- tabs << {:name => 'time_entries', :label => :label_time_entry_plural, :remote => true, :onclick => "getRemoteTab('time_entries', '#{tab_issue_path(@issue, :name => 'time_entries')}', '#{issue_path(@issue, :tab => 'time_entries')}')"} if User.current.allowed_to?(:view_time_entries, @project) && @issue.spent_hours > 0
- tabs << {:name => 'changesets', :label => :label_associated_revisions, :remote => true, :onclick => "getRemoteTab('changesets', '#{tab_issue_path(@issue, :name => 'changesets')}', '#{issue_path(@issue, :tab => 'changesets')}')"} if @has_changesets
- tabs
- end
-
- def issue_history_default_tab
- # tab params overrides user default tab preference
- return params[:tab] if params[:tab].present?
- user_default_tab = User.current.pref.history_default_tab
-
- case user_default_tab
- when 'last_tab_visited'
- cookies['history_last_tab'].presence || 'notes'
- when ''
- 'notes'
- else
- user_default_tab
- end
- end
-
- end
|