Module: IssuesHelper

Includes:
ApplicationHelper
Included in:
IssuesController
Defined in:
app/helpers/issues_helper.rb

Instance Method Summary (collapse)

Methods included from ApplicationHelper

#accesskey, #authoring, #authorize_for, #avatar, #back_url_hidden_field_tag, #breadcrumb, #calendar_for, #check_all_links, #content_for, #context_menu_link, #current_role, #due_date_distance_in_words, #format_activity_day, #format_activity_description, #format_activity_title, #has_content?, #html_hours, #html_title, #image_to_function, #include_calendar_headers_tags, #label_tag_for, #labelled_tabular_form_for, #lang_options_for_select, #link_to_attachment, #link_to_if_authorized, #link_to_issue, #link_to_remote_if_authorized, #link_to_user, #other_formats_links, #page_header_title, #pagination_links_full, #path_to_stylesheet, #per_page_links, #progress_bar, #project_nested_ul, #project_tree, #project_tree_options_for_select, #prompt_to_remote, #render_flash_messages, #render_page_hierarchy, #render_project_jump_box, #reorder_links, #simple_format_without_paragraph, #stylesheet_path, #syntax_highlight, #textilizable, #to_path_param, #toggle_link, #truncate_single_line

Methods included from Redmine::I18n

#current_language, #day_name, #find_language, #format_date, #format_time, included, #l, #l_hours, #l_or_humanize, #ll, #month_name, #set_language_if_valid, #valid_languages

Methods included from Redmine::WikiFormatting::Macros::Definitions

#exec_macro, #extract_macro_options

Instance Method Details

- (Object) css_issue_classes(issue)

Returns a string of css classes that apply to the given issue



37
38
39
40
41
42
43
44
 
# File 'app/helpers/issues_helper.rb', line 37

def css_issue_classes(issue)
  s = "issue status-#{issue.status.position} priority-#{issue.priority.position}"
  s << ' closed' if issue.closed?
  s << ' overdue' if issue.overdue?
  s << ' created-by-me' if User.current.logged? && issue.author_id == User.current.id
  s << ' assigned-to-me' if User.current.logged? && issue.assigned_to_id == User.current.id
  s
end

- (Object) issues_to_csv(issues, project = nil) 



142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
 
# File 'app/helpers/issues_helper.rb', line 142

def issues_to_csv(issues, project = nil)
  ic = Iconv.new(l(:general_csv_encoding), 'UTF-8')    
  decimal_separator = l(:general_csv_decimal_separator)
  export = StringIO.new
  CSV::Writer.generate(export, l(:general_csv_separator)) do |csv|
    # csv header fields
    headers = [ "#",
                l(:field_status), 
                l(:field_project),
                l(:field_tracker),
                l(:field_priority),
                l(:field_subject),
                l(:field_assigned_to),
                l(:field_category),
                l(:field_fixed_version),
                l(:field_author),
                l(:field_start_date),
                l(:field_due_date),
                l(:field_done_ratio),
                l(:field_estimated_hours),
                l(:field_created_on),
                l(:field_updated_on)
                ]
    # Export project custom fields if project is given
    # otherwise export custom fields marked as "For all projects"
    custom_fields = project.nil? ? IssueCustomField.for_all : project.all_issue_custom_fields
    custom_fields.each {|f| headers << f.name}
    # Description in the last column
    headers << l(:field_description)
    csv << headers.collect {|c| begin; ic.iconv(c.to_s); rescue; c.to_s; end }
    # csv lines
    issues.each do |issue|
      fields = [issue.id,
                issue.status.name, 
                issue.project.name,
                issue.tracker.name, 
                issue.priority.name,
                issue.subject,
                issue.assigned_to,
                issue.category,
                issue.fixed_version,
                issue.author.name,
                format_date(issue.start_date),
                format_date(issue.due_date),
                issue.done_ratio,
                issue.estimated_hours.to_s.gsub('.', decimal_separator),
                format_time(issue.created_on),  
                format_time(issue.updated_on)
                ]
      custom_fields.each {|f| fields << show_value(issue.custom_value_for(f)) }
      fields << issue.description
      csv << fields.collect {|c| begin; ic.iconv(c.to_s); rescue; c.to_s; end }
    end
  end
  export.rewind
  export
end

- (Object) render_issue_tooltip(issue) 



23
24
25
26
27
28
29
30
31
32
33
34
 
