##// END OF EJS Templates
Adds an option to #render_page_hierarchy to add timestamp titles....
Jean-Philippe Lang -
r4979:14238907354a
parent child
Show More
@@ -1,948 +1,948
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 "#{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(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 def render_page_hierarchy(pages, node=nil)
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 :title => (page.updated_on ? l(:label_updated_time, distance_of_time_in_words(Time.now, page.updated_on)) : nil))
198 content << "\n" + render_page_hierarchy(pages, page.id) if pages[page.id]
197 :title => (options[:timestamp] && page.updated_on ? l(:label_updated_time, distance_of_time_in_words(Time.now, page.updated_on)) : nil))
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
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
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 # Retrieve them now to avoid a COUNT query
227 227 projects = User.current.projects.all
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
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
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
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
293 293 end
294 294
295 295 # Truncates and returns the string as a single line
296 296 def truncate_single_line(string, *args)
297 297 truncate(string.to_s, *args).gsub(%r{[\r\n]+}m, ' ')
298 298 end
299 299
300 300 # Truncates at line break after 250 characters or options[:length]
301 301 def truncate_lines(string, options={})
302 302 length = options[:length] || 250
303 303 if string.to_s =~ /\A(.{#{length}}.*?)$/m
304 304 "#{$1}..."
305 305 else
306 306 string
307 307 end
308 308 end
309 309
310 310 def html_hours(text)
311 311 text.gsub(%r{(\d+)\.(\d+)}, '<span class="hours hours-int">\1</span><span class="hours hours-dec">.\2</span>')
312 312 end
313 313
314 314 def authoring(created, author, options={})
315 315 l(options[:label] || :label_added_time_by, :author => link_to_user(author), :age => time_tag(created))
316 316 end
317 317
318 318 def time_tag(time)
319 319 text = distance_of_time_in_words(Time.now, time)
320 320 if @project
321 321 link_to(text, {:controller => 'activities', :action => 'index', :id => @project, :from => time.to_date}, :title => format_time(time))
322 322 else
323 323 content_tag('acronym', text, :title => format_time(time))
324 324 end
325 325 end
326 326
327 327 def syntax_highlight(name, content)
328 328 Redmine::SyntaxHighlighting.highlight_by_filename(content, name)
329 329 end
330 330
331 331 def to_path_param(path)
332 332 path.to_s.split(%r{[/\\]}).select {|p| !p.blank?}
333 333 end
334 334
335 335 def pagination_links_full(paginator, count=nil, options={})
336 336 page_param = options.delete(:page_param) || :page
337 337 per_page_links = options.delete(:per_page_links)
338 338 url_param = params.dup
339 339 # don't reuse query params if filters are present
340 340 url_param.merge!(:fields => nil, :values => nil, :operators => nil) if url_param.delete(:set_filter)
341 341
342 342 html = ''
343 343 if paginator.current.previous
344 344 html << link_to_remote_content_update('&#171; ' + l(:label_previous), url_param.merge(page_param => paginator.current.previous)) + ' '
345 345 end
346 346
347 347 html << (pagination_links_each(paginator, options) do |n|
348 348 link_to_remote_content_update(n.to_s, url_param.merge(page_param => n))
349 349 end || '')
350 350
351 351 if paginator.current.next
352 352 html << ' ' + link_to_remote_content_update((l(:label_next) + ' &#187;'), url_param.merge(page_param => paginator.current.next))
353 353 end
354 354
355 355 unless count.nil?
356 356 html << " (#{paginator.current.first_item}-#{paginator.current.last_item}/#{count})"
357 357 if per_page_links != false && links = per_page_links(paginator.items_per_page)
358 358 html << " | #{links}"
359 359 end
360 360 end
361 361
362 362 html
363 363 end
364 364
365 365 def per_page_links(selected=nil)
366 366 url_param = params.dup
367 367 url_param.clear if url_param.has_key?(:set_filter)
368 368
369 369 links = Setting.per_page_options_array.collect do |n|
370 370 n == selected ? n : link_to_remote(n, {:update => "content",
371 371 :url => params.dup.merge(:per_page => n),
372 372 :method => :get},
373 373 {:href => url_for(url_param.merge(:per_page => n))})
374 374 end
375 375 links.size > 1 ? l(:label_display_per_page, links.join(', ')) : nil
376 376 end
377 377
378 378 def reorder_links(name, url)
379 379 link_to(image_tag('2uparrow.png', :alt => l(:label_sort_highest)), url.merge({"#{name}[move_to]" => 'highest'}), :method => :post, :title => l(:label_sort_highest)) +
380 380 link_to(image_tag('1uparrow.png', :alt => l(:label_sort_higher)), url.merge({"#{name}[move_to]" => 'higher'}), :method => :post, :title => l(:label_sort_higher)) +
381 381 link_to(image_tag('1downarrow.png', :alt => l(:label_sort_lower)), url.merge({"#{name}[move_to]" => 'lower'}), :method => :post, :title => l(:label_sort_lower)) +
382 382 link_to(image_tag('2downarrow.png', :alt => l(:label_sort_lowest)), url.merge({"#{name}[move_to]" => 'lowest'}), :method => :post, :title => l(:label_sort_lowest))
383 383 end
384 384
385 385 def breadcrumb(*args)
386 386 elements = args.flatten
387 387 elements.any? ? content_tag('p', args.join(' &#187; ') + ' &#187; ', :class => 'breadcrumb') : nil
388 388 end
389 389
390 390 def other_formats_links(&block)
391 391 concat('<p class="other-formats">' + l(:label_export_to))
392 392 yield Redmine::Views::OtherFormatsBuilder.new(self)
393 393 concat('</p>')
394 394 end
395 395
396 396 def page_header_title
397 397 if @project.nil? || @project.new_record?
398 398 h(Setting.app_title)
399 399 else
400 400 b = []
401 401 ancestors = (@project.root? ? [] : @project.ancestors.visible)
402 402 if ancestors.any?
403 403 root = ancestors.shift
404 404 b << link_to_project(root, {:jump => current_menu_item}, :class => 'root')
405 405 if ancestors.size > 2
406 406 b << '&#8230;'
407 407 ancestors = ancestors[-2, 2]
408 408 end
409 409 b += ancestors.collect {|p| link_to_project(p, {:jump => current_menu_item}, :class => 'ancestor') }
410 410 end
411 411 b << h(@project)
412 412 b.join(' &#187; ')
413 413 end
414 414 end
415 415
416 416 def html_title(*args)
417 417 if args.empty?
418 418 title = []
419 419 title << @project.name if @project
420 420 title += @html_title if @html_title
421 421 title << Setting.app_title
422 422 title.select {|t| !t.blank? }.join(' - ')
423 423 else
424 424 @html_title ||= []
425 425 @html_title += args
426 426 end
427 427 end
428 428
429 429 # Returns the theme, controller name, and action as css classes for the
430 430 # HTML body.
431 431 def body_css_classes
432 432 css = []
433 433 if theme = Redmine::Themes.theme(Setting.ui_theme)
434 434 css << 'theme-' + theme.name
435 435 end
436 436
437 437 css << 'controller-' + params[:controller]
438 438 css << 'action-' + params[:action]
439 439 css.join(' ')
440 440 end
441 441
442 442 def accesskey(s)
443 443 Redmine::AccessKeys.key_for s
444 444 end
445 445
446 446 # Formats text according to system settings.
447 447 # 2 ways to call this method:
448 448 # * with a String: textilizable(text, options)
449 449 # * with an object and one of its attribute: textilizable(issue, :description, options)
450 450 def textilizable(*args)
451 451 options = args.last.is_a?(Hash) ? args.pop : {}
452 452 case args.size
453 453 when 1
454 454 obj = options[:object]
455 455 text = args.shift
456 456 when 2
457 457 obj = args.shift
458 458 attr = args.shift
459 459 text = obj.send(attr).to_s
460 460 else
461 461 raise ArgumentError, 'invalid arguments to textilizable'
462 462 end
463 463 return '' if text.blank?
464 464 project = options[:project] || @project || (obj && obj.respond_to?(:project) ? obj.project : nil)
465 465 only_path = options.delete(:only_path) == false ? false : true
466 466
467 467 text = Redmine::WikiFormatting.to_html(Setting.text_formatting, text, :object => obj, :attribute => attr) { |macro, args| exec_macro(macro, obj, args) }
468 468
469 469 @parsed_headings = []
470 470 text = parse_non_pre_blocks(text) do |text|
471 471 [:parse_inline_attachments, :parse_wiki_links, :parse_redmine_links, :parse_headings].each do |method_name|
472 472 send method_name, text, project, obj, attr, only_path, options
473 473 end
474 474 end
475 475
476 476 if @parsed_headings.any?
477 477 replace_toc(text, @parsed_headings)
478 478 end
479 479
480 480 text
481 481 end
482 482
483 483 def parse_non_pre_blocks(text)
484 484 s = StringScanner.new(text)
485 485 tags = []
486 486 parsed = ''
487 487 while !s.eos?
488 488 s.scan(/(.*?)(<(\/)?(pre|code)(.*?)>|\z)/im)
489 489 text, full_tag, closing, tag = s[1], s[2], s[3], s[4]
490 490 if tags.empty?
491 491 yield text
492 492 end
493 493 parsed << text
494 494 if tag
495 495 if closing
496 496 if tags.last == tag.downcase
497 497 tags.pop
498 498 end
499 499 else
500 500 tags << tag.downcase
501 501 end
502 502 parsed << full_tag
503 503 end
504 504 end
505 505 # Close any non closing tags
506 506 while tag = tags.pop
507 507 parsed << "</#{tag}>"
508 508 end
509 509 parsed
510 510 end
511 511
512 512 def parse_inline_attachments(text, project, obj, attr, only_path, options)
513 513 # when using an image link, try to use an attachment, if possible
514 514 if options[:attachments] || (obj && obj.respond_to?(:attachments))
515 515 attachments = nil
516 516 text.gsub!(/src="([^\/"]+\.(bmp|gif|jpg|jpeg|png))"(\s+alt="([^"]*)")?/i) do |m|
517 517 filename, ext, alt, alttext = $1.downcase, $2, $3, $4
518 518 attachments ||= (options[:attachments] || obj.attachments).sort_by(&:created_on).reverse
519 519 # search for the picture in attachments
520 520 if found = attachments.detect { |att| att.filename.downcase == filename }
521 521 image_url = url_for :only_path => only_path, :controller => 'attachments', :action => 'download', :id => found
522 522 desc = found.description.to_s.gsub('"', '')
523 523 if !desc.blank? && alttext.blank?
524 524 alt = " title=\"#{desc}\" alt=\"#{desc}\""
525 525 end
526 526 "src=\"#{image_url}\"#{alt}"
527 527 else
528 528 m
529 529 end
530 530 end
531 531 end
532 532 end
533 533
534 534 # Wiki links
535 535 #
536 536 # Examples:
537 537 # [[mypage]]
538 538 # [[mypage|mytext]]
539 539 # wiki links can refer other project wikis, using project name or identifier:
540 540 # [[project:]] -> wiki starting page
541 541 # [[project:|mytext]]
542 542 # [[project:mypage]]
543 543 # [[project:mypage|mytext]]
544 544 def parse_wiki_links(text, project, obj, attr, only_path, options)
545 545 text.gsub!(/(!)?(\[\[([^\]\n\|]+)(\|([^\]\n\|]+))?\]\])/) do |m|
546 546 link_project = project
547 547 esc, all, page, title = $1, $2, $3, $5
548 548 if esc.nil?
549 549 if page =~ /^([^\:]+)\:(.*)$/
550 550 link_project = Project.find_by_identifier($1) || Project.find_by_name($1)
551 551 page = $2
552 552 title ||= $1 if page.blank?
553 553 end
554 554
555 555 if link_project && link_project.wiki
556 556 # extract anchor
557 557 anchor = nil
558 558 if page =~ /^(.+?)\#(.+)$/
559 559 page, anchor = $1, $2
560 560 end
561 561 # check if page exists
562 562 wiki_page = link_project.wiki.find_page(page)
563 563 url = case options[:wiki_links]
564 564 when :local; "#{title}.html"
565 565 when :anchor; "##{title}" # used for single-file wiki export
566 566 else
567 567 wiki_page_id = page.present? ? Wiki.titleize(page) : nil
568 568 url_for(:only_path => only_path, :controller => 'wiki', :action => 'show', :project_id => link_project, :id => wiki_page_id, :anchor => anchor)
569 569 end
570 570 link_to((title || page), url, :class => ('wiki-page' + (wiki_page ? '' : ' new')))
571 571 else
572 572 # project or wiki doesn't exist
573 573 all
574 574 end
575 575 else
576 576 all
577 577 end
578 578 end
579 579 end
580 580
581 581 # Redmine links
582 582 #
583 583 # Examples:
584 584 # Issues:
585 585 # #52 -> Link to issue #52
586 586 # Changesets:
587 587 # r52 -> Link to revision 52
588 588 # commit:a85130f -> Link to scmid starting with a85130f
589 589 # Documents:
590 590 # document#17 -> Link to document with id 17
591 591 # document:Greetings -> Link to the document with title "Greetings"
592 592 # document:"Some document" -> Link to the document with title "Some document"
593 593 # Versions:
594 594 # version#3 -> Link to version with id 3
595 595 # version:1.0.0 -> Link to version named "1.0.0"
596 596 # version:"1.0 beta 2" -> Link to version named "1.0 beta 2"
597 597 # Attachments:
598 598 # attachment:file.zip -> Link to the attachment of the current object named file.zip
599 599 # Source files:
600 600 # source:some/file -> Link to the file located at /some/file in the project's repository
601 601 # source:some/file@52 -> Link to the file's revision 52
602 602 # source:some/file#L120 -> Link to line 120 of the file
603 603 # source:some/file@52#L120 -> Link to line 120 of the file's revision 52
604 604 # export:some/file -> Force the download of the file
605 605 # Forum messages:
606 606 # message#1218 -> Link to message with id 1218
607 607 #
608 608 # Links can refer other objects from other projects, using project identifier:
609 609 # identifier:r52
610 610 # identifier:document:"Some document"
611 611 # identifier:version:1.0.0
612 612 # identifier:source:some/file
613 613 def parse_redmine_links(text, project, obj, attr, only_path, options)
614 614 text.gsub!(%r{([\s\(,\-\[\>]|^)(!)?(([a-z0-9\-]+):)?(attachment|document|version|commit|source|export|message|project)?((#|r)(\d+)|(:)([^"\s<>][^\s<>]*?|"[^"]+?"))(?=(?=[[:punct:]]\W)|,|\s|\]|<|$)}) do |m|
615 615 leading, esc, project_prefix, project_identifier, prefix, sep, identifier = $1, $2, $3, $4, $5, $7 || $9, $8 || $10
616 616 link = nil
617 617 if project_identifier
618 618 project = Project.visible.find_by_identifier(project_identifier)
619 619 end
620 620 if esc.nil?
621 621 if prefix.nil? && sep == 'r'
622 622 # project.changesets.visible raises an SQL error because of a double join on repositories
623 623 if project && project.repository && (changeset = Changeset.visible.find_by_repository_id_and_revision(project.repository.id, identifier))
624 624 link = link_to("#{project_prefix}r#{identifier}", {:only_path => only_path, :controller => 'repositories', :action => 'revision', :id => project, :rev => changeset.revision},
625 625 :class => 'changeset',
626 626 :title => truncate_single_line(changeset.comments, :length => 100))
627 627 end
628 628 elsif sep == '#'
629 629 oid = identifier.to_i
630 630 case prefix
631 631 when nil
632 632 if issue = Issue.visible.find_by_id(oid, :include => :status)
633 633 link = link_to("##{oid}", {:only_path => only_path, :controller => 'issues', :action => 'show', :id => oid},
634 634 :class => issue.css_classes,
635 635 :title => "#{truncate(issue.subject, :length => 100)} (#{issue.status.name})")
636 636 end
637 637 when 'document'
638 638 if document = Document.visible.find_by_id(oid)
639 639 link = link_to h(document.title), {:only_path => only_path, :controller => 'documents', :action => 'show', :id => document},
640 640 :class => 'document'
641 641 end
642 642 when 'version'
643 643 if version = Version.visible.find_by_id(oid)
644 644 link = link_to h(version.name), {:only_path => only_path, :controller => 'versions', :action => 'show', :id => version},
645 645 :class => 'version'
646 646 end
647 647 when 'message'
648 648 if message = Message.visible.find_by_id(oid, :include => :parent)
649 649 link = link_to_message(message, {:only_path => only_path}, :class => 'message')
650 650 end
651 651 when 'project'
652 652 if p = Project.visible.find_by_id(oid)
653 653 link = link_to_project(p, {:only_path => only_path}, :class => 'project')
654 654 end
655 655 end
656 656 elsif sep == ':'
657 657 # removes the double quotes if any
658 658 name = identifier.gsub(%r{^"(.*)"$}, "\\1")
659 659 case prefix
660 660 when 'document'
661 661 if project && document = project.documents.visible.find_by_title(name)
662 662 link = link_to h(document.title), {:only_path => only_path, :controller => 'documents', :action => 'show', :id => document},
663 663 :class => 'document'
664 664 end
665 665 when 'version'
666 666 if project && version = project.versions.visible.find_by_name(name)
667 667 link = link_to h(version.name), {:only_path => only_path, :controller => 'versions', :action => 'show', :id => version},
668 668 :class => 'version'
669 669 end
670 670 when 'commit'
671 671 if project && project.repository && (changeset = Changeset.visible.find(:first, :conditions => ["repository_id = ? AND scmid LIKE ?", project.repository.id, "#{name}%"]))
672 672 link = link_to h("#{project_prefix}#{name}"), {:only_path => only_path, :controller => 'repositories', :action => 'revision', :id => project, :rev => changeset.identifier},
673 673 :class => 'changeset',
674 674 :title => truncate_single_line(changeset.comments, :length => 100)
675 675 end
676 676 when 'source', 'export'
677 677 if project && project.repository && User.current.allowed_to?(:browse_repository, project)
678 678 name =~ %r{^[/\\]*(.*?)(@([0-9a-f]+))?(#(L\d+))?$}
679 679 path, rev, anchor = $1, $3, $5
680 680 link = link_to h("#{project_prefix}#{prefix}:#{name}"), {:controller => 'repositories', :action => 'entry', :id => project,
681 681 :path => to_path_param(path),
682 682 :rev => rev,
683 683 :anchor => anchor,
684 684 :format => (prefix == 'export' ? 'raw' : nil)},
685 685 :class => (prefix == 'export' ? 'source download' : 'source')
686 686 end
687 687 when 'attachment'
688 688 attachments = options[:attachments] || (obj && obj.respond_to?(:attachments) ? obj.attachments : nil)
689 689 if attachments && attachment = attachments.detect {|a| a.filename == name }
690 690 link = link_to h(attachment.filename), {:only_path => only_path, :controller => 'attachments', :action => 'download', :id => attachment},
691 691 :class => 'attachment'
692 692 end
693 693 when 'project'
694 694 if p = Project.visible.find(:first, :conditions => ["identifier = :s OR LOWER(name) = :s", {:s => name.downcase}])
695 695 link = link_to_project(p, {:only_path => only_path}, :class => 'project')
696 696 end
697 697 end
698 698 end
699 699 end
700 700 leading + (link || "#{project_prefix}#{prefix}#{sep}#{identifier}")
701 701 end
702 702 end
703 703
704 704 HEADING_RE = /<h(1|2|3|4)( [^>]+)?>(.+?)<\/h(1|2|3|4)>/i unless const_defined?(:HEADING_RE)
705 705
706 706 # Headings and TOC
707 707 # Adds ids and links to headings unless options[:headings] is set to false
708 708 def parse_headings(text, project, obj, attr, only_path, options)
709 709 return if options[:headings] == false
710 710
711 711 text.gsub!(HEADING_RE) do
712 712 level, attrs, content = $1.to_i, $2, $3
713 713 item = strip_tags(content).strip
714 714 anchor = item.gsub(%r{[^\w\s\-]}, '').gsub(%r{\s+(\-+\s*)?}, '-')
715 715 @parsed_headings << [level, anchor, item]
716 716 "<h#{level} #{attrs} id=\"#{anchor}\">#{content}<a href=\"##{anchor}\" class=\"wiki-anchor\">&para;</a></h#{level}>"
717 717 end
718 718 end
719 719
720 720 TOC_RE = /<p>\{\{([<>]?)toc\}\}<\/p>/i unless const_defined?(:TOC_RE)
721 721
722 722 # Renders the TOC with given headings
723 723 def replace_toc(text, headings)
724 724 text.gsub!(TOC_RE) do
725 725 if headings.empty?
726 726 ''
727 727 else
728 728 div_class = 'toc'
729 729 div_class << ' right' if $1 == '>'
730 730 div_class << ' left' if $1 == '<'
731 731 out = "<ul class=\"#{div_class}\"><li>"
732 732 root = headings.map(&:first).min
733 733 current = root
734 734 started = false
735 735 headings.each do |level, anchor, item|
736 736 if level > current
737 737 out << '<ul><li>' * (level - current)
738 738 elsif level < current
739 739 out << "</li></ul>\n" * (current - level) + "</li><li>"
740 740 elsif started
741 741 out << '</li><li>'
742 742 end
743 743 out << "<a href=\"##{anchor}\">#{item}</a>"
744 744 current = level
745 745 started = true
746 746 end
747 747 out << '</li></ul>' * (current - root)
748 748 out << '</li></ul>'
749 749 end
750 750 end
751 751 end
752 752
753 753 # Same as Rails' simple_format helper without using paragraphs
754 754 def simple_format_without_paragraph(text)
755 755 text.to_s.
756 756 gsub(/\r\n?/, "\n"). # \r\n and \r -> \n
757 757 gsub(/\n\n+/, "<br /><br />"). # 2+ newline -> 2 br
758 758 gsub(/([^\n]\n)(?=[^\n])/, '\1<br />') # 1 newline -> br
759 759 end
760 760
761 761 def lang_options_for_select(blank=true)
762 762 (blank ? [["(auto)", ""]] : []) +
763 763 valid_languages.collect{|lang| [ ll(lang.to_s, :general_lang_name), lang.to_s]}.sort{|x,y| x.last <=> y.last }
764 764 end
765 765
766 766 def label_tag_for(name, option_tags = nil, options = {})
767 767 label_text = l(("field_"+field.to_s.gsub(/\_id$/, "")).to_sym) + (options.delete(:required) ? @template.content_tag("span", " *", :class => "required"): "")
768 768 content_tag("label", label_text)
769 769 end
770 770
771 771 def labelled_tabular_form_for(name, object, options, &proc)
772 772 options[:html] ||= {}
773 773 options[:html][:class] = 'tabular' unless options[:html].has_key?(:class)
774 774 form_for(name, object, options.merge({ :builder => TabularFormBuilder, :lang => current_language}), &proc)
775 775 end
776 776
777 777 def back_url_hidden_field_tag
778 778 back_url = params[:back_url] || request.env['HTTP_REFERER']
779 779 back_url = CGI.unescape(back_url.to_s)
780 780 hidden_field_tag('back_url', CGI.escape(back_url)) unless back_url.blank?
781 781 end
782 782
783 783 def check_all_links(form_name)
784 784 link_to_function(l(:button_check_all), "checkAll('#{form_name}', true)") +
785 785 " | " +
786 786 link_to_function(l(:button_uncheck_all), "checkAll('#{form_name}', false)")
787 787 end
788 788
789 789 def progress_bar(pcts, options={})
790 790 pcts = [pcts, pcts] unless pcts.is_a?(Array)
791 791 pcts = pcts.collect(&:round)
792 792 pcts[1] = pcts[1] - pcts[0]
793 793 pcts << (100 - pcts[1] - pcts[0])
794 794 width = options[:width] || '100px;'
795 795 legend = options[:legend] || ''
796 796 content_tag('table',
797 797 content_tag('tr',
798 798 (pcts[0] > 0 ? content_tag('td', '', :style => "width: #{pcts[0]}%;", :class => 'closed') : '') +
799 799 (pcts[1] > 0 ? content_tag('td', '', :style => "width: #{pcts[1]}%;", :class => 'done') : '') +
800 800 (pcts[2] > 0 ? content_tag('td', '', :style => "width: #{pcts[2]}%;", :class => 'todo') : '')
801 801 ), :class => 'progress', :style => "width: #{width};") +
802 802 content_tag('p', legend, :class => 'pourcent')
803 803 end
804 804
805 805 def checked_image(checked=true)
806 806 if checked
807 807 image_tag 'toggle_check.png'
808 808 end
809 809 end
810 810
811 811 def context_menu(url)
812 812 unless @context_menu_included
813 813 content_for :header_tags do
814 814 javascript_include_tag('context_menu') +
815 815 stylesheet_link_tag('context_menu')
816 816 end
817 817 if l(:direction) == 'rtl'
818 818 content_for :header_tags do
819 819 stylesheet_link_tag('context_menu_rtl')
820 820 end
821 821 end
822 822 @context_menu_included = true
823 823 end
824 824 javascript_tag "new ContextMenu('#{ url_for(url) }')"
825 825 end
826 826
827 827 def context_menu_link(name, url, options={})
828 828 options[:class] ||= ''
829 829 if options.delete(:selected)
830 830 options[:class] << ' icon-checked disabled'
831 831 options[:disabled] = true
832 832 end
833 833 if options.delete(:disabled)
834 834 options.delete(:method)
835 835 options.delete(:confirm)
836 836 options.delete(:onclick)
837 837 options[:class] << ' disabled'
838 838 url = '#'
839 839 end
840 840 link_to name, url, options
841 841 end
842 842
843 843 def calendar_for(field_id)
844 844 include_calendar_headers_tags
845 845 image_tag("calendar.png", {:id => "#{field_id}_trigger",:class => "calendar-trigger"}) +
846 846 javascript_tag("Calendar.setup({inputField : '#{field_id}', ifFormat : '%Y-%m-%d', button : '#{field_id}_trigger' });")
847 847 end
848 848
849 849 def include_calendar_headers_tags
850 850 unless @calendar_headers_tags_included
851 851 @calendar_headers_tags_included = true
852 852 content_for :header_tags do
853 853 start_of_week = case Setting.start_of_week.to_i
854 854 when 1
855 855 'Calendar._FD = 1;' # Monday
856 856 when 7
857 857 'Calendar._FD = 0;' # Sunday
858 858 else
859 859 '' # use language
860 860 end
861 861
862 862 javascript_include_tag('calendar/calendar') +
863 863 javascript_include_tag("calendar/lang/calendar-#{current_language.to_s.downcase}.js") +
864 864 javascript_tag(start_of_week) +
865 865 javascript_include_tag('calendar/calendar-setup') +
866 866 stylesheet_link_tag('calendar')
867 867 end
868 868 end
869 869 end
870 870
871 871 def content_for(name, content = nil, &block)
872 872 @has_content ||= {}
873 873 @has_content[name] = true
874 874 super(name, content, &block)
875 875 end
876 876
877 877 def has_content?(name)
878 878 (@has_content && @has_content[name]) || false
879 879 end
880 880
881 881 # Returns the avatar image tag for the given +user+ if avatars are enabled
882 882 # +user+ can be a User or a string that will be scanned for an email address (eg. 'joe <joe@foo.bar>')
883 883 def avatar(user, options = { })
884 884 if Setting.gravatar_enabled?
885 885 options.merge!({:ssl => (defined?(request) && request.ssl?), :default => Setting.gravatar_default})
886 886 email = nil
887 887 if user.respond_to?(:mail)
888 888 email = user.mail
889 889 elsif user.to_s =~ %r{<(.+?)>}
890 890 email = $1
891 891 end
892 892 return gravatar(email.to_s.downcase, options) unless email.blank? rescue nil
893 893 else
894 894 ''
895 895 end
896 896 end
897 897
898 898 # Returns the javascript tags that are included in the html layout head
899 899 def javascript_heads
900 900 tags = javascript_include_tag(:defaults)
901 901 unless User.current.pref.warn_on_leaving_unsaved == '0'
902 902 tags << "\n" + javascript_tag("Event.observe(window, 'load', function(){ new WarnLeavingUnsaved('#{escape_javascript( l(:text_warn_on_leaving_unsaved) )}'); });")
903 903 end
904 904 tags
905 905 end
906 906
907 907 def favicon
908 908 "<link rel='shortcut icon' href='#{image_path('/favicon.ico')}' />"
909 909 end
910 910
911 911 # Returns true if arg is expected in the API response
912 912 def include_in_api_response?(arg)
913 913 unless @included_in_api_response
914 914 param = params[:include]
915 915 @included_in_api_response = param.is_a?(Array) ? param.collect(&:to_s) : param.to_s.split(',')
916 916 @included_in_api_response.collect!(&:strip)
917 917 end
918 918 @included_in_api_response.include?(arg.to_s)
919 919 end
920 920
921 921 # Returns options or nil if nometa param or X-Redmine-Nometa header
922 922 # was set in the request
923 923 def api_meta(options)
924 924 if params[:nometa].present? || request.headers['X-Redmine-Nometa']
925 925 # compatibility mode for activeresource clients that raise
926 926 # an error when unserializing an array with attributes
927 927 nil
928 928 else
929 929 options
930 930 end
931 931 end
932 932
933 933 private
934 934
935 935 def wiki_helper
936 936 helper = Redmine::WikiFormatting.helper_for(Setting.text_formatting)
937 937 extend helper
938 938 return self
939 939 end
940 940
941 941 def link_to_remote_content_update(text, url_params)
942 942 link_to_remote(text,
943 943 {:url => url_params, :method => :get, :update => 'content', :complete => 'window.scrollTo(0,0)'},
944 944 {:href => url_for(:params => url_params)}
945 945 )
946 946 end
947 947
948 948 end
@@ -1,26 +1,26
1 1 <div class="contextual">
2 2 <%= watcher_tag(@wiki, User.current) %>
3 3 </div>
4 4
5 5 <h2><%= l(:label_index_by_title) %></h2>
6 6
7 7 <% if @pages.empty? %>
8 8 <p class="nodata"><%= l(:label_no_data) %></p>
9 9 <% end %>
10 10
11 <%= render_page_hierarchy(@pages_by_parent_id) %>
11 <%= render_page_hierarchy(@pages_by_parent_id, nil, :timestamp => true) %>
12 12
13 13 <% content_for :sidebar do %>
14 14 <%= render :partial => 'sidebar' %>
15 15 <% end %>
16 16
17 17 <% unless @pages.empty? %>
18 18 <% other_formats_links do |f| %>
19 19 <%= f.link_to 'Atom', :url => {:controller => 'activities', :action => 'show', :id => @project, :show_wiki_edits => 1, :key => User.current.rss_key} %>
20 20 <%= f.link_to('HTML', :url => {:action => 'export'}) if User.current.allowed_to?(:export_wiki_pages, @project) %>
21 21 <% end %>
22 22 <% end %>
23 23
24 24 <% content_for :header_tags do %>
25 25 <%= auto_discovery_link_tag(:atom, :controller => 'activities', :action => 'show', :id => @project, :show_wiki_edits => 1, :format => 'atom', :key => User.current.rss_key) %>
26 26 <% end %>
General Comments 0
You need to be logged in to leave comments. Login now