Chris@1295: # encoding: utf-8 Chris@1295: # Chris@1295: # Redmine - project management software Chris@1295: # Copyright (C) 2006-2013 Jean-Philippe Lang Chris@1295: # Chris@1295: # This program is free software; you can redistribute it and/or Chris@1295: # modify it under the terms of the GNU General Public License Chris@1295: # as published by the Free Software Foundation; either version 2 Chris@1295: # of the License, or (at your option) any later version. Chris@1295: # Chris@1295: # This program is distributed in the hope that it will be useful, Chris@1295: # but WITHOUT ANY WARRANTY; without even the implied warranty of Chris@1295: # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the Chris@1295: # GNU General Public License for more details. Chris@1295: # Chris@1295: # You should have received a copy of the GNU General Public License Chris@1295: # along with this program; if not, write to the Free Software Chris@1295: # Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. Chris@1295: Chris@1295: module IssuesHelper Chris@1295: include ApplicationHelper Chris@1295: Chris@1295: def issue_list(issues, &block) Chris@1295: ancestors = [] Chris@1295: issues.each do |issue| Chris@1295: while (ancestors.any? && !issue.is_descendant_of?(ancestors.last)) Chris@1295: ancestors.pop Chris@1295: end Chris@1295: yield issue, ancestors.size Chris@1295: ancestors << issue unless issue.leaf? Chris@1295: end Chris@1295: end Chris@1295: Chris@1295: # Renders a HTML/CSS tooltip Chris@1295: # Chris@1295: # To use, a trigger div is needed. This is a div with the class of "tooltip" Chris@1295: # that contains this method wrapped in a span with the class of "tip" Chris@1295: # Chris@1295: #
<%= link_to_issue(issue) %> Chris@1295: # <%= render_issue_tooltip(issue) %> Chris@1295: #
Chris@1295: # Chris@1295: def render_issue_tooltip(issue) Chris@1295: @cached_label_status ||= l(:field_status) Chris@1295: @cached_label_start_date ||= l(:field_start_date) Chris@1295: @cached_label_due_date ||= l(:field_due_date) Chris@1295: @cached_label_assigned_to ||= l(:field_assigned_to) Chris@1295: @cached_label_priority ||= l(:field_priority) Chris@1295: @cached_label_project ||= l(:field_project) Chris@1295: Chris@1295: link_to_issue(issue) + "