# File 'app/helpers/issues_helper.rb', line 23

def render_issue_tooltip(issue)
  @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)
  
  link_to_issue(issue) + ": #{h(issue.subject)}<br /><br />" +
    "<strong>#{@cached_label_start_date}</strong>: #{format_date(issue.start_date)}<br />" +
    "<strong>#{@cached_label_due_date}</strong>: #{format_date(issue.due_date)}<br />" +
    "<strong>#{@cached_label_assigned_to}</strong>: #{issue.assigned_to}<br />" +
    "<strong>#{@cached_label_priority}</strong>: #{issue.priority.name}"
end

- (Object) show_detail(detail, no_html = false) 



60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
 
# File 'app/helpers/issues_helper.rb', line 60

def show_detail(detail, no_html=false)
  case detail.property
  when 'attr'
    label = l(("field_" + detail.prop_key.to_s.gsub(/\_id$/, "")).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'
      p = Project.find_by_id(detail.value) and value = p.name if detail.value
      p = Project.find_by_id(detail.old_value) and old_value = p.name if detail.old_value
    when 'status_id'
      s = IssueStatus.find_by_id(detail.value) and value = s.name if detail.value
      s = IssueStatus.find_by_id(detail.old_value) and old_value = s.name if detail.old_value
    when 'tracker_id'
      t = Tracker.find_by_id(detail.value) and value = t.name if detail.value
      t = Tracker.find_by_id(detail.old_value) and old_value = t.name if detail.old_value
    when 'assigned_to_id'
      u = User.find_by_id(detail.value) and value = u.name if detail.value
      u = User.find_by_id(detail.old_value) and old_value = u.name if detail.old_value
    when 'priority_id'
      e = Enumeration.find_by_id(detail.value) and value = e.name if detail.value
      e = Enumeration.find_by_id(detail.old_value) and old_value = e.name if detail.old_value
    when 'category_id'
      c = IssueCategory.find_by_id(detail.value) and value = c.name if detail.value
      c = IssueCategory.find_by_id(detail.old_value) and old_value = c.name if detail.old_value
    when 'fixed_version_id'
      v = Version.find_by_id(detail.value) and value = v.name if detail.value
      v = Version.find_by_id(detail.old_value) and old_value = v.name if detail.old_value
    when 'estimated_hours'
      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?
    end
  when 'cf'
    custom_field = CustomField.find_by_id(detail.prop_key)
    if custom_field
      label = custom_field.name
      value = format_value(detail.value, custom_field.field_format) if detail.value
      old_value = format_value(detail.old_value, custom_field.field_format) if detail.old_value
    end
  when 'attachment'
    label = l(:label_attachment)
  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
    old_value = content_tag("strike", old_value) if detail.old_value and (!detail.value or detail.value.empty?)
    if detail.property == 'attachment' && !value.blank? && a = Attachment.find_by_id(detail.prop_key)
      # Link to the attachment if it has not been removed
      value = link_to_attachment(a)
    else
      value = content_tag("i", h(value)) if value
    end
  end
  
  if !detail.value.blank?
    case detail.property
    when 'attr', 'cf'
      if !detail.old_value.blank?
        label + " " + l(:text_journal_changed, :old => old_value, :new => value)
      else
        label + " " + l(:text_journal_set_to, value)
      end
    when 'attachment'
      "#{label} #{value} #{l(:label_added)}"
    end
  else
    case detail.property
    when 'attr', 'cf'
      label + " " + l(:text_journal_deleted) + " (#{old_value})"
    when 'attachment'
      "#{label} #{old_value} #{l(:label_deleted)}"
    end
  end
end

- (Object) sidebar_queries 



46
47
48
49
50
51
52
53
54
55
56
57
58
 
# File 'app/helpers/issues_helper.rb', line 46

def sidebar_queries
  unless @sidebar_queries
    # User can see public queries and his own queries
    visible = ARCondition.new(["is_public = ? OR user_id = ?", true, (User.current.logged? ? User.current.id : 0)])
    # Project specific queries and global queries
    visible << (@project.nil? ? ["project_id IS NULL"] : ["project_id IS NULL OR project_id = ?", @project.id])
    @sidebar_queries = Query.find(:all, 
                                  :select => 'id, name',
                                  :order => "name ASC",
                                  :conditions => visible.conditions)
  end
  @sidebar_queries
end