application_helper.rb 13.3 KB
Newer Older
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19
# redMine - project management software
# Copyright (C) 2006-2007  Jean-Philippe Lang
#
# This program is free software; you can redistribute it and/or
# modify it under the terms of the GNU General Public License
# as published by the Free Software Foundation; either version 2
# of the License, or (at your option) any later version.
# 
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
# GNU General Public License for more details.
# 
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.

module ApplicationHelper

jplang's avatar
jplang committed
20 21
  def current_role
    @current_role ||= User.current.role_for_project(@project)
22 23 24
  end
  
  # Return true if user is authorized for controller/action, otherwise false
jplang's avatar
jplang committed
25 26
  def authorize_for(controller, action)
    User.current.allowed_to?({:controller => controller, :action => action}, @project)
27 28 29 30
  end

  # Display a link if user is authorized
  def link_to_if_authorized(name, options = {}, html_options = nil, *parameters_for_method_reference)
jplang's avatar
jplang committed
31
    link_to(name, options, html_options, *parameters_for_method_reference) if authorize_for(options[:controller] || params[:controller], options[:action])
32 33 34 35
  end

  # Display a link to user's account page
  def link_to_user(user)
36
    link_to user.name, :controller => 'account', :action => 'show', :id => user
37 38
  end
  
jplang's avatar
jplang committed
39 40 41 42
  def link_to_issue(issue)
    link_to "#{issue.tracker.name} ##{issue.id}", :controller => "issues", :action => "show", :id => issue
  end
  
jplang's avatar
jplang committed
43 44 45 46 47 48 49
  def toggle_link(name, id, options={})
    onclick = "Element.toggle('#{id}'); "
    onclick << (options[:focus] ? "Form.Element.focus('#{options[:focus]}'); " : "this.blur(); ")
    onclick << "return false;"
    link_to(name, "#", :onclick => onclick)
  end
  
jplang's avatar
jplang committed
50 51 52 53 54 55 56 57
  def show_and_goto_link(name, id, options={})
    onclick = "Element.show('#{id}'); "
    onclick << (options[:focus] ? "Form.Element.focus('#{options[:focus]}'); " : "this.blur(); ")
    onclick << "location.href='##{id}-anchor'; "
    onclick << "return false;"
    link_to(name, "#", options.merge(:onclick => onclick))
  end
  
58 59 60 61 62 63 64 65
  def image_to_function(name, function, html_options = {})
    html_options.symbolize_keys!
    tag(:input, html_options.merge({ 
        :type => "image", :src => image_path(name), 
        :onclick => (html_options[:onclick] ? "#{html_options[:onclick]}; " : "") + "#{function};" 
        }))
  end
  
66 67 68 69 70
  def prompt_to_remote(name, text, param, url, html_options = {})
    html_options[:onclick] = "promptToRemote('#{text}', '#{param}', '#{url_for(url)}'); return false;"
    link_to name, {}, html_options
  end
  
71
  def format_date(date)
72
    return nil unless date
73 74
    @date_format ||= (Setting.date_format.to_i == 0 ? l(:general_fmt_date) : date.strftime("%Y-%m-%d"))
    date.strftime(@date_format)
75 76 77
  end
  
  def format_time(time)
78 79 80 81
    return nil unless time
    @date_format_setting ||= Setting.date_format.to_i
    time = time.to_time if time.is_a?(String)
    @date_format_setting == 0 ? l_datetime(time) : (time.strftime("%Y-%m-%d") + ' ' + l_time(time))
82 83
  end
  
84
  def authoring(created, author)
85 86
    time_tag = content_tag('acronym', distance_of_time_in_words(Time.now, created), :title => format_time(created))
    l(:label_added_time_by, author.name, time_tag)
87 88
  end
  
89 90 91 92 93 94 95 96 97
  def day_name(day)
    l(:general_day_names).split(',')[day-1]
  end
  
  def month_name(month)
    l(:actionview_datehelper_select_month_names).split(',')[month-1]
  end

  def pagination_links_full(paginator, options={}, html_options={})
98 99
    page_param = options.delete(:page_param) || :page
  
100 101
    html = ''    
    html << link_to_remote(('&#171; ' + l(:label_previous)), 
102 103
                            {:update => "content", :url => options.merge(page_param => paginator.current.previous)},
                            {:href => url_for(:params => options.merge(page_param => paginator.current.previous))}) + ' ' if paginator.current.previous
104 105 106
                            
    html << (pagination_links_each(paginator, options) do |n|
      link_to_remote(n.to_s, 
107 108
                      {:url => {:params => options.merge(page_param => n)}, :update => 'content'},
                      {:href => url_for(:params => options.merge(page_param => n))})
109 110 111
    end || '')
    
    html << ' ' + link_to_remote((l(:label_next) + ' &#187;'), 
112 113
                                 {:update => "content", :url => options.merge(page_param => paginator.current.next)},
                                 {:href => url_for(:params => options.merge(page_param => paginator.current.next))}) if paginator.current.next
