issues_helper.rb
488 lines
| 16.7 KiB
| text/x-ruby
|
RubyLexer
|
r8090 | # encoding: utf-8 | ||
# | ||||
|
r4834 | # Redmine - project management software | ||
|
r13490 | # Copyright (C) 2006-2015 Jean-Philippe Lang | ||
|
r330 | # | ||
# 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. | ||||
|
r5711 | # | ||
|
r330 | # 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. | ||||
|
r5711 | # | ||
|
r330 | # 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 | ||||
|
r928 | include ApplicationHelper | ||
|
r13562 | include Redmine::Export::PDF::IssuesPdfHelper | ||
|
r330 | |||
|
r3504 | 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 | ||||
|
r3506 | ancestors << issue unless issue.leaf? | ||
|
r3504 | end | ||
end | ||||
|
r4052 | |||
|
r13590 | def grouped_issue_list(issues, query, issue_count_by_group, &block) | ||
previous_group, first = false, true | ||||
issue_list(issues) do |issue, level| | ||||
group_name = group_count = nil | ||||
if query.grouped? && ((group = query.group_by_column.value(issue)) != previous_group || first) | ||||
if group.blank? && group != false | ||||
|
r13597 | group_name = "(#{l(:label_blank_value)})" | ||
|
r13590 | else | ||
group_name = column_content(query.group_by_column, issue) | ||||
end | ||||
group_name ||= "" | ||||
group_count = issue_count_by_group[group] | ||||
end | ||||
yield issue, level, group_name, group_count | ||||
previous_group, first = group, false | ||||
end | ||||
end | ||||
|
r4052 | # 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> | ||||
# | ||||
|
r783 | def render_issue_tooltip(issue) | ||
|
r3838 | @cached_label_status ||= l(:field_status) | ||
|
r783 | @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) | ||||
|
r3958 | @cached_label_project ||= l(:field_project) | ||
|
r8334 | 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 + | ||||
"<strong>#{@cached_label_assigned_to}</strong>: #{h(issue.assigned_to)}<br />".html_safe + | ||||
"<strong>#{@cached_label_priority}</strong>: #{h(issue.priority.name)}".html_safe | ||||
|
r783 | end | ||
|
r5711 | |||
|
r5327 | def issue_heading(issue) | ||
h("#{issue.tracker} ##{issue.id}") | ||||
end | ||||
|
r5711 | |||
|
r3459 | def render_issue_subject_with_tree(issue) | ||
s = '' | ||||
|
r13100 | ancestors = issue.root? ? [] : issue.ancestors.visible.to_a | ||
|
r5124 | ancestors.each do |ancestor| | ||
|
r10376 | s << '<div>' + content_tag('p', link_to_issue(ancestor, :project => (issue.project_id != ancestor.project_id))) | ||
|
r3459 | end | ||
|
r5346 | s << '<div>' | ||
subject = h(issue.subject) | ||||
if issue.is_private? | ||||
subject = content_tag('span', l(:field_is_private), :class => 'private') + ' ' + subject | ||||
end | ||||
s << content_tag('h3', subject) | ||||
|
r5124 | s << '</div>' * (ancestors.size + 1) | ||
|
r6376 | s.html_safe | ||
|
r3459 | end | ||
|
r5711 | |||
|
r3459 | def render_descendants_tree(issue) | ||
s = '<form><table class="list issues">' | ||||
|
r5346 | issue_list(issue.descendants.visible.sort_by(&:lft)) do |child, level| | ||
|
r10449 | css = "issue issue-#{child.id} hascontextmenu" | ||
css << " idnt idnt-#{level}" if level > 0 | ||||
|
r3459 | s << content_tag('tr', | ||
|
r3463 | content_tag('td', check_box_tag("ids[]", child.id, false, :id => nil), :class => 'checkbox') + | ||
|
r13414 | content_tag('td', link_to_issue(child, :project => (issue.project_id != child.project_id)), :class => 'subject', :style => 'width: 50%') + | ||
|
r3459 | content_tag('td', h(child.status)) + | ||
content_tag('td', link_to_user(child.assigned_to)) + | ||||
content_tag('td', progress_bar(child.done_ratio, :width => '80px')), | ||||
|
r10449 | :class => css) | ||
|
r3459 | end | ||
|
r7941 | s << '</table></form>' | ||
|
r6377 | s.html_safe | ||
|
r3459 | end | ||
|
r5711 | |||
|
r11556 | # Returns an array of error messages for bulk edited issues | ||
def bulk_edit_error_messages(issues) | ||||
messages = {} | ||||
issues.each do |issue| | ||||
issue.errors.full_messages.each do |message| | ||||
messages[message] ||= [] | ||||
messages[message] << issue | ||||
end | ||||
end | ||||
messages.map { |message, issues| | ||||
"#{message}: " + issues.map {|i| "##{i.id}"}.join(', ') | ||||
} | ||||
end | ||||
|
r10450 | # Returns a link for adding a new subtask to the given issue | ||
def link_to_new_subtask(issue) | ||||
|
r10451 | attrs = { | ||
:tracker_id => issue.tracker, | ||||
:parent_issue_id => issue | ||||
} | ||||
|
r10452 | link_to(l(:button_add), new_project_issue_path(issue.project, :issue => attrs)) | ||
|
r10450 | end | ||
|
r9729 | 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 | ||||
html = ''.html_safe | ||||
blank = content_tag('th', '') + content_tag('td', '') | ||||
size.times do |i| | ||||
left = @left[i] || blank | ||||
right = @right[i] || blank | ||||
html << content_tag('tr', left + right) | ||||
end | ||||
html | ||||
end | ||||
def cells(label, text, options={}) | ||||
content_tag('th', "#{label}:", options) + content_tag('td', text, options) | ||||
end | ||||
end | ||||
def issue_fields_rows | ||||
r = IssueFieldsRows.new | ||||
yield r | ||||
r.to_html | ||||
end | ||||
|
r2722 | def render_custom_fields_rows(issue) | ||
|
r11782 | values = issue.visible_custom_field_values | ||
return if values.empty? | ||||
|
r2722 | ordered_values = [] | ||
|
r11782 | half = (values.size / 2.0).ceil | ||
|
r2722 | half.times do |i| | ||
|
r11782 | ordered_values << values[i] | ||
ordered_values << values[i + half] | ||||
|
r2722 | end | ||
s = "<tr>\n" | ||||
n = 0 | ||||
ordered_values.compact.each do |value| | ||||
|
r12125 | css = "cf_#{value.custom_field.id}" | ||
|
r2722 | s << "</tr>\n<tr>\n" if n > 0 && (n % 2) == 0 | ||
|
r12125 | s << "\t<th class=\"#{css}\">#{ h(value.custom_field.name) }:</th><td class=\"#{css}\">#{ h(show_value(value)) }</td>\n" | ||
|
r2722 | n += 1 | ||
end | ||||
s << "</tr>\n" | ||||
|
r6378 | s.html_safe | ||
|
r2722 | end | ||
|
r5711 | |||
|
r13615 | # Returns the path for updating the issue form | ||
# with project as the current project | ||||
def update_issue_form_path(project, issue) | ||||
|
r13617 | options = {:format => 'js'} | ||
|
r13615 | if issue.new_record? | ||
|
r13617 | if project | ||
new_project_issue_path(project, options) | ||||
else | ||||
new_issue_path(options) | ||||
end | ||||
|
r13615 | else | ||
|
r13617 | edit_issue_path(issue, options) | ||
|
r13615 | end | ||
end | ||||
|
r13436 | # 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 | ||||
|
r5375 | def issues_destroy_confirmation_message(issues) | ||
issues = [issues] unless issues.is_a?(Array) | ||||
message = l(:text_issues_destroy_confirmation) | ||||
|
r13436 | |||
descendant_count = issues_descendant_count(issues) | ||||
|
r5375 | if descendant_count > 0 | ||
|
r13436 | message << "\n" + l(:text_issues_destroy_descendants_confirmation, :count => descendant_count) | ||
|
r5375 | end | ||
message | ||||
end | ||||
|
r5711 | |||
|
r13613 | # 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 | ||||
if issue.project.users.count <= 20 | ||||
users = (users + issue.project.users.sort).uniq | ||||
end | ||||
users | ||||
end | ||||
|
r1296 | def sidebar_queries | ||
unless @sidebar_queries | ||||
|
r11238 | @sidebar_queries = IssueQuery.visible. | ||
order("#{Query.table_name}.name ASC"). | ||||
|
r7966 | # Project specific queries and global queries | ||
|
r11238 | where(@project.nil? ? ["project_id IS NULL"] : ["project_id IS NULL OR project_id = ?", @project.id]). | ||
|
r13100 | to_a | ||
|
r1296 | end | ||
@sidebar_queries | ||||
end | ||||
|
r783 | |||
|
r4788 | def query_links(title, queries) | ||
|
r11237 | return '' if queries.empty? | ||
|
r4789 | # links to #index on issues/show | ||
url_params = controller_name == 'issues' ? {:controller => 'issues', :action => 'index', :project_id => @project} : params | ||||
|
r5711 | |||
|
r11239 | content_tag('h3', title) + "\n" + | ||
|
r11236 | content_tag('ul', | ||
queries.collect {|query| | ||||
css = 'query' | ||||
css << ' selected' if query == @query | ||||
|
r11239 | content_tag('li', link_to(query.name, url_params.merge(:query_id => query), :class => css)) | ||
|
r11236 | }.join("\n").html_safe, | ||
:class => 'queries' | ||||
) + "\n" | ||||
|
r4788 | end | ||
|
r5711 | |||
|
r4788 | def render_sidebar_queries | ||
|
r8148 | out = ''.html_safe | ||
|
r11764 | out << query_links(l(:label_my_queries), sidebar_queries.select(&:is_private?)) | ||
out << query_links(l(:label_query_plural), sidebar_queries.reject(&:is_private?)) | ||||
|
r4788 | out | ||
end | ||||
|
r11849 | def email_issue_attributes(issue, user) | ||
items = [] | ||||
%w(author status priority assigned_to category fixed_version).each do |attribute| | ||||
unless issue.disabled_core_fields.include?(attribute+"_id") | ||||
items << "#{l("field_#{attribute}")}: #{issue.send attribute}" | ||||
end | ||||
end | ||||
issue.visible_custom_field_values(user).each do |value| | ||||
|
r12125 | items << "#{value.custom_field.name}: #{show_value(value, false)}" | ||
|
r11849 | end | ||
items | ||||
end | ||||
def render_email_issue_attributes(issue, user, html=false) | ||||
items = email_issue_attributes(issue, user) | ||||
if html | ||||
content_tag('ul', items.map{|s| content_tag('li', s)}.join("\n").html_safe) | ||||
else | ||||
items.map{|s| "* #{s}"}.join("\n") | ||||
end | ||||
end | ||||
|
r8601 | # Returns the textual representation of a journal details | ||
# as an array of strings | ||||
|
r8903 | def details_to_strings(details, no_html=false, options={}) | ||
options[:only_path] = (options[:only_path] == false ? false : true) | ||||
|
r8601 | strings = [] | ||
values_by_field = {} | ||||
details.each do |detail| | ||||
if detail.property == 'cf' | ||||
|
r11987 | field = detail.custom_field | ||
|
r8601 | if field && field.multiple? | ||
|
r11987 | values_by_field[field] ||= {:added => [], :deleted => []} | ||
|
r8601 | if detail.old_value | ||
|
r11987 | values_by_field[field][:deleted] << detail.old_value | ||
|
r8601 | end | ||
if detail.value | ||||
|
r11987 | values_by_field[field][:added] << detail.value | ||
|
r8601 | end | ||
next | ||||
end | ||||
end | ||||
|
r8903 | strings << show_detail(detail, no_html, options) | ||
|
r8601 | end | ||
|
r11987 | values_by_field.each do |field, changes| | ||
detail = JournalDetail.new(:property => 'cf', :prop_key => field.id.to_s) | ||||
detail.instance_variable_set "@custom_field", field | ||||
|
r8601 | if changes[:added].any? | ||
detail.value = changes[:added] | ||||
|
r8903 | strings << show_detail(detail, no_html, options) | ||
|
r8601 | elsif changes[:deleted].any? | ||
detail.old_value = changes[:deleted] | ||||
|
r8903 | strings << show_detail(detail, no_html, options) | ||
|
r8601 | end | ||
end | ||||
strings | ||||
end | ||||
# Returns the textual representation of a single journal detail | ||||
|
r8903 | def show_detail(detail, no_html=false, options={}) | ||
|
r8601 | multiple = false | ||
|
r13572 | show_diff = false | ||
|
r330 | case detail.property | ||
when 'attr' | ||||
|
r3439 | field = detail.prop_key.to_s.gsub(/\_id$/, "") | ||
label = l(("field_" + field).to_sym) | ||||
|
r8604 | case detail.prop_key | ||
when 'due_date', 'start_date' | ||||
|
r330 | value = format_date(detail.value.to_date) if detail.value | ||
old_value = format_date(detail.old_value.to_date) if detail.old_value | ||||
|
r3440 | |||
|
r8604 | when 'project_id', 'status_id', 'tracker_id', 'assigned_to_id', | ||
'priority_id', 'category_id', 'fixed_version_id' | ||||
|
r3439 | value = find_name_by_reflection(field, detail.value) | ||
old_value = find_name_by_reflection(field, detail.old_value) | ||||
|
r3440 | |||
|
r8604 | when 'estimated_hours' | ||
|
r1753 | value = "%0.02f" % detail.value.to_f unless detail.value.blank? | ||
old_value = "%0.02f" % detail.old_value.to_f unless detail.old_value.blank? | ||||
|
r3479 | |||
|
r8604 | when 'parent_id' | ||
|
r3479 | label = l(:field_parent_issue) | ||
value = "##{detail.value}" unless detail.value.blank? | ||||
old_value = "##{detail.old_value}" unless detail.old_value.blank? | ||||
|
r5711 | |||
|
r8604 | when 'is_private' | ||
|
r5346 | 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? | ||||
|
r13572 | |||
when 'description' | ||||
show_diff = true | ||||
|
r330 | end | ||
when 'cf' | ||||
|
r11987 | custom_field = detail.custom_field | ||
|
r330 | if custom_field | ||
label = custom_field.name | ||||
|
r13572 | if 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 | ||||
|
r330 | end | ||
|
r422 | when 'attachment' | ||
label = l(:label_attachment) | ||||
|
r11655 | when 'relation' | ||
if detail.value && !detail.old_value | ||||
|
r11709 | rel_issue = Issue.visible.find_by_id(detail.value) | ||
|
r11710 | value = rel_issue.nil? ? "#{l(:label_issue)} ##{detail.value}" : | ||
|
r12140 | (no_html ? rel_issue : link_to_issue(rel_issue, :only_path => options[:only_path])) | ||
|
r11655 | elsif detail.old_value && !detail.value | ||
|
r11709 | rel_issue = Issue.visible.find_by_id(detail.old_value) | ||
|
r11710 | old_value = rel_issue.nil? ? "#{l(:label_issue)} ##{detail.old_value}" : | ||
|
r12140 | (no_html ? rel_issue : link_to_issue(rel_issue, :only_path => options[:only_path])) | ||
|
r11655 | end | ||
|
r12141 | relation_type = IssueRelation::TYPES[detail.prop_key] | ||
label = l(relation_type[:name]) if relation_type | ||||
|
r330 | end | ||
|
r7905 | call_hook(:helper_issues_show_detail_after_setting, | ||
{:detail => detail, :label => label, :value => value, :old_value => old_value }) | ||||
|
r1785 | |||
|
r330 | label ||= detail.prop_key | ||
value ||= detail.value | ||||
old_value ||= detail.old_value | ||||
|
r5711 | |||
|
r9236 | unless no_html | ||
|
r330 | label = content_tag('strong', label) | ||
old_value = content_tag("i", h(old_value)) if detail.old_value | ||||
|
r11656 | if detail.old_value && detail.value.blank? && detail.property != 'relation' | ||
old_value = content_tag("del", old_value) | ||||
end | ||||
|
r13555 | if detail.property == 'attachment' && value.present? && | ||
atta = detail.journal.journalized.attachments.detect {|a| a.id == detail.prop_key.to_i} | ||||
|
r718 | # Link to the attachment if it has not been removed | ||
|
r9192 | value = link_to_attachment(atta, :download => true, :only_path => options[:only_path]) | ||
|
r9199 | if options[:only_path] != false && atta.is_text? | ||
|
r9192 | value += link_to( | ||
image_tag('magnifier.png'), | ||||
:controller => 'attachments', :action => 'show', | ||||
:id => atta, :filename => atta.filename | ||||
) | ||||
end | ||||
|
r718 | else | ||
value = content_tag("i", h(value)) if value | ||||
end | ||||
|
r330 | end | ||
|
r5711 | |||
|
r13572 | if show_diff | ||
|
r4834 | s = l(:text_journal_changed_no_detail, :label => label) | ||
unless no_html | ||||
|
r5711 | diff_link = link_to 'diff', | ||
|
r9191 | {:controller => 'journals', :action => 'diff', :id => detail.journal_id, | ||
:detail_id => detail.id, :only_path => options[:only_path]}, | ||||
|
r4834 | :title => l(:label_view_diff) | ||
s << " (#{ diff_link })" | ||||
end | ||||
|
r7904 | s.html_safe | ||
|
r8604 | elsif detail.value.present? | ||
|
r422 | case detail.property | ||
when 'attr', 'cf' | ||||
|
r8604 | if detail.old_value.present? | ||
|
r7904 | l(:text_journal_changed, :label => label, :old => old_value, :new => value).html_safe | ||
|
r8601 | elsif multiple | ||
l(:text_journal_added, :label => label, :value => value).html_safe | ||||
|
r422 | else | ||
|
r7904 | l(:text_journal_set_to, :label => label, :value => value).html_safe | ||
|
r422 | end | ||
|
r11655 | when 'attachment', 'relation' | ||
|
r7904 | l(:text_journal_added, :label => label, :value => value).html_safe | ||
|
r330 | end | ||
else | ||||
|
r7904 | l(:text_journal_deleted, :label => label, :old => old_value).html_safe | ||
|
r330 | end | ||
|
r52 | end | ||
|
r3439 | |||
# Find the name of an associated record stored in the field attribute | ||||
def find_name_by_reflection(field, id) | ||||
|
r10875 | unless id.present? | ||
return nil | ||||
end | ||||
|
r13556 | @detail_value_name_by_reflection ||= Hash.new do |hash, key| | ||
association = Issue.reflect_on_association(key.first.to_sym) | ||||
|
r13620 | name = nil | ||
|
r13556 | if association | ||
|
r13557 | record = association.klass.find_by_id(key.last) | ||
|
r13556 | if record | ||
|
r13620 | name = record.name.force_encoding('UTF-8') | ||
|
r13556 | end | ||
|
r11407 | end | ||
|
r13620 | hash[key] = name | ||
|
r3439 | end | ||
|
r13556 | @detail_value_name_by_reflection[[field, id]] | ||
|
r3439 | end | ||
|
r5711 | |||
|
r4351 | # 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 | ||||
|
r2 | end | ||