##// END OF EJS Templates
Rails3: helper: use html_safe at page_header_title of ApplicationHelper...
Toshi MARUYAMA -
r7467:c27328236293
parent child
Show More
@@ -1,986 +1,986
1 1 # Redmine - project management software
2 2 # Copyright (C) 2006-2011 Jean-Philippe Lang
3 3 #
4 4 # This program is free software; you can redistribute it and/or
5 5 # modify it under the terms of the GNU General Public License
6 6 # as published by the Free Software Foundation; either version 2
7 7 # of the License, or (at your option) any later version.
8 8 #
9 9 # This program is distributed in the hope that it will be useful,
10 10 # but WITHOUT ANY WARRANTY; without even the implied warranty of
11 11 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12 12 # GNU General Public License for more details.
13 13 #
14 14 # You should have received a copy of the GNU General Public License
15 15 # along with this program; if not, write to the Free Software
16 16 # Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
17 17
18 18 require 'forwardable'
19 19 require 'cgi'
20 20
21 21 module ApplicationHelper
22 22 include Redmine::WikiFormatting::Macros::Definitions
23 23 include Redmine::I18n
24 24 include GravatarHelper::PublicMethods
25 25
26 26 extend Forwardable
27 27 def_delegators :wiki_helper, :wikitoolbar_for, :heads_for_wiki_formatter
28 28
29 29 # Return true if user is authorized for controller/action, otherwise false
30 30 def authorize_for(controller, action)
31 31 User.current.allowed_to?({:controller => controller, :action => action}, @project)
32 32 end
33 33
34 34 # Display a link if user is authorized
35 35 #
36 36 # @param [String] name Anchor text (passed to link_to)
37 37 # @param [Hash] options Hash params. This will checked by authorize_for to see if the user is authorized
38 38 # @param [optional, Hash] html_options Options passed to link_to
39 39 # @param [optional, Hash] parameters_for_method_reference Extra parameters for link_to
40 40 def link_to_if_authorized(name, options = {}, html_options = nil, *parameters_for_method_reference)
41 41 link_to(name, options, html_options, *parameters_for_method_reference) if authorize_for(options[:controller] || params[:controller], options[:action])
42 42 end
43 43
44 44 # Display a link to remote if user is authorized
45 45 def link_to_remote_if_authorized(name, options = {}, html_options = nil)
46 46 url = options[:url] || {}
47 47 link_to_remote(name, options, html_options) if authorize_for(url[:controller] || params[:controller], url[:action])
48 48 end
49 49
50 50 # Displays a link to user's account page if active
51 51 def link_to_user(user, options={})
52 52 if user.is_a?(User)
53 53 name = h(user.name(options[:format]))
54 54 if user.active?
55 55 link_to name, :controller => 'users', :action => 'show', :id => user
56 56 else
57 57 name
58 58 end
59 59 else
60 60 h(user.to_s)
61 61 end
62 62 end
63 63
64 64 # Displays a link to +issue+ with its subject.
65 65 # Examples:
66 66 #
67 67 # link_to_issue(issue) # => Defect #6: This is the subject
68 68 # link_to_issue(issue, :truncate => 6) # => Defect #6: This i...
69 69 # link_to_issue(issue, :subject => false) # => Defect #6
70 70 # link_to_issue(issue, :project => true) # => Foo - Defect #6
71 71 #
72 72 def link_to_issue(issue, options={})
73 73 title = nil
74 74 subject = nil
75 75 if options[:subject] == false
76 76 title = truncate(issue.subject, :length => 60)
77 77 else
78 78 subject = issue.subject
79 79 if options[:truncate]
80 80 subject = truncate(subject, :length => options[:truncate])
81 81 end
82 82 end
83 83 s = link_to "#{h(issue.tracker)} ##{issue.id}", {:controller => "issues", :action => "show", :id => issue},
84 84 :class => issue.css_classes,
85 85 :title => title
86 86 s << ": #{h subject}" if subject
87 87 s = "#{h issue.project} - " + s if options[:project]
88 88 s
89 89 end
90 90
91 91 # Generates a link to an attachment.
92 92 # Options:
93 93 # * :text - Link text (default to attachment filename)
94 94 # * :download - Force download (default: false)
95 95 def link_to_attachment(attachment, options={})
96 96 text = options.delete(:text) || attachment.filename
97 97 action = options.delete(:download) ? 'download' : 'show'
98 98
99 99 link_to(h(text), {:controller => 'attachments', :action => action, :id => attachment, :filename => attachment.filename }, options)
100 100 end
101 101
102 102 # Generates a link to a SCM revision
103 103 # Options:
104 104 # * :text - Link text (default to the formatted revision)
105 105 def link_to_revision(revision, project, options={})
106 106 text = options.delete(:text) || format_revision(revision)
107 107 rev = revision.respond_to?(:identifier) ? revision.identifier : revision
108 108
109 109 link_to(h(text), {:controller => 'repositories', :action => 'revision', :id => project, :rev => rev},
110 110 :title => l(:label_revision_id, format_revision(revision)))
111 111 end
112 112
113 113 # Generates a link to a message
114 114 def link_to_message(message, options={}, html_options = nil)
115 115 link_to(
116 116 h(truncate(message.subject, :length => 60)),
117 117 { :controller => 'messages', :action => 'show',
118 118 :board_id => message.board_id,
119 119 :id => message.root,
120 120 :r => (message.parent_id && message.id),
121 121 :anchor => (message.parent_id ? "message-#{message.id}" : nil)
122 122 }.merge(options),
123 123 html_options
124 124 )
125 125 end
126 126
127 127 # Generates a link to a project if active
128 128 # Examples:
129 129 #
130 130 # link_to_project(project) # => link to the specified project overview
131 131 # link_to_project(project, :action=>'settings') # => link to project settings
132 132 # link_to_project(project, {:only_path => false}, :class => "project") # => 3rd arg adds html options
133 133 # link_to_project(project, {}, :class => "project") # => html options with default url (project overview)
134 134 #
135 135 def link_to_project(project, options={}, html_options = nil)
136 136 if project.active?
137 137 url = {:controller => 'projects', :action => 'show', :id => project}.merge(options)
138 138 link_to(h(project), url, html_options)
139 139 else
140 140 h(project)
141 141 end
142 142 end
143 143
144 144 def toggle_link(name, id, options={})
145 145 onclick = "Element.toggle('#{id}'); "
146 146 onclick << (options[:focus] ? "Form.Element.focus('#{options[:focus]}'); " : "this.blur(); ")
147 147 onclick << "return false;"
148 148 link_to(name, "#", :onclick => onclick)
149 149 end
150 150
151 151 def image_to_function(name, function, html_options = {})
152 152 html_options.symbolize_keys!
153 153 tag(:input, html_options.merge({
154 154 :type => "image", :src => image_path(name),
155 155 :onclick => (html_options[:onclick] ? "#{html_options[:onclick]}; " : "") + "#{function};"
156 156 }))
157 157 end
158 158
159 159 def prompt_to_remote(name, text, param, url, html_options = {})
160 160 html_options[:onclick] = "promptToRemote('#{text}', '#{param}', '#{url_for(url)}'); return false;"
161 161 link_to name, {}, html_options
162 162 end
163 163
164 164 def format_activity_title(text)
165 165 h(truncate_single_line(text, :length => 100))
166 166 end
167 167
168 168 def format_activity_day(date)
169 169 date == Date.today ? l(:label_today).titleize : format_date(date)
170 170 end
171 171
172 172 def format_activity_description(text)
173 173 h(truncate(text.to_s, :length => 120).gsub(%r{[\r\n]*<(pre|code)>.*$}m, '...')).gsub(/[\r\n]+/, "<br />")
174 174 end
175 175
176 176 def format_version_name(version)
177 177 if version.project == @project
178 178 h(version)
179 179 else
180 180 h("#{version.project} - #{version}")
181 181 end
182 182 end
183 183
184 184 def due_date_distance_in_words(date)
185 185 if date
186 186 l((date < Date.today ? :label_roadmap_overdue : :label_roadmap_due_in), distance_of_date_in_words(Date.today, date))
187 187 end
188 188 end
189 189
190 190 def render_page_hierarchy(pages, node=nil, options={})
191 191 content = ''
192 192 if pages[node]
193 193 content << "<ul class=\"pages-hierarchy\">\n"
194 194 pages[node].each do |page|
195 195 content << "<li>"
196 196 content << link_to(h(page.pretty_title), {:controller => 'wiki', :action => 'show', :project_id => page.project, :id => page.title},
197 197 :title => (options[:timestamp] && page.updated_on ? l(:label_updated_time, distance_of_time_in_words(Time.now, page.updated_on)) : nil))
198 198 content << "\n" + render_page_hierarchy(pages, page.id, options) if pages[page.id]
199 199 content << "</li>\n"
200 200 end
201 201 content << "</ul>\n"
202 202 end
203 203 content.html_safe
204 204 end
205 205
206 206 # Renders flash messages
207 207 def render_flash_messages
208 208 s = ''
209 209 flash.each do |k,v|
210 210 s << content_tag('div', v, :class => "flash #{k}")
211 211 end
212 212 s.html_safe
213 213 end
214 214
215 215 # Renders tabs and their content
216 216 def render_tabs(tabs)
217 217 if tabs.any?
218 218 render :partial => 'common/tabs', :locals => {:tabs => tabs}
219 219 else
220 220 content_tag 'p', l(:label_no_data), :class => "nodata"
221 221 end
222 222 end
223 223
224 224 # Renders the project quick-jump box
225 225 def render_project_jump_box
226 226 return unless User.current.logged?
227 227 projects = User.current.memberships.collect(&:project).compact.uniq
228 228 if projects.any?
229 229 s = '<select onchange="if (this.value != \'\') { window.location = this.value; }">' +
230 230 "<option value=''>#{ l(:label_jump_to_a_project) }</option>" +
231 231 '<option value="" disabled="disabled">---</option>'
232 232 s << project_tree_options_for_select(projects, :selected => @project) do |p|
233 233 { :value => url_for(:controller => 'projects', :action => 'show', :id => p, :jump => current_menu_item) }
234 234 end
235 235 s << '</select>'
236 236 s.html_safe
237 237 end
238 238 end
239 239
240 240 def project_tree_options_for_select(projects, options = {})
241 241 s = ''
242 242 project_tree(projects) do |project, level|
243 243 name_prefix = (level > 0 ? ('&nbsp;' * 2 * level + '&#187; ') : '')
244 244 tag_options = {:value => project.id}
245 245 if project == options[:selected] || (options[:selected].respond_to?(:include?) && options[:selected].include?(project))
246 246 tag_options[:selected] = 'selected'
247 247 else
248 248 tag_options[:selected] = nil
249 249 end
250 250 tag_options.merge!(yield(project)) if block_given?
251 251 s << content_tag('option', name_prefix + h(project), tag_options)
252 252 end
253 253 s.html_safe
254 254 end
255 255
256 256 # Yields the given block for each project with its level in the tree
257 257 #
258 258 # Wrapper for Project#project_tree
259 259 def project_tree(projects, &block)
260 260 Project.project_tree(projects, &block)
261 261 end
262 262
263 263 def project_nested_ul(projects, &block)
264 264 s = ''
265 265 if projects.any?
266 266 ancestors = []
267 267 projects.sort_by(&:lft).each do |project|
268 268 if (ancestors.empty? || project.is_descendant_of?(ancestors.last))
269 269 s << "<ul>\n"
270 270 else
271 271 ancestors.pop
272 272 s << "</li>"
273 273 while (ancestors.any? && !project.is_descendant_of?(ancestors.last))
274 274 ancestors.pop
275 275 s << "</ul></li>\n"
276 276 end
277 277 end
278 278 s << "<li>"
279 279 s << yield(project).to_s
280 280 ancestors << project
281 281 end
282 282 s << ("</li></ul>\n" * ancestors.size)
283 283 end
284 284 s.html_safe
285 285 end
286 286
287 287 def principals_check_box_tags(name, principals)
288 288 s = ''
289 289 principals.sort.each do |principal|
290 290 s << "<label>#{ check_box_tag name, principal.id, false } #{h principal}</label>\n"
291 291 end
292 292 s.html_safe
293 293 end
294 294
295 295 # Returns a string for users/groups option tags
296 296 def principals_options_for_select(collection, selected=nil)
297 297 s = ''
298 298 groups = ''
299 299 collection.sort.each do |element|
300 300 selected_attribute = ' selected="selected"' if option_value_selected?(element, selected)
301 301 (element.is_a?(Group) ? groups : s) << %(<option value="#{element.id}"#{selected_attribute}>#{h element.name}</option>)
302 302 end
303 303 unless groups.empty?
304 304 s << %(<optgroup label="#{h(l(:label_group_plural))}">#{groups}</optgroup>)
305 305 end
306 306 s
307 307 end
308 308
309 309 # Truncates and returns the string as a single line
310 310 def truncate_single_line(string, *args)
311 311 truncate(string.to_s, *args).gsub(%r{[\r\n]+}m, ' ')
312 312 end
313 313
314 314 # Truncates at line break after 250 characters or options[:length]
315 315 def truncate_lines(string, options={})
316 316 length = options[:length] || 250
317 317 if string.to_s =~ /\A(.{#{length}}.*?)$/m
318 318 "#{$1}..."
319 319 else
320 320 string
321 321 end
322 322 end
323 323
324 324 def html_hours(text)
325 325 text.gsub(%r{(\d+)\.(\d+)}, '<span class="hours hours-int">\1</span><span class="hours hours-dec">.\2</span>').html_safe
326 326 end
327 327
328 328 def authoring(created, author, options={})
329 329 l(options[:label] || :label_added_time_by, :author => link_to_user(author), :age => time_tag(created)).html_safe
330 330 end
331 331
332 332 def time_tag(time)
333 333 text = distance_of_time_in_words(Time.now, time)
334 334 if @project
335 335 link_to(text, {:controller => 'activities', :action => 'index', :id => @project, :from => time.to_date}, :title => format_time(time))
336 336 else
337 337 content_tag('acronym', text, :title => format_time(time))
338 338 end
339 339 end
340 340
341 341 def syntax_highlight(name, content)
342 342 Redmine::SyntaxHighlighting.highlight_by_filename(content, name)
343 343 end
344 344
345 345 def to_path_param(path)
346 346 path.to_s.split(%r{[/\\]}).select {|p| !p.blank?}
347 347 end
348 348
349 349 def pagination_links_full(paginator, count=nil, options={})
350 350 page_param = options.delete(:page_param) || :page
351 351 per_page_links = options.delete(:per_page_links)
352 352 url_param = params.dup
353 353
354 354 html = ''
355 355 if paginator.current.previous
356 356 # \xc2\xab(utf-8) = &#171;
357 357 html << link_to_content_update(
358 358 "\xc2\xab " + l(:label_previous),
359 359 url_param.merge(page_param => paginator.current.previous)) + ' '
360 360 end
361 361
362 362 html << (pagination_links_each(paginator, options) do |n|
363 363 link_to_content_update(n.to_s, url_param.merge(page_param => n))
364 364 end || '')
365 365
366 366 if paginator.current.next
367 367 # \xc2\xbb(utf-8) = &#187;
368 368 html << ' ' + link_to_content_update(
369 369 (l(:label_next) + " \xc2\xbb"),
370 370 url_param.merge(page_param => paginator.current.next))
371 371 end
372 372
373 373 unless count.nil?
374 374 html << " (#{paginator.current.first_item}-#{paginator.current.last_item}/#{count})"
375 375 if per_page_links != false && links = per_page_links(paginator.items_per_page)
376 376 html << " | #{links}"
377 377 end
378 378 end
379 379
380 380 html.html_safe
381 381 end
382 382
383 383 def per_page_links(selected=nil)
384 384 links = Setting.per_page_options_array.collect do |n|
385 385 n == selected ? n : link_to_content_update(n, params.merge(:per_page => n))
386 386 end
387 387 links.size > 1 ? l(:label_display_per_page, links.join(', ')) : nil
388 388 end
389 389
390 390 def reorder_links(name, url)
391 391 link_to(image_tag('2uparrow.png', :alt => l(:label_sort_highest)),
392 392 url.merge({"#{name}[move_to]" => 'highest'}),
393 393 :method => :post, :title => l(:label_sort_highest)) +
394 394 link_to(image_tag('1uparrow.png', :alt => l(:label_sort_higher)),
395 395 url.merge({"#{name}[move_to]" => 'higher'}),
396 396 :method => :post, :title => l(:label_sort_higher)) +
397 397 link_to(image_tag('1downarrow.png', :alt => l(:label_sort_lower)),
398 398 url.merge({"#{name}[move_to]" => 'lower'}),
399 399 :method => :post, :title => l(:label_sort_lower)) +
400 400 link_to(image_tag('2downarrow.png', :alt => l(:label_sort_lowest)),
401 401 url.merge({"#{name}[move_to]" => 'lowest'}),
402 402 :method => :post, :title => l(:label_sort_lowest))
403 403 end
404 404
405 405 def breadcrumb(*args)
406 406 elements = args.flatten
407 407 elements.any? ? content_tag('p', (args.join(" \xc2\xbb ") + " \xc2\xbb ").html_safe, :class => 'breadcrumb') : nil
408 408 end
409 409
410 410 def other_formats_links(&block)
411 411 concat('<p class="other-formats">' + l(:label_export_to))
412 412 yield Redmine::Views::OtherFormatsBuilder.new(self)
413 413 concat('</p>')
414 414 end
415 415
416 416 def page_header_title
417 417 if @project.nil? || @project.new_record?
418 418 h(Setting.app_title)
419 419 else
420 420 b = []
421 421 ancestors = (@project.root? ? [] : @project.ancestors.visible.all)
422 422 if ancestors.any?
423 423 root = ancestors.shift
424 424 b << link_to_project(root, {:jump => current_menu_item}, :class => 'root')
425 425 if ancestors.size > 2
426 426 b << "\xe2\x80\xa6"
427 427 ancestors = ancestors[-2, 2]
428 428 end
429 429 b += ancestors.collect {|p| link_to_project(p, {:jump => current_menu_item}, :class => 'ancestor') }
430 430 end
431 431 b << h(@project)
432 b.join(" \xc2\xbb ")
432 b.join(" \xc2\xbb ").html_safe
433 433 end
434 434 end
435 435
436 436 def html_title(*args)
437 437 if args.empty?
438 438 title = []
439 439 title << @project.name if @project
440 440 title += @html_title if @html_title
441 441 title << Setting.app_title
442 442 title.select {|t| !t.blank? }.join(' - ')
443 443 else
444 444 @html_title ||= []
445 445 @html_title += args
446 446 end
447 447 end
448 448
449 449 # Returns the theme, controller name, and action as css classes for the
450 450 # HTML body.
451 451 def body_css_classes
452 452 css = []
453 453 if theme = Redmine::Themes.theme(Setting.ui_theme)
454 454 css << 'theme-' + theme.name
455 455 end
456 456
457 457 css << 'controller-' + params[:controller]
458 458 css << 'action-' + params[:action]
459 459 css.join(' ')
460 460 end
461 461
462 462 def accesskey(s)
463 463 Redmine::AccessKeys.key_for s
464 464 end
465 465
466 466 # Formats text according to system settings.
467 467 # 2 ways to call this method:
468 468 # * with a String: textilizable(text, options)
469 469 # * with an object and one of its attribute: textilizable(issue, :description, options)
470 470 def textilizable(*args)
471 471 options = args.last.is_a?(Hash) ? args.pop : {}
472 472 case args.size
473 473 when 1
474 474 obj = options[:object]
475 475 text = args.shift
476 476 when 2
477 477 obj = args.shift
478 478 attr = args.shift
479 479 text = obj.send(attr).to_s
480 480 else
481 481 raise ArgumentError, 'invalid arguments to textilizable'
482 482 end
483 483 return '' if text.blank?
484 484 project = options[:project] || @project || (obj && obj.respond_to?(:project) ? obj.project : nil)
485 485 only_path = options.delete(:only_path) == false ? false : true
486 486
487 487 text = Redmine::WikiFormatting.to_html(Setting.text_formatting, text, :object => obj, :attribute => attr) { |macro, args| exec_macro(macro, obj, args) }
488 488
489 489 @parsed_headings = []
490 490 text = parse_non_pre_blocks(text) do |text|
491 491 [:parse_inline_attachments, :parse_wiki_links, :parse_redmine_links, :parse_headings].each do |method_name|
492 492 send method_name, text, project, obj, attr, only_path, options
493 493 end
494 494 end
495 495
496 496 if @parsed_headings.any?
497 497 replace_toc(text, @parsed_headings)
498 498 end
499 499
500 500 text
501 501 end
502 502
503 503 def parse_non_pre_blocks(text)
504 504 s = StringScanner.new(text)
505 505 tags = []
506 506 parsed = ''
507 507 while !s.eos?
508 508 s.scan(/(.*?)(<(\/)?(pre|code)(.*?)>|\z)/im)
509 509 text, full_tag, closing, tag = s[1], s[2], s[3], s[4]
510 510 if tags.empty?
511 511 yield text
512 512 end
513 513 parsed << text
514 514 if tag
515 515 if closing
516 516 if tags.last == tag.downcase
517 517 tags.pop
518 518 end
519 519 else
520 520 tags << tag.downcase
521 521 end
522 522 parsed << full_tag
523 523 end
524 524 end
525 525 # Close any non closing tags
526 526 while tag = tags.pop
527 527 parsed << "</#{tag}>"
528 528 end
529 529 parsed.html_safe
530 530 end
531 531
532 532 def parse_inline_attachments(text, project, obj, attr, only_path, options)
533 533 # when using an image link, try to use an attachment, if possible
534 534 if options[:attachments] || (obj && obj.respond_to?(:attachments))
535 535 attachments = nil
536 536 text.gsub!(/src="([^\/"]+\.(bmp|gif|jpg|jpeg|png))"(\s+alt="([^"]*)")?/i) do |m|
537 537 filename, ext, alt, alttext = $1.downcase, $2, $3, $4
538 538 attachments ||= (options[:attachments] || obj.attachments).sort_by(&:created_on).reverse
539 539 # search for the picture in attachments
540 540 if found = attachments.detect { |att| att.filename.downcase == filename }
541 541 image_url = url_for :only_path => only_path, :controller => 'attachments', :action => 'download', :id => found
542 542 desc = found.description.to_s.gsub('"', '')
543 543 if !desc.blank? && alttext.blank?
544 544 alt = " title=\"#{desc}\" alt=\"#{desc}\""
545 545 end
546 546 "src=\"#{image_url}\"#{alt}".html_safe
547 547 else
548 548 m.html_safe
549 549 end
550 550 end
551 551 end
552 552 end
553 553
554 554 # Wiki links
555 555 #
556 556 # Examples:
557 557 # [[mypage]]
558 558 # [[mypage|mytext]]
559 559 # wiki links can refer other project wikis, using project name or identifier:
560 560 # [[project:]] -> wiki starting page
561 561 # [[project:|mytext]]
562 562 # [[project:mypage]]
563 563 # [[project:mypage|mytext]]
564 564 def parse_wiki_links(text, project, obj, attr, only_path, options)
565 565 text.gsub!(/(!)?(\[\[([^\]\n\|]+)(\|([^\]\n\|]+))?\]\])/) do |m|
566 566 link_project = project
567 567 esc, all, page, title = $1, $2, $3, $5
568 568 if esc.nil?
569 569 if page =~ /^([^\:]+)\:(.*)$/
570 570 link_project = Project.find_by_identifier($1) || Project.find_by_name($1)
571 571 page = $2
572 572 title ||= $1 if page.blank?
573 573 end
574 574
575 575 if link_project && link_project.wiki
576 576 # extract anchor
577 577 anchor = nil
578 578 if page =~ /^(.+?)\#(.+)$/
579 579 page, anchor = $1, $2
580 580 end
581 581 anchor = sanitize_anchor_name(anchor) if anchor.present?
582 582 # check if page exists
583 583 wiki_page = link_project.wiki.find_page(page)
584 584 url = if anchor.present? && wiki_page.present? && (obj.is_a?(WikiContent) || obj.is_a?(WikiContent::Version)) && obj.page == wiki_page
585 585 "##{anchor}"
586 586 else
587 587 case options[:wiki_links]
588 588 when :local; "#{page.present? ? Wiki.titleize(page) : ''}.html" + (anchor.present? ? "##{anchor}" : '')
589 589 when :anchor; "##{page.present? ? Wiki.titleize(page) : title}" + (anchor.present? ? "_#{anchor}" : '') # used for single-file wiki export
590 590 else
591 591 wiki_page_id = page.present? ? Wiki.titleize(page) : nil
592 592 url_for(:only_path => only_path, :controller => 'wiki', :action => 'show', :project_id => link_project, :id => wiki_page_id, :anchor => anchor)
593 593 end
594 594 end
595 595 link_to(h(title || page), url, :class => ('wiki-page' + (wiki_page ? '' : ' new')))
596 596 else
597 597 # project or wiki doesn't exist
598 598 all.html_safe
599 599 end
600 600 else
601 601 all.html_safe
602 602 end
603 603 end
604 604 end
605 605
606 606 # Redmine links
607 607 #
608 608 # Examples:
609 609 # Issues:
610 610 # #52 -> Link to issue #52
611 611 # Changesets:
612 612 # r52 -> Link to revision 52
613 613 # commit:a85130f -> Link to scmid starting with a85130f
614 614 # Documents:
615 615 # document#17 -> Link to document with id 17
616 616 # document:Greetings -> Link to the document with title "Greetings"
617 617 # document:"Some document" -> Link to the document with title "Some document"
618 618 # Versions:
619 619 # version#3 -> Link to version with id 3
620 620 # version:1.0.0 -> Link to version named "1.0.0"
621 621 # version:"1.0 beta 2" -> Link to version named "1.0 beta 2"
622 622 # Attachments:
623 623 # attachment:file.zip -> Link to the attachment of the current object named file.zip
624 624 # Source files:
625 625 # source:some/file -> Link to the file located at /some/file in the project's repository
626 626 # source:some/file@52 -> Link to the file's revision 52
627 627 # source:some/file#L120 -> Link to line 120 of the file
628 628 # source:some/file@52#L120 -> Link to line 120 of the file's revision 52
629 629 # export:some/file -> Force the download of the file
630 630 # Forum messages:
631 631 # message#1218 -> Link to message with id 1218
632 632 #
633 633 # Links can refer other objects from other projects, using project identifier:
634 634 # identifier:r52
635 635 # identifier:document:"Some document"
636 636 # identifier:version:1.0.0
637 637 # identifier:source:some/file
638 638 def parse_redmine_links(text, project, obj, attr, only_path, options)
639 639 text.gsub!(%r{([\s\(,\-\[\>]|^)(!)?(([a-z0-9\-]+):)?(attachment|document|version|commit|source|export|message|project)?((#|r)(\d+)|(:)([^"\s<>][^\s<>]*?|"[^"]+?"))(?=(?=[[:punct:]]\W)|,|\s|\]|<|$)}) do |m|
640 640 leading, esc, project_prefix, project_identifier, prefix, sep, identifier = $1, $2, $3, $4, $5, $7 || $9, $8 || $10
641 641 link = nil
642 642 if project_identifier
643 643 project = Project.visible.find_by_identifier(project_identifier)
644 644 end
645 645 if esc.nil?
646 646 if prefix.nil? && sep == 'r'
647 647 # project.changesets.visible raises an SQL error because of a double join on repositories
648 648 if project && project.repository && (changeset = Changeset.visible.find_by_repository_id_and_revision(project.repository.id, identifier))
649 649 link = link_to(h("#{project_prefix}r#{identifier}"), {:only_path => only_path, :controller => 'repositories', :action => 'revision', :id => project, :rev => changeset.revision},
650 650 :class => 'changeset',
651 651 :title => truncate_single_line(changeset.comments, :length => 100))
652 652 end
653 653 elsif sep == '#'
654 654 oid = identifier.to_i
655 655 case prefix
656 656 when nil
657 657 if issue = Issue.visible.find_by_id(oid, :include => :status)
658 658 link = link_to("##{oid}", {:only_path => only_path, :controller => 'issues', :action => 'show', :id => oid},
659 659 :class => issue.css_classes,
660 660 :title => "#{truncate(issue.subject, :length => 100)} (#{issue.status.name})")
661 661 end
662 662 when 'document'
663 663 if document = Document.visible.find_by_id(oid)
664 664 link = link_to h(document.title), {:only_path => only_path, :controller => 'documents', :action => 'show', :id => document},
665 665 :class => 'document'
666 666 end
667 667 when 'version'
668 668 if version = Version.visible.find_by_id(oid)
669 669 link = link_to h(version.name), {:only_path => only_path, :controller => 'versions', :action => 'show', :id => version},
670 670 :class => 'version'
671 671 end
672 672 when 'message'
673 673 if message = Message.visible.find_by_id(oid, :include => :parent)
674 674 link = link_to_message(message, {:only_path => only_path}, :class => 'message')
675 675 end
676 676 when 'project'
677 677 if p = Project.visible.find_by_id(oid)
678 678 link = link_to_project(p, {:only_path => only_path}, :class => 'project')
679 679 end
680 680 end
681 681 elsif sep == ':'
682 682 # removes the double quotes if any
683 683 name = identifier.gsub(%r{^"(.*)"$}, "\\1")
684 684 case prefix
685 685 when 'document'
686 686 if project && document = project.documents.visible.find_by_title(name)
687 687 link = link_to h(document.title), {:only_path => only_path, :controller => 'documents', :action => 'show', :id => document},
688 688 :class => 'document'
689 689 end
690 690 when 'version'
691 691 if project && version = project.versions.visible.find_by_name(name)
692 692 link = link_to h(version.name), {:only_path => only_path, :controller => 'versions', :action => 'show', :id => version},
693 693 :class => 'version'
694 694 end
695 695 when 'commit'
696 696 if project && project.repository && (changeset = Changeset.visible.find(:first, :conditions => ["repository_id = ? AND scmid LIKE ?", project.repository.id, "#{name}%"]))
697 697 link = link_to h("#{project_prefix}#{name}"), {:only_path => only_path, :controller => 'repositories', :action => 'revision', :id => project, :rev => changeset.identifier},
698 698 :class => 'changeset',
699 699 :title => truncate_single_line(h(changeset.comments), :length => 100)
700 700 end
701 701 when 'source', 'export'
702 702 if project && project.repository && User.current.allowed_to?(:browse_repository, project)
703 703 name =~ %r{^[/\\]*(.*?)(@([0-9a-f]+))?(#(L\d+))?$}
704 704 path, rev, anchor = $1, $3, $5
705 705 link = link_to h("#{project_prefix}#{prefix}:#{name}"), {:controller => 'repositories', :action => 'entry', :id => project,
706 706 :path => to_path_param(path),
707 707 :rev => rev,
708 708 :anchor => anchor,
709 709 :format => (prefix == 'export' ? 'raw' : nil)},
710 710 :class => (prefix == 'export' ? 'source download' : 'source')
711 711 end
712 712 when 'attachment'
713 713 attachments = options[:attachments] || (obj && obj.respond_to?(:attachments) ? obj.attachments : nil)
714 714 if attachments && attachment = attachments.detect {|a| a.filename == name }
715 715 link = link_to h(attachment.filename), {:only_path => only_path, :controller => 'attachments', :action => 'download', :id => attachment},
716 716 :class => 'attachment'
717 717 end
718 718 when 'project'
719 719 if p = Project.visible.find(:first, :conditions => ["identifier = :s OR LOWER(name) = :s", {:s => name.downcase}])
720 720 link = link_to_project(p, {:only_path => only_path}, :class => 'project')
721 721 end
722 722 end
723 723 end
724 724 end
725 725 (leading + (link || "#{project_prefix}#{prefix}#{sep}#{identifier}")).html_safe
726 726 end
727 727 end
728 728
729 729 HEADING_RE = /<h(1|2|3|4)( [^>]+)?>(.+?)<\/h(1|2|3|4)>/i unless const_defined?(:HEADING_RE)
730 730
731 731 # Headings and TOC
732 732 # Adds ids and links to headings unless options[:headings] is set to false
733 733 def parse_headings(text, project, obj, attr, only_path, options)
734 734 return if options[:headings] == false
735 735
736 736 text.gsub!(HEADING_RE) do
737 737 level, attrs, content = $1.to_i, $2, $3
738 738 item = strip_tags(content).strip
739 739 anchor = sanitize_anchor_name(item)
740 740 # used for single-file wiki export
741 741 anchor = "#{obj.page.title}_#{anchor}" if options[:wiki_links] == :anchor && (obj.is_a?(WikiContent) || obj.is_a?(WikiContent::Version))
742 742 @parsed_headings << [level, anchor, item]
743 743 "<a name=\"#{anchor}\"></a>\n<h#{level} #{attrs}>#{content}<a href=\"##{anchor}\" class=\"wiki-anchor\">&para;</a></h#{level}>"
744 744 end
745 745 end
746 746
747 747 TOC_RE = /<p>\{\{([<>]?)toc\}\}<\/p>/i unless const_defined?(:TOC_RE)
748 748
749 749 # Renders the TOC with given headings
750 750 def replace_toc(text, headings)
751 751 text.gsub!(TOC_RE) do
752 752 if headings.empty?
753 753 ''
754 754 else
755 755 div_class = 'toc'
756 756 div_class << ' right' if $1 == '>'
757 757 div_class << ' left' if $1 == '<'
758 758 out = "<ul class=\"#{div_class}\"><li>"
759 759 root = headings.map(&:first).min
760 760 current = root
761 761 started = false
762 762 headings.each do |level, anchor, item|
763 763 if level > current
764 764 out << '<ul><li>' * (level - current)
765 765 elsif level < current
766 766 out << "</li></ul>\n" * (current - level) + "</li><li>"
767 767 elsif started
768 768 out << '</li><li>'
769 769 end
770 770 out << "<a href=\"##{anchor}\">#{item}</a>"
771 771 current = level
772 772 started = true
773 773 end
774 774 out << '</li></ul>' * (current - root)
775 775 out << '</li></ul>'
776 776 end
777 777 end
778 778 end
779 779
780 780 # Same as Rails' simple_format helper without using paragraphs
781 781 def simple_format_without_paragraph(text)
782 782 text.to_s.
783 783 gsub(/\r\n?/, "\n"). # \r\n and \r -> \n
784 784 gsub(/\n\n+/, "<br /><br />"). # 2+ newline -> 2 br
785 785 gsub(/([^\n]\n)(?=[^\n])/, '\1<br />'). # 1 newline -> br
786 786 html_safe
787 787 end
788 788
789 789 def lang_options_for_select(blank=true)
790 790 (blank ? [["(auto)", ""]] : []) +
791 791 valid_languages.collect{|lang| [ ll(lang.to_s, :general_lang_name), lang.to_s]}.sort{|x,y| x.last <=> y.last }
792 792 end
793 793
794 794 def label_tag_for(name, option_tags = nil, options = {})
795 795 label_text = l(("field_"+field.to_s.gsub(/\_id$/, "")).to_sym) + (options.delete(:required) ? @template.content_tag("span", " *", :class => "required"): "")
796 796 content_tag("label", label_text)
797 797 end
798 798
799 799 def labelled_tabular_form_for(name, object, options, &proc)
800 800 options[:html] ||= {}
801 801 options[:html][:class] = 'tabular' unless options[:html].has_key?(:class)
802 802 form_for(name, object, options.merge({ :builder => TabularFormBuilder, :lang => current_language}), &proc)
803 803 end
804 804
805 805 def back_url_hidden_field_tag
806 806 back_url = params[:back_url] || request.env['HTTP_REFERER']
807 807 back_url = CGI.unescape(back_url.to_s)
808 808 hidden_field_tag('back_url', CGI.escape(back_url)) unless back_url.blank?
809 809 end
810 810
811 811 def check_all_links(form_name)
812 812 link_to_function(l(:button_check_all), "checkAll('#{form_name}', true)") +
813 813 " | ".html_safe +
814 814 link_to_function(l(:button_uncheck_all), "checkAll('#{form_name}', false)")
815 815 end
816 816
817 817 def progress_bar(pcts, options={})
818 818 pcts = [pcts, pcts] unless pcts.is_a?(Array)
819 819 pcts = pcts.collect(&:round)
820 820 pcts[1] = pcts[1] - pcts[0]
821 821 pcts << (100 - pcts[1] - pcts[0])
822 822 width = options[:width] || '100px;'
823 823 legend = options[:legend] || ''
824 824 content_tag('table',
825 825 content_tag('tr',
826 826 (pcts[0] > 0 ? content_tag('td', '', :style => "width: #{pcts[0]}%;", :class => 'closed') : ''.html_safe) +
827 827 (pcts[1] > 0 ? content_tag('td', '', :style => "width: #{pcts[1]}%;", :class => 'done') : ''.html_safe) +
828 828 (pcts[2] > 0 ? content_tag('td', '', :style => "width: #{pcts[2]}%;", :class => 'todo') : ''.html_safe)
829 829 ), :class => 'progress', :style => "width: #{width};").html_safe +
830 830 content_tag('p', legend, :class => 'pourcent').html_safe
831 831 end
832 832
833 833 def checked_image(checked=true)
834 834 if checked
835 835 image_tag 'toggle_check.png'
836 836 end
837 837 end
838 838
839 839 def context_menu(url)
840 840 unless @context_menu_included
841 841 content_for :header_tags do
842 842 javascript_include_tag('context_menu') +
843 843 stylesheet_link_tag('context_menu')
844 844 end
845 845 if l(:direction) == 'rtl'
846 846 content_for :header_tags do
847 847 stylesheet_link_tag('context_menu_rtl')
848 848 end
849 849 end
850 850 @context_menu_included = true
851 851 end
852 852 javascript_tag "new ContextMenu('#{ url_for(url) }')"
853 853 end
854 854
855 855 def context_menu_link(name, url, options={})
856 856 options[:class] ||= ''
857 857 if options.delete(:selected)
858 858 options[:class] << ' icon-checked disabled'
859 859 options[:disabled] = true
860 860 end
861 861 if options.delete(:disabled)
862 862 options.delete(:method)
863 863 options.delete(:confirm)
864 864 options.delete(:onclick)
865 865 options[:class] << ' disabled'
866 866 url = '#'
867 867 end
868 868 link_to h(name), url, options
869 869 end
870 870
871 871 def calendar_for(field_id)
872 872 include_calendar_headers_tags
873 873 image_tag("calendar.png", {:id => "#{field_id}_trigger",:class => "calendar-trigger"}) +
874 874 javascript_tag("Calendar.setup({inputField : '#{field_id}', ifFormat : '%Y-%m-%d', button : '#{field_id}_trigger' });")
875 875 end
876 876
877 877 def include_calendar_headers_tags
878 878 unless @calendar_headers_tags_included
879 879 @calendar_headers_tags_included = true
880 880 content_for :header_tags do
881 881 start_of_week = case Setting.start_of_week.to_i
882 882 when 1
883 883 'Calendar._FD = 1;' # Monday
884 884 when 7
885 885 'Calendar._FD = 0;' # Sunday
886 886 when 6
887 887 'Calendar._FD = 6;' # Saturday
888 888 else
889 889 '' # use language
890 890 end
891 891
892 892 javascript_include_tag('calendar/calendar') +
893 893 javascript_include_tag("calendar/lang/calendar-#{current_language.to_s.downcase}.js") +
894 894 javascript_tag(start_of_week) +
895 895 javascript_include_tag('calendar/calendar-setup') +
896 896 stylesheet_link_tag('calendar')
897 897 end
898 898 end
899 899 end
900 900
901 901 def content_for(name, content = nil, &block)
902 902 @has_content ||= {}
903 903 @has_content[name] = true
904 904 super(name, content, &block)
905 905 end
906 906
907 907 def has_content?(name)
908 908 (@has_content && @has_content[name]) || false
909 909 end
910 910
911 911 def email_delivery_enabled?
912 912 !!ActionMailer::Base.perform_deliveries
913 913 end
914 914
915 915 # Returns the avatar image tag for the given +user+ if avatars are enabled
916 916 # +user+ can be a User or a string that will be scanned for an email address (eg. 'joe <joe@foo.bar>')
917 917 def avatar(user, options = { })
918 918 if Setting.gravatar_enabled?
919 919 options.merge!({:ssl => (defined?(request) && request.ssl?), :default => Setting.gravatar_default})
920 920 email = nil
921 921 if user.respond_to?(:mail)
922 922 email = user.mail
923 923 elsif user.to_s =~ %r{<(.+?)>}
924 924 email = $1
925 925 end
926 926 return gravatar(email.to_s.downcase, options) unless email.blank? rescue nil
927 927 else
928 928 ''
929 929 end
930 930 end
931 931
932 932 def sanitize_anchor_name(anchor)
933 933 anchor.gsub(%r{[^\w\s\-]}, '').gsub(%r{\s+(\-+\s*)?}, '-')
934 934 end
935 935
936 936 # Returns the javascript tags that are included in the html layout head
937 937 def javascript_heads
938 938 tags = javascript_include_tag(:defaults)
939 939 unless User.current.pref.warn_on_leaving_unsaved == '0'
940 940 tags << "\n".html_safe + javascript_tag("Event.observe(window, 'load', function(){ new WarnLeavingUnsaved('#{escape_javascript( l(:text_warn_on_leaving_unsaved) )}'); });")
941 941 end
942 942 tags
943 943 end
944 944
945 945 def favicon
946 946 "<link rel='shortcut icon' href='#{image_path('/favicon.ico')}' />".html_safe
947 947 end
948 948
949 949 def robot_exclusion_tag
950 950 '<meta name="robots" content="noindex,follow,noarchive" />'
951 951 end
952 952
953 953 # Returns true if arg is expected in the API response
954 954 def include_in_api_response?(arg)
955 955 unless @included_in_api_response
956 956 param = params[:include]
957 957 @included_in_api_response = param.is_a?(Array) ? param.collect(&:to_s) : param.to_s.split(',')
958 958 @included_in_api_response.collect!(&:strip)
959 959 end
960 960 @included_in_api_response.include?(arg.to_s)
961 961 end
962 962
963 963 # Returns options or nil if nometa param or X-Redmine-Nometa header
964 964 # was set in the request
965 965 def api_meta(options)
966 966 if params[:nometa].present? || request.headers['X-Redmine-Nometa']
967 967 # compatibility mode for activeresource clients that raise
968 968 # an error when unserializing an array with attributes
969 969 nil
970 970 else
971 971 options
972 972 end
973 973 end
974 974
975 975 private
976 976
977 977 def wiki_helper
978 978 helper = Redmine::WikiFormatting.helper_for(Setting.text_formatting)
979 979 extend helper
980 980 return self
981 981 end
982 982
983 983 def link_to_content_update(text, url_params = {}, html_options = {})
984 984 link_to(text, url_params, html_options)
985 985 end
986 986 end
General Comments 0
You need to be logged in to leave comments. Login now