114 115 116
    html  
  end
  
117 118 119 120 121 122 123 124 125 126 127 128
  def set_html_title(text)
    @html_header_title = text
  end
  
  def html_title
    title = []
    title << @project.name if @project
    title << @html_header_title
    title << Setting.app_title
    title.compact.join(' - ')
  end
  
129
  # format text according to system settings
130
  def textilizable(text, options = {})
131
    return "" if text.blank?
132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148

    # when using an image link, try to use an attachment, if possible
    attachments = options[:attachments]
    if attachments
      text = text.gsub(/!([<>=]*)(\S+\.(gif|jpg|jpeg|png))!/) do |m|
        align = $1
        filename = $2
        rf = Regexp.new(filename,  Regexp::IGNORECASE)
        # search for the picture in attachments
        if found = attachments.detect { |att| att.filename =~ rf }
          image_url = url_for :controller => 'attachments', :action => 'download', :id => found.id
          "!#{align}#{image_url}!"
        else
          "!#{align}#{filename}!"
        end
      end
    end
149
    
150 151 152
    text = (Setting.text_formatting == 'textile') ?
      Redmine::WikiFormatting.to_html(text) : simple_format(auto_link(h(text)))

153 154 155 156
    # different methods for formatting wiki links
    case options[:wiki_links]
    when :local
      # used for local links to html files
157
      format_wiki_link = Proc.new {|project, title| "#{title}.html" }
158 159
    when :anchor
      # used for single-file wiki export
160
      format_wiki_link = Proc.new {|project, title| "##{title}" }
161
    else
162
      format_wiki_link = Proc.new {|project, title| url_for :controller => 'wiki', :action => 'index', :id => project, :page => title }
163 164
    end
    
165 166
    project = options[:project] || @project
    
167
    # turn wiki links into html links
168
    # example:
169 170 171 172
    #   [[mypage]]
    #   [[mypage|mytext]]
    # wiki links can refer other project wikis, using project name or identifier:
    #   [[project:]] -> wiki starting page
173
    #   [[project:|mytext]]
174 175 176
    #   [[project:mypage]]
    #   [[project:mypage|mytext]]
    text = text.gsub(/\[\[([^\]\|]+)(\|([^\]\|]+))?\]\]/) do |m|
177
      link_project = project
178 179 180
      page = $1
      title = $3
      if page =~ /^([^\:]+)\:(.*)$/
181
        link_project = Project.find_by_name($1) || Project.find_by_identifier($1)
182
        page = title || $2
183 184
        title = $1 if page.blank?
      end
jplang's avatar
jplang committed
185 186 187 188 189 190 191 192 193 194
      
      if link_project && link_project.wiki
        # check if page exists
        wiki_page = link_project.wiki.find_page(page)
        link_to((title || page), format_wiki_link.call(link_project, Wiki.titleize(page)),
                                 :class => ('wiki-page' + (wiki_page ? '' : ' new')))
      else
        # project or wiki doesn't exist
        title || page
      end
195
    end
196

197
    # turn issue and revision ids into links
198
    # example:
199
    #   #52 -> <a href="/issues/show/52">#52</a>