".html_safe + Chris@1295: "#{@cached_label_project}: #{link_to_project(issue.project)}
".html_safe + Chris@1295: "#{@cached_label_status}: #{h(issue.status.name)}
".html_safe + Chris@1295: "#{@cached_label_start_date}: #{format_date(issue.start_date)}
".html_safe + Chris@1295: "#{@cached_label_due_date}: #{format_date(issue.due_date)}
".html_safe + Chris@1295: "#{@cached_label_assigned_to}: #{h(issue.assigned_to)}
".html_safe + Chris@1295: "#{@cached_label_priority}: #{h(issue.priority.name)}".html_safe Chris@1295: end Chris@1295: Chris@1295: def issue_heading(issue) Chris@1295: h("#{issue.tracker} ##{issue.id}") Chris@1295: end Chris@1295: Chris@1295: def render_issue_subject_with_tree(issue) Chris@1295: s = '' Chris@1295: ancestors = issue.root? ? [] : issue.ancestors.visible.all Chris@1295: ancestors.each do |ancestor| Chris@1295: s << '
' + content_tag('p', link_to_issue(ancestor, :project => (issue.project_id != ancestor.project_id))) Chris@1295: end Chris@1295: s << '
' Chris@1295: subject = h(issue.subject) Chris@1295: if issue.is_private? Chris@1295: subject = content_tag('span', l(:field_is_private), :class => 'private') + ' ' + subject Chris@1295: end Chris@1295: s << content_tag('h3', subject) Chris@1295: s << '
' * (ancestors.size + 1) Chris@1295: s.html_safe Chris@1295: end Chris@1295: Chris@1295: def render_descendants_tree(issue) Chris@1295: s = '
' Chris@1295: issue_list(issue.descendants.visible.sort_by(&:lft)) do |child, level| Chris@1295: css = "issue issue-#{child.id} hascontextmenu" Chris@1295: css << " idnt idnt-#{level}" if level > 0 Chris@1295: s << content_tag('tr', Chris@1295: content_tag('td', check_box_tag("ids[]", child.id, false, :id => nil), :class => 'checkbox') + Chris@1295: content_tag('td', link_to_issue(child, :truncate => 60, :project => (issue.project_id != child.project_id)), :class => 'subject') + Chris@1295: content_tag('td', h(child.status)) + Chris@1295: content_tag('td', link_to_user(child.assigned_to)) + Chris@1295: content_tag('td', progress_bar(child.done_ratio, :width => '80px')), Chris@1295: :class => css) Chris@1295: end Chris@1295: s << '
' Chris@1295: s.html_safe Chris@1295: end Chris@1295: Chris@1295: # Returns a link for adding a new subtask to the given issue Chris@1295: def link_to_new_subtask(issue) Chris@1295: attrs = { Chris@1295: :tracker_id => issue.tracker, Chris@1295: :parent_issue_id => issue Chris@1295: } Chris@1295: link_to(l(:button_add), new_project_issue_path(issue.project, :issue => attrs)) Chris@1295: end Chris@1295: Chris@1295: class IssueFieldsRows Chris@1295: include ActionView::Helpers::TagHelper Chris@1295: Chris@1295: def initialize Chris@1295: @left = [] Chris@1295: @right = [] Chris@1295: end Chris@1295: Chris@1295: def left(*args) Chris@1295: args.any? ? @left << cells(*args) : @left Chris@1295: end Chris@1295: Chris@1295: def right(*args) Chris@1295: args.any? ? @right << cells(*args) : @right Chris@1295: end Chris@1295: Chris@1295: def size Chris@1295: @left.size > @right.size ? @left.size : @right.size Chris@1295: end Chris@1295: Chris@1295: def to_html Chris@1295: html = ''.html_safe Chris@1295: blank = content_tag('th', '') + content_tag('td', '') Chris@1295: size.times do |i| Chris@1295: left = @left[i] || blank Chris@1295: right = @right[i] || blank Chris@1295: html << content_tag('tr', left + right) Chris@1295: end Chris@1295: html Chris@1295: end Chris@1295: Chris@1295: def cells(label, text, options={}) Chris@1295: content_tag('th', "#{label}:", options) + content_tag('td', text, options) Chris@1295: end Chris@1295: end Chris@1295: Chris@1295: def issue_fields_rows Chris@1295: r = IssueFieldsRows.new Chris@1295: yield r Chris@1295: r.to_html Chris@1295: end Chris@1295: Chris@1295: def render_custom_fields_rows(issue) Chris@1295: return if issue.custom_field_values.empty? Chris@1295: ordered_values = [] Chris@1295: half = (issue.custom_field_values.size / 2.0).ceil Chris@1295: half.times do |i| Chris@1295: ordered_values << issue.custom_field_values[i] Chris@1295: ordered_values << issue.custom_field_values[i + half] Chris@1295: end Chris@1295: s = "\n" Chris@1295: n = 0 Chris@1295: ordered_values.compact.each do |value| Chris@1295: s << "\n\n" if n > 0 && (n % 2) == 0 Chris@1295: s << "\t#{ h(value.custom_field.name) }:#{ simple_format_without_paragraph(h(show_value(value))) }\n" Chris@1295: n += 1 Chris@1295: end Chris@1295: s << "\n" Chris@1295: s.html_safe Chris@1295: end Chris@1295: Chris@1295: def issues_destroy_confirmation_message(issues) Chris@1295: issues = [issues] unless issues.is_a?(Array) Chris@1295: message = l(:text_issues_destroy_confirmation) Chris@1295: descendant_count = issues.inject(0) {|memo, i| memo += (i.right - i.left - 1)/2} Chris@1295: if descendant_count > 0 Chris@1295: issues.each do |issue| Chris@1295: next if issue.root? Chris@1295: issues.each do |other_issue| Chris@1295: descendant_count -= 1 if issue.is_descendant_of?(other_issue) Chris@1295: end Chris@1295: end Chris@1295: if descendant_count > 0 Chris@1295: message << "\n" + l(:text_issues_destroy_descendants_confirmation, :count => descendant_count) Chris@1295: end Chris@1295: end Chris@1295: message Chris@1295: end Chris@1295: Chris@1295: def sidebar_queries Chris@1295: unless @sidebar_queries Chris@1295: @sidebar_queries = IssueQuery.visible.all( Chris@1295: :order => "#{Query.table_name}.name ASC", Chris@1295: # Project specific queries and global queries Chris@1295: :conditions => (@project.nil? ? ["project_id IS NULL"] : ["project_id IS NULL OR project_id = ?", @project.id]) Chris@1295: ) Chris@1295: end Chris@1295: @sidebar_queries Chris@1295: end Chris@1295: Chris@1295: def query_links(title, queries) Chris@1295: # links to #index on issues/show Chris@1295: url_params = controller_name == 'issues' ? {:controller => 'issues', :action => 'index', :project_id => @project} : params Chris@1295: Chris@1295: content_tag('h3', h(title)) + Chris@1295: queries.collect {|query| Chris@1295: css = 'query' Chris@1295: css << ' selected' if query == @query Chris@1295: link_to(h(query.name), url_params.merge(:query_id => query), :class => css) Chris@1295: }.join('
').html_safe Chris@1295: end Chris@1295: Chris@1295: def render_sidebar_queries Chris@1295: out = ''.html_safe Chris@1295: queries = sidebar_queries.select {|q| !q.is_public?} Chris@1295: out << query_links(l(:label_my_queries), queries) if queries.any? Chris@1295: queries = sidebar_queries.select {|q| q.is_public?} Chris@1295: out << query_links(l(:label_query_plural), queries) if queries.any? Chris@1295: out Chris@1295: end Chris@1295: Chris@1295: # Returns the textual representation of a journal details Chris@1295: # as an array of strings Chris@1295: def details_to_strings(details, no_html=false, options={}) Chris@1295: options[:only_path] = (options[:only_path] == false ? false : true) Chris@1295: strings = [] Chris@1295: values_by_field = {} Chris@1295: details.each do |detail| Chris@1295: if detail.property == 'cf' Chris@1295: field_id = detail.prop_key Chris@1295: field = CustomField.find_by_id(field_id) Chris@1295: if field && field.multiple? Chris@1295: values_by_field[field_id] ||= {:added => [], :deleted => []} Chris@1295: if detail.old_value Chris@1295: values_by_field[field_id][:deleted] << detail.old_value Chris@1295: end Chris@1295: if detail.value Chris@1295: values_by_field[field_id][:added] << detail.value Chris@1295: end Chris@1295: next Chris@1295: end Chris@1295: end Chris@1295: strings << show_detail(detail, no_html, options) Chris@1295: end Chris@1295: values_by_field.each do |field_id, changes| Chris@1295: detail = JournalDetail.new(:property => 'cf', :prop_key => field_id) Chris@1295: if changes[:added].any? Chris@1295: detail.value = changes[:added] Chris@1295: strings << show_detail(detail, no_html, options) Chris@1295: elsif changes[:deleted].any? Chris@1295: detail.old_value = changes[:deleted] Chris@1295: strings << show_detail(detail, no_html, options) Chris@1295: end Chris@1295: end Chris@1295: strings Chris@1295: end Chris@1295: Chris@1295: # Returns the textual representation of a single journal detail Chris@1295: def show_detail(detail, no_html=false, options={}) Chris@1295: multiple = false Chris@1295: case detail.property Chris@1295: when 'attr' Chris@1295: field = detail.prop_key.to_s.gsub(/\_id$/, "") Chris@1295: label = l(("field_" + field).to_sym) Chris@1295: case detail.prop_key Chris@1295: when 'due_date', 'start_date' Chris@1295: value = format_date(detail.value.to_date) if detail.value Chris@1295: old_value = format_date(detail.old_value.to_date) if detail.old_value Chris@1295: Chris@1295: when 'project_id', 'status_id', 'tracker_id', 'assigned_to_id', Chris@1295: 'priority_id', 'category_id', 'fixed_version_id' Chris@1295: value = find_name_by_reflection(field, detail.value) Chris@1295: old_value = find_name_by_reflection(field, detail.old_value) Chris@1295: Chris@1295: when 'estimated_hours' Chris@1295: value = "%0.02f" % detail.value.to_f unless detail.value.blank? Chris@1295: old_value = "%0.02f" % detail.old_value.to_f unless detail.old_value.blank? Chris@1295: Chris@1295: when 'parent_id' Chris@1295: label = l(:field_parent_issue) Chris@1295: value = "##{detail.value}" unless detail.value.blank? Chris@1295: old_value = "##{detail.old_value}" unless detail.old_value.blank? Chris@1295: Chris@1295: when 'is_private' Chris@1295: value = l(detail.value == "0" ? :general_text_No : :general_text_Yes) unless detail.value.blank? Chris@1295: old_value = l(detail.old_value == "0" ? :general_text_No : :general_text_Yes) unless detail.old_value.blank? Chris@1295: end Chris@1295: when 'cf' Chris@1295: custom_field = CustomField.find_by_id(detail.prop_key) Chris@1295: if custom_field Chris@1295: multiple = custom_field.multiple? Chris@1295: label = custom_field.name Chris@1295: value = format_value(detail.value, custom_field.field_format) if detail.value Chris@1295: old_value = format_value(detail.old_value, custom_field.field_format) if detail.old_value Chris@1295: end Chris@1295: when 'attachment' Chris@1295: label = l(:label_attachment) Chris@1295: end Chris@1295: call_hook(:helper_issues_show_detail_after_setting, Chris@1295: {:detail => detail, :label => label, :value => value, :old_value => old_value }) Chris@1295: Chris@1295: label ||= detail.prop_key Chris@1295: value ||= detail.value Chris@1295: old_value ||= detail.old_value Chris@1295: Chris@1295: unless no_html Chris@1295: label = content_tag('strong', label) Chris@1295: old_value = content_tag("i", h(old_value)) if detail.old_value Chris@1295: old_value = content_tag("del", old_value) if detail.old_value and detail.value.blank? Chris@1295: if detail.property == 'attachment' && !value.blank? && atta = Attachment.find_by_id(detail.prop_key) Chris@1295: # Link to the attachment if it has not been removed Chris@1295: value = link_to_attachment(atta, :download => true, :only_path => options[:only_path]) Chris@1295: if options[:only_path] != false && atta.is_text? Chris@1295: value += link_to( Chris@1295: image_tag('magnifier.png'), Chris@1295: :controller => 'attachments', :action => 'show', Chris@1295: :id => atta, :filename => atta.filename Chris@1295: ) Chris@1295: end Chris@1295: else Chris@1295: value = content_tag("i", h(value)) if value Chris@1295: end Chris@1295: end Chris@1295: Chris@1295: if detail.property == 'attr' && detail.prop_key == 'description' Chris@1295: s = l(:text_journal_changed_no_detail, :label => label) Chris@1295: unless no_html Chris@1295: diff_link = link_to 'diff', Chris@1295: {:controller => 'journals', :action => 'diff', :id => detail.journal_id, Chris@1295: :detail_id => detail.id, :only_path => options[:only_path]}, Chris@1295: :title => l(:label_view_diff) Chris@1295: s << " (#{ diff_link })" Chris@1295: end Chris@1295: s.html_safe Chris@1295: elsif detail.value.present? Chris@1295: case detail.property Chris@1295: when 'attr', 'cf' Chris@1295: if detail.old_value.present? Chris@1295: l(:text_journal_changed, :label => label, :old => old_value, :new => value).html_safe Chris@1295: elsif multiple Chris@1295: l(:text_journal_added, :label => label, :value => value).html_safe Chris@1295: else Chris@1295: l(:text_journal_set_to, :label => label, :value => value).html_safe Chris@1295: end Chris@1295: when 'attachment' Chris@1295: l(:text_journal_added, :label => label, :value => value).html_safe Chris@1295: end Chris@1295: else Chris@1295: l(:text_journal_deleted, :label => label, :old => old_value).html_safe Chris@1295: end Chris@1295: end Chris@1295: Chris@1295: # Find the name of an associated record stored in the field attribute Chris@1295: def find_name_by_reflection(field, id) Chris@1295: unless id.present? Chris@1295: return nil Chris@1295: end Chris@1295: association = Issue.reflect_on_association(field.to_sym) Chris@1295: if association Chris@1295: record = association.class_name.constantize.find_by_id(id) Chris@1295: if record Chris@1295: record.name.force_encoding('UTF-8') if record.name.respond_to?(:force_encoding) Chris@1295: return record.name Chris@1295: end Chris@1295: end Chris@1295: end Chris@1295: Chris@1295: # Renders issue children recursively Chris@1295: def render_api_issue_children(issue, api) Chris@1295: return if issue.leaf? Chris@1295: api.array :children do Chris@1295: issue.children.each do |child| Chris@1295: api.issue(:id => child.id) do Chris@1295: api.tracker(:id => child.tracker_id, :name => child.tracker.name) unless child.tracker.nil? Chris@1295: api.subject child.subject Chris@1295: render_api_issue_children(child, api) Chris@1295: end Chris@1295: end Chris@1295: end Chris@1295: end Chris@1295: end