200 201 202 203 204
    #   r52 -> <a href="/repositories/revision/6?rev=52">r52</a> (project.id is 6)
    text = text.gsub(%r{([\s,-^])(#|r)(\d+)(?=[[:punct:]]|\s|<|$)}) do |m|
      leading, otype, oid = $1, $2, $3
      link = nil
      if otype == 'r'
jplang's avatar
jplang committed
205 206 207 208
        if project && (changeset = project.changesets.find_by_revision(oid))
          link = link_to("r#{oid}", {:controller => 'repositories', :action => 'revision', :id => project.id, :rev => oid}, :class => 'changeset',
                                    :title => truncate(changeset.comments, 100))
        end
209
      else
jplang's avatar
jplang committed
210 211 212 213 214
        if issue = Issue.find_by_id(oid.to_i, :include => [:project, :status], :conditions => Project.visible_by(User.current))        
          link = link_to("##{oid}", {:controller => 'issues', :action => 'show', :id => oid}, :class => 'issue',
                                    :title => "#{truncate(issue.subject, 100)} (#{issue.status.name})")
          link = content_tag('del', link) if issue.closed?
        end
215
      end
216
      leading + (link || "#{otype}#{oid}")
217
    end
218 219
    
    text
220 221
  end
  
jplang's avatar
jplang committed
222 223 224 225 226 227 228 229
  # Same as Rails' simple_format helper without using paragraphs
  def simple_format_without_paragraph(text)
    text.to_s.
      gsub(/\r\n?/, "\n").                    # \r\n and \r -> \n
      gsub(/\n\n+/, "<br /><br />").          # 2+ newline  -> 2 br
      gsub(/([^\n]\n)(?=[^\n])/, '\1<br />')  # 1 newline   -> br
  end
  
230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256
  def error_messages_for(object_name, options = {})
    options = options.symbolize_keys
    object = instance_variable_get("@#{object_name}")
    if object && !object.errors.empty?
      # build full_messages here with controller current language
      full_messages = []
      object.errors.each do |attr, msg|
        next if msg.nil?
        msg = msg.first if msg.is_a? Array
        if attr == "base"
          full_messages << l(msg)
        else
          full_messages << "&#171; " + (l_has_string?("field_" + attr) ? l("field_" + attr) : object.class.human_attribute_name(attr)) + " &#187; " + l(msg) unless attr == "custom_values"
        end
      end
      # retrieve custom values error messages
      if object.errors[:custom_values]
        object.custom_values.each do |v| 
          v.errors.each do |attr, msg|
            next if msg.nil?
            msg = msg.first if msg.is_a? Array
            full_messages << "&#171; " + v.custom_field.name + " &#187; " + l(msg)
          end
        end
      end      
      content_tag("div",
        content_tag(
257
          options[:header_tag] || "span", lwr(:gui_validation_error, full_messages.length) + ":"
258 259 260 261 262 263 264 265 266 267 268
        ) +
        content_tag("ul", full_messages.collect { |msg| content_tag("li", msg) }),
        "id" => options[:id] || "errorExplanation", "class" => options[:class] || "errorExplanation"
      )
    else
      ""
    end
  end
  
  def lang_options_for_select(blank=true)
    (blank ? [["(auto)", ""]] : []) + 
269
      GLoc.valid_languages.collect{|lang| [ ll(lang.to_s, :general_lang_name), lang.to_s]}.sort{|x,y| x.first <=> y.first }
270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292
  end
  
  def label_tag_for(name, option_tags = nil, options = {})
    label_text = l(("field_"+field.to_s.gsub(/\_id$/, "")).to_sym) + (options.delete(:required) ? @template.content_tag("span", " *", :class => "required"): "")
    content_tag("label", label_text)
  end
  
  def labelled_tabular_form_for(name, object, options, &proc)
    options[:html] ||= {}
    options[:html].store :class, "tabular"
    form_for(name, object, options.merge({ :builder => TabularFormBuilder, :lang => current_language}), &proc)
  end
  
  def check_all_links(form_name)
    link_to_function(l(:button_check_all), "checkAll('#{form_name}', true)") +
    " | " +
    link_to_function(l(:button_uncheck_all), "checkAll('#{form_name}', false)")   
  end
  
  def calendar_for(field_id)
    image_tag("calendar.png", {:id => "#{field_id}_trigger",:class => "calendar-trigger"}) +
    javascript_tag("Calendar.setup({inputField : '#{field_id}', ifFormat : '%Y-%m-%d', button : '#{field_id}_trigger' });")
  end
jplang's avatar
jplang committed
293 294 295 296 297
  
  def wikitoolbar_for(field_id)
    return '' unless Setting.text_formatting == 'textile'
    javascript_include_tag('jstoolbar') + javascript_tag("var toolbar = new jsToolBar($('#{field_id}')); toolbar.draw();")
  end
jplang's avatar
jplang committed
298 299 300 301 302 303 304 305 306 307
  
  def content_for(name, content = nil, &block)
    @has_content ||= {}
    @has_content[name] = true
    super(name, content, &block)
  end
  
  def has_content?(name)
    (@has_content && @has_content[name]) || false
  end
jplang's avatar
jplang committed
308
end
309 310 311 312 313 314 315 316 317 318 319 320 321

class TabularFormBuilder < ActionView::Helpers::FormBuilder
  include GLoc
  
  def initialize(object_name, object, template, options, proc)
    set_language_if_valid options.delete(:lang)
    @object_name, @object, @template, @options, @proc = object_name, object, template, options, proc        
  end      
      
  (field_helpers - %w(radio_button hidden_field) + %w(date_select)).each do |selector|
    src = <<-END_SRC
    def #{selector}(field, options = {}) 
      return super if options.delete :no_label
322 323 324
      label_text = l(options[:label]) if options[:label]
      label_text ||= l(("field_"+field.to_s.gsub(/\_id$/, "")).to_sym)
      label_text << @template.content_tag("span", " *", :class => "required") if options.delete(:required)
325 326 327 328 329 330 331 332 333 334 335 336 337 338 339 340 341 342 343
      label = @template.content_tag("label", label_text, 
                    :class => (@object && @object.errors[field] ? "error" : nil), 
                    :for => (@object_name.to_s + "_" + field.to_s))
      label + super
    end
    END_SRC
    class_eval src, __FILE__, __LINE__
  end
  
  def select(field, choices, options = {}, html_options = {}) 
    label_text = l(("field_"+field.to_s.gsub(/\_id$/, "")).to_sym) + (options.delete(:required) ? @template.content_tag("span", " *", :class => "required"): "")
    label = @template.content_tag("label", label_text, 
                  :class => (@object && @object.errors[field] ? "error" : nil), 
                  :for => (@object_name.to_s + "_" + field.to_s))
    label + super
  end

end