jro_apps/redmine Commit - r10960:1386c10074f9

1

# encoding: utf-8

1

# encoding: utf-8

2

#

2

#

3

# Redmine - project management software

3

# Redmine - project management software

4

5

#

5

#

6

# This program is free software; you can redistribute it and/or

6

# This program is free software; you can redistribute it and/or

7

# modify it under the terms of the GNU General Public License

7

# modify it under the terms of the GNU General Public License

8

# as published by the Free Software Foundation; either version 2

8

# as published by the Free Software Foundation; either version 2

9

# of the License, or (at your option) any later version.

9

# of the License, or (at your option) any later version.

10

#

10

#

11

# This program is distributed in the hope that it will be useful,

11

# This program is distributed in the hope that it will be useful,

12

# but WITHOUT ANY WARRANTY; without even the implied warranty of

12

# but WITHOUT ANY WARRANTY; without even the implied warranty of

13

# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the

13

# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the

14

# GNU General Public License for more details.

14

# GNU General Public License for more details.

15

#

15

#

16

# You should have received a copy of the GNU General Public License

16

# You should have received a copy of the GNU General Public License

17

# along with this program; if not, write to the Free Software

17

# along with this program; if not, write to the Free Software

18

# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.

18

# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.

19

20

require 'forwardable'

20

require 'forwardable'

21

require 'cgi'

21

require 'cgi'

22

23

module ApplicationHelper

23

module ApplicationHelper

24

include Redmine::WikiFormatting::Macros::Definitions

24

include Redmine::WikiFormatting::Macros::Definitions

25

include Redmine::I18n

25

include Redmine::I18n

26

include GravatarHelper::PublicMethods

26

include GravatarHelper::PublicMethods

27

include Redmine::Pagination::Helper

27

include Redmine::Pagination::Helper

28

29

extend Forwardable

29

extend Forwardable

30

def_delegators :wiki_helper, :wikitoolbar_for, :heads_for_wiki_formatter

30

def_delegators :wiki_helper, :wikitoolbar_for, :heads_for_wiki_formatter

31

32

# Return true if user is authorized for controller/action, otherwise false

32

# Return true if user is authorized for controller/action, otherwise false

33

def authorize_for(controller, action)

33

def authorize_for(controller, action)

34

User.current.allowed_to?({:controller => controller, :action => action}, @project)

34

User.current.allowed_to?({:controller => controller, :action => action}, @project)

35

end

35

end

36

37

# Display a link if user is authorized

37

# Display a link if user is authorized

38

#

38

#

39

# @param [String] name Anchor text (passed to link_to)

39

# @param [String] name Anchor text (passed to link_to)

40

# @param [Hash] options Hash params. This will checked by authorize_for to see if the user is authorized

40

# @param [Hash] options Hash params. This will checked by authorize_for to see if the user is authorized

41

# @param [optional, Hash] html_options Options passed to link_to

41

# @param [optional, Hash] html_options Options passed to link_to

42

# @param [optional, Hash] parameters_for_method_reference Extra parameters for link_to

42

# @param [optional, Hash] parameters_for_method_reference Extra parameters for link_to

43

def link_to_if_authorized(name, options = {}, html_options = nil, *parameters_for_method_reference)

43

def link_to_if_authorized(name, options = {}, html_options = nil, *parameters_for_method_reference)

44

link_to(name, options, html_options, *parameters_for_method_reference) if authorize_for(options[:controller] || params[:controller], options[:action])

44

link_to(name, options, html_options, *parameters_for_method_reference) if authorize_for(options[:controller] || params[:controller], options[:action])

45

end

45

end

46

47

# Displays a link to user's account page if active

47

# Displays a link to user's account page if active

48

def link_to_user(user, options={})

48

def link_to_user(user, options={})

49

if user.is_a?(User)

49

if user.is_a?(User)

50

name = h(user.name(options[:format]))

50

name = h(user.name(options[:format]))

51

if user.active? || (User.current.admin? && user.logged?)

51

if user.active? || (User.current.admin? && user.logged?)

52

link_to name, user_path(user), :class => user.css_classes

52

link_to name, user_path(user), :class => user.css_classes

53

else

53

else

54

name

54

name

55

end

55

end

56

else

56

else

57

h(user.to_s)

57

h(user.to_s)

58

end

58

end

59

end

59

end

60

61

# Displays a link to +issue+ with its subject.

61

# Displays a link to +issue+ with its subject.

62

# Examples:

62

# Examples:

63

#

63

#

64

# link_to_issue(issue) # => Defect #6: This is the subject

64

# link_to_issue(issue) # => Defect #6: This is the subject

65

# link_to_issue(issue, :truncate => 6) # => Defect #6: This i...

65

# link_to_issue(issue, :truncate => 6) # => Defect #6: This i...

66

# link_to_issue(issue, :subject => false) # => Defect #6

66

# link_to_issue(issue, :subject => false) # => Defect #6

67

# link_to_issue(issue, :project => true) # => Foo - Defect #6

67

# link_to_issue(issue, :project => true) # => Foo - Defect #6

68

# link_to_issue(issue, :subject => false, :tracker => false) # => #6

68

# link_to_issue(issue, :subject => false, :tracker => false) # => #6

69

#

69

#

70

def link_to_issue(issue, options={})

70

def link_to_issue(issue, options={})

71

title = nil

71

title = nil

72

subject = nil

72

subject = nil

73

text = options[:tracker] == false ? "##{issue.id}" : "#{issue.tracker} ##{issue.id}"

73

text = options[:tracker] == false ? "##{issue.id}" : "#{issue.tracker} ##{issue.id}"

74

if options[:subject] == false

74

if options[:subject] == false

75

title = truncate(issue.subject, :length => 60)

75

title = truncate(issue.subject, :length => 60)

76

else

76

else

77

subject = issue.subject

77

subject = issue.subject

78

if options[:truncate]

78

if options[:truncate]

79

subject = truncate(subject, :length => options[:truncate])

79

subject = truncate(subject, :length => options[:truncate])

80

end

80

end

81

end

81

end

82

s = link_to text, issue_path(issue), :class => issue.css_classes, :title => title

82

s = link_to text, issue_path(issue), :class => issue.css_classes, :title => title

83

s << h(": #{subject}") if subject

83

s << h(": #{subject}") if subject

84

s = h("#{issue.project} - ") + s if options[:project]

84

s = h("#{issue.project} - ") + s if options[:project]

85

s

85

s

86

end

86

end

87

88

# Generates a link to an attachment.

88

# Generates a link to an attachment.

89

# Options:

89

# Options:

90

# * :text - Link text (default to attachment filename)

90

# * :text - Link text (default to attachment filename)

91

# * :download - Force download (default: false)

91

# * :download - Force download (default: false)

92

def link_to_attachment(attachment, options={})

92

def link_to_attachment(attachment, options={})

93

text = options.delete(:text) || attachment.filename

93

text = options.delete(:text) || attachment.filename

94

route_method = options.delete(:download) ? :download_named_attachment_path : :named_attachment_path

94

route_method = options.delete(:download) ? :download_named_attachment_path : :named_attachment_path

95

html_options = options.slice!(:only_path)

95

html_options = options.slice!(:only_path)

96

url = send(route_method, attachment, attachment.filename, options)

96

url = send(route_method, attachment, attachment.filename, options)

97

link_to text, url, html_options

97

link_to text, url, html_options

98

end

98

end

99

100

# Generates a link to a SCM revision

100

# Generates a link to a SCM revision

101

# Options:

101

# Options:

102

# * :text - Link text (default to the formatted revision)

102

# * :text - Link text (default to the formatted revision)

103

def link_to_revision(revision, repository, options={})

103

def link_to_revision(revision, repository, options={})

104

if repository.is_a?(Project)

104

if repository.is_a?(Project)

105

repository = repository.repository

105

repository = repository.repository

106

end

106

end

107

text = options.delete(:text) || format_revision(revision)

107

text = options.delete(:text) || format_revision(revision)

108

rev = revision.respond_to?(:identifier) ? revision.identifier : revision

108

rev = revision.respond_to?(:identifier) ? revision.identifier : revision

109

link_to(

109

link_to(

110

h(text),

110

h(text),

111

{:controller => 'repositories', :action => 'revision', :id => repository.project, :repository_id => repository.identifier_param, :rev => rev},

111

{:controller => 'repositories', :action => 'revision', :id => repository.project, :repository_id => repository.identifier_param, :rev => rev},

112

:title => l(:label_revision_id, format_revision(revision))

112

:title => l(:label_revision_id, format_revision(revision))

113

)

113

)

114

end

114

end

115

116

# Generates a link to a message

116

# Generates a link to a message

117

def link_to_message(message, options={}, html_options = nil)

117

def link_to_message(message, options={}, html_options = nil)

118

link_to(

118

link_to(

119

truncate(message.subject, :length => 60),

119

truncate(message.subject, :length => 60),

120

board_message_path(message.board_id, message.parent_id || message.id, {

120

board_message_path(message.board_id, message.parent_id || message.id, {

121

:r => (message.parent_id && message.id),

121

:r => (message.parent_id && message.id),

122

:anchor => (message.parent_id ? "message-#{message.id}" : nil)

122

:anchor => (message.parent_id ? "message-#{message.id}" : nil)

123

}.merge(options)),

123

}.merge(options)),

124

html_options

124

html_options

125

)

125

)

126

end

126

end

127

128

# Generates a link to a project if active

128

# Generates a link to a project if active

129

# Examples:

129

# Examples:

130

#

130

#

131

# link_to_project(project) # => link to the specified project overview

131

# link_to_project(project) # => link to the specified project overview

132

# link_to_project(project, {:only_path => false}, :class => "project") # => 3rd arg adds html options

132

# link_to_project(project, {:only_path => false}, :class => "project") # => 3rd arg adds html options

133

# link_to_project(project, {}, :class => "project") # => html options with default url (project overview)

133

# link_to_project(project, {}, :class => "project") # => html options with default url (project overview)

134

#

134

#

135

def link_to_project(project, options={}, html_options = nil)

135

def link_to_project(project, options={}, html_options = nil)

136

if project.archived?

136

if project.archived?

137

h(project.name)

137

h(project.name)

138

elsif options.key?(:action)

138

elsif options.key?(:action)

139

ActiveSupport::Deprecation.warn "#link_to_project with :action option is deprecated and will be removed in Redmine 3.0."

139

ActiveSupport::Deprecation.warn "#link_to_project with :action option is deprecated and will be removed in Redmine 3.0."

140

url = {:controller => 'projects', :action => 'show', :id => project}.merge(options)

140

url = {:controller => 'projects', :action => 'show', :id => project}.merge(options)

141

link_to project.name, url, html_options

141

link_to project.name, url, html_options

142

else

142

else

143

link_to project.name, project_path(project, options), html_options

143

link_to project.name, project_path(project, options), html_options

144

end

144

end

145

end

145

end

146

147

# Generates a link to a project settings if active

147

# Generates a link to a project settings if active

148

def link_to_project_settings(project, options={}, html_options=nil)

148

def link_to_project_settings(project, options={}, html_options=nil)

149

if project.active?

149

if project.active?

150

link_to project.name, settings_project_path(project, options), html_options

150

link_to project.name, settings_project_path(project, options), html_options

151

elsif project.archived?

151

elsif project.archived?

152

h(project.name)

152

h(project.name)

153

else

153

else

154

link_to project.name, project_path(project, options), html_options

154

link_to project.name, project_path(project, options), html_options

155

end

155

end

156

end

156

end

157

158

def wiki_page_path(page, options={})

158

def wiki_page_path(page, options={})

159

url_for({:controller => 'wiki', :action => 'show', :project_id => page.project, :id => page.title}.merge(options))

159

url_for({:controller => 'wiki', :action => 'show', :project_id => page.project, :id => page.title}.merge(options))

160

end

160

end

161

162

def thumbnail_tag(attachment)

162

def thumbnail_tag(attachment)

163

link_to image_tag(thumbnail_path(attachment)),

163

link_to image_tag(thumbnail_path(attachment)),

164

named_attachment_path(attachment, attachment.filename),

164

named_attachment_path(attachment, attachment.filename),

165

:title => attachment.filename

165

:title => attachment.filename

166

end

166

end

167

168

def toggle_link(name, id, options={})

168

def toggle_link(name, id, options={})

169

onclick = "$('##{id}').toggle(); "

169

onclick = "$('##{id}').toggle(); "

170

onclick << (options[:focus] ? "$('##{options[:focus]}').focus(); " : "this.blur(); ")

170

onclick << (options[:focus] ? "$('##{options[:focus]}').focus(); " : "this.blur(); ")

171

onclick << "return false;"

171

onclick << "return false;"

172

link_to(name, "#", :onclick => onclick)

172

link_to(name, "#", :onclick => onclick)

173

end

173

end

174

175

def image_to_function(name, function, html_options = {})

175

def image_to_function(name, function, html_options = {})

176

html_options.symbolize_keys!

176

html_options.symbolize_keys!

177

tag(:input, html_options.merge({

177

tag(:input, html_options.merge({

178

:type => "image", :src => image_path(name),

178

:type => "image", :src => image_path(name),

179

:onclick => (html_options[:onclick] ? "#{html_options[:onclick]}; " : "") + "#{function};"

179

:onclick => (html_options[:onclick] ? "#{html_options[:onclick]}; " : "") + "#{function};"

180

}))

180

}))

181

end

181

end

182

183

def format_activity_title(text)

183

def format_activity_title(text)

184

h(truncate_single_line(text, :length => 100))

184

h(truncate_single_line(text, :length => 100))

185

end

185

end

186

187

def format_activity_day(date)

187

def format_activity_day(date)

188

date == User.current.today ? l(:label_today).titleize : format_date(date)

188

date == User.current.today ? l(:label_today).titleize : format_date(date)

189

end

189

end

190

191

def format_activity_description(text)

191

def format_activity_description(text)

192

h(truncate(text.to_s, :length => 120).gsub(%r{[\r\n]*<(pre|code)>.*$}m, '...')

192

h(truncate(text.to_s, :length => 120).gsub(%r{[\r\n]*<(pre|code)>.*$}m, '...')

193

).gsub(/[\r\n]+/, "<br />").html_safe

193

).gsub(/[\r\n]+/, "<br />").html_safe

194

end

194

end

195

196

def format_version_name(version)

196

def format_version_name(version)

197

if version.project == @project

197

if version.project == @project

198

h(version)

198

h(version)

199

else

199

else

200

h("#{version.project} - #{version}")

200

h("#{version.project} - #{version}")

201

end

201

end

202

end

202

end

203

204

def due_date_distance_in_words(date)

204

def due_date_distance_in_words(date)

205

if date

205

if date

206

l((date < Date.today ? :label_roadmap_overdue : :label_roadmap_due_in), distance_of_date_in_words(Date.today, date))

206

l((date < Date.today ? :label_roadmap_overdue : :label_roadmap_due_in), distance_of_date_in_words(Date.today, date))

207

end

207

end

208

end

208

end

209

210

# Renders a tree of projects as a nested set of unordered lists

210

# Renders a tree of projects as a nested set of unordered lists

211

# The given collection may be a subset of the whole project tree

211

# The given collection may be a subset of the whole project tree

212

# (eg. some intermediate nodes are private and can not be seen)

212

# (eg. some intermediate nodes are private and can not be seen)

213

def render_project_nested_lists(projects)

213

def render_project_nested_lists(projects)

214

s = ''

214

s = ''

215

if projects.any?

215

if projects.any?

216

ancestors = []

216

ancestors = []

217

original_project = @project

217

original_project = @project

218

projects.sort_by(&:lft).each do |project|

218

projects.sort_by(&:lft).each do |project|

219

# set the project environment to please macros.

219

# set the project environment to please macros.

220

@project = project

220

@project = project

221

if (ancestors.empty? || project.is_descendant_of?(ancestors.last))

221

if (ancestors.empty? || project.is_descendant_of?(ancestors.last))

222

s << "<ul class='projects #{ ancestors.empty? ? 'root' : nil}'>\n"

222

s << "<ul class='projects #{ ancestors.empty? ? 'root' : nil}'>\n"

223

else

223

else

224

ancestors.pop

224

ancestors.pop

225

s << "</li>"

225

s << "</li>"

226

while (ancestors.any? && !project.is_descendant_of?(ancestors.last))

226

while (ancestors.any? && !project.is_descendant_of?(ancestors.last))

227

ancestors.pop

227

ancestors.pop

228

s << "</ul></li>\n"

228

s << "</ul></li>\n"

229

end

229

end

230

end

230

end

231

classes = (ancestors.empty? ? 'root' : 'child')

231

classes = (ancestors.empty? ? 'root' : 'child')

232

s << "<li class='#{classes}'><div class='#{classes}'>"

232

s << "<li class='#{classes}'><div class='#{classes}'>"

233

s << h(block_given? ? yield(project) : project.name)

233

s << h(block_given? ? yield(project) : project.name)

234

s << "</div>\n"

234

s << "</div>\n"

235

ancestors << project

235

ancestors << project

236

end

236

end

237

s << ("</li></ul>\n" * ancestors.size)

237

s << ("</li></ul>\n" * ancestors.size)

238

@project = original_project

238

@project = original_project

239

end

239

end

240

s.html_safe

240

s.html_safe

241

end

241

end

242

243

def render_page_hierarchy(pages, node=nil, options={})

243

def render_page_hierarchy(pages, node=nil, options={})

244

content = ''

244

content = ''

245

if pages[node]

245

if pages[node]

246

content << "<ul class=\"pages-hierarchy\">\n"

246

content << "<ul class=\"pages-hierarchy\">\n"

247

pages[node].each do |page|

247

pages[node].each do |page|

248

content << "<li>"

248

content << "<li>"

249

content << link_to(h(page.pretty_title), {:controller => 'wiki', :action => 'show', :project_id => page.project, :id => page.title, :version => nil},

249

content << link_to(h(page.pretty_title), {:controller => 'wiki', :action => 'show', :project_id => page.project, :id => page.title, :version => nil},

250

:title => (options[:timestamp] && page.updated_on ? l(:label_updated_time, distance_of_time_in_words(Time.now, page.updated_on)) : nil))

250

:title => (options[:timestamp] && page.updated_on ? l(:label_updated_time, distance_of_time_in_words(Time.now, page.updated_on)) : nil))

251

content << "\n" + render_page_hierarchy(pages, page.id, options) if pages[page.id]

251

content << "\n" + render_page_hierarchy(pages, page.id, options) if pages[page.id]

252

content << "</li>\n"

252

content << "</li>\n"

253

end

253

end

254

content << "</ul>\n"

254

content << "</ul>\n"

255

end

255

end

256

content.html_safe

256

content.html_safe

257

end

257

end

258

259

# Renders flash messages

259

# Renders flash messages

260

def render_flash_messages

260

def render_flash_messages

261

s = ''

261

s = ''

262

flash.each do |k,v|

262

flash.each do |k,v|

263

s << content_tag('div', v.html_safe, :class => "flash #{k}", :id => "flash_#{k}")

263

s << content_tag('div', v.html_safe, :class => "flash #{k}", :id => "flash_#{k}")

264

end

264

end

265

s.html_safe

265

s.html_safe

266

end

266

end

267

268

# Renders tabs and their content

268

# Renders tabs and their content

269

def render_tabs(tabs)

269

def render_tabs(tabs)

270

if tabs.any?

270

if tabs.any?

271

render :partial => 'common/tabs', :locals => {:tabs => tabs}

271

render :partial => 'common/tabs', :locals => {:tabs => tabs}

272

else

272

else

273

content_tag 'p', l(:label_no_data), :class => "nodata"

273

content_tag 'p', l(:label_no_data), :class => "nodata"

274

end

274

end

275

end

275

end

276

277

# Renders the project quick-jump box

277

# Renders the project quick-jump box

278

def render_project_jump_box

278

def render_project_jump_box

279

return unless User.current.logged?

279

return unless User.current.logged?

280

projects = User.current.memberships.collect(&:project).compact.select(&:active?).uniq

280

projects = User.current.memberships.collect(&:project).compact.select(&:active?).uniq

281

if projects.any?

281

if projects.any?

282

options =

282

options =

283

("<option value=''>#{ l(:label_jump_to_a_project) }</option>" +

283

("<option value=''>#{ l(:label_jump_to_a_project) }</option>" +

284

'<option value="" disabled="disabled">---</option>').html_safe

284

'<option value="" disabled="disabled">---</option>').html_safe

285

286

options << project_tree_options_for_select(projects, :selected => @project) do |p|

286

options << project_tree_options_for_select(projects, :selected => @project) do |p|

287

{ :value => project_path(:id => p, :jump => current_menu_item) }

287

{ :value => project_path(:id => p, :jump => current_menu_item) }

288

end

288

end

289

290

select_tag('project_quick_jump_box', options, :onchange => 'if (this.value != \'\') { window.location = this.value; }')

290

select_tag('project_quick_jump_box', options, :onchange => 'if (this.value != \'\') { window.location = this.value; }')

291

end

291

end

292

end

292

end

293

294

def project_tree_options_for_select(projects, options = {})

294

def project_tree_options_for_select(projects, options = {})

295

s = ''

295

s = ''

296

project_tree(projects) do |project, level|

296

project_tree(projects) do |project, level|

297

name_prefix = (level > 0 ? ' ' * 2 * level + '» ' : '').html_safe

297

name_prefix = (level > 0 ? ' ' * 2 * level + '» ' : '').html_safe

298

tag_options = {:value => project.id}

298

tag_options = {:value => project.id}

299

if project == options[:selected] || (options[:selected].respond_to?(:include?) && options[:selected].include?(project))

299

if project == options[:selected] || (options[:selected].respond_to?(:include?) && options[:selected].include?(project))

300

tag_options[:selected] = 'selected'

300

tag_options[:selected] = 'selected'

301

else

301

else

302

tag_options[:selected] = nil

302

tag_options[:selected] = nil

303

end

303

end

304

tag_options.merge!(yield(project)) if block_given?

304

tag_options.merge!(yield(project)) if block_given?

305

s << content_tag('option', name_prefix + h(project), tag_options)

305

s << content_tag('option', name_prefix + h(project), tag_options)

306

end

306

end

307

s.html_safe

307

s.html_safe

308

end

308

end

309

310

# Yields the given block for each project with its level in the tree

310

# Yields the given block for each project with its level in the tree

311

#

311

#

312

# Wrapper for Project#project_tree

312

# Wrapper for Project#project_tree

313

def project_tree(projects, &block)

313

def project_tree(projects, &block)

314

Project.project_tree(projects, &block)

314

Project.project_tree(projects, &block)

315

end

315

end

316

317

def principals_check_box_tags(name, principals)

317

def principals_check_box_tags(name, principals)

318

s = ''

318

s = ''

319

principals.sort.each do |principal|

319

principals.sort.each do |principal|

320

s << "<label>#{ check_box_tag name, principal.id, false } #{h principal}</label>\n"

320

s << "<label>#{ check_box_tag name, principal.id, false } #{h principal}</label>\n"

321

end

321

end

322

s.html_safe

322

s.html_safe

323

end

323

end

324

325

# Returns a string for users/groups option tags

325

# Returns a string for users/groups option tags

326

def principals_options_for_select(collection, selected=nil)

326

def principals_options_for_select(collection, selected=nil)

327

s = ''

327

s = ''

328

if collection.include?(User.current)

328

if collection.include?(User.current)

329

s << content_tag('option', "<< #{l(:label_me)} >>", :value => User.current.id)

329

s << content_tag('option', "<< #{l(:label_me)} >>", :value => User.current.id)

330

end

330

end

331

groups = ''

331

groups = ''

332

collection.sort.each do |element|

332

collection.sort.each do |element|

333

selected_attribute = ' selected="selected"' if option_value_selected?(element, selected)

333

selected_attribute = ' selected="selected"' if option_value_selected?(element, selected)

334

(element.is_a?(Group) ? groups : s) << %(<option value="#{element.id}"#{selected_attribute}>#{h element.name}</option>)

334

(element.is_a?(Group) ? groups : s) << %(<option value="#{element.id}"#{selected_attribute}>#{h element.name}</option>)

335

end

335

end

336

unless groups.empty?

336

unless groups.empty?

337

s << %(<optgroup label="#{h(l(:label_group_plural))}">#{groups}</optgroup>)

337

s << %(<optgroup label="#{h(l(:label_group_plural))}">#{groups}</optgroup>)

338

end

338

end

339

s.html_safe

339

s.html_safe

340

end

340

end

341

342

# Options for the new membership projects combo-box

342

# Options for the new membership projects combo-box

343

def options_for_membership_project_select(principal, projects)

343

def options_for_membership_project_select(principal, projects)

344

options = content_tag('option', "--- #{l(:actionview_instancetag_blank_option)} ---")

344

options = content_tag('option', "--- #{l(:actionview_instancetag_blank_option)} ---")

345

options << project_tree_options_for_select(projects) do |p|

345

options << project_tree_options_for_select(projects) do |p|

346

{:disabled => principal.projects.include?(p)}

346

{:disabled => principal.projects.include?(p)}

347

end

347

end

348

options

348

options

349

end

349

end

350

351

# Truncates and returns the string as a single line

351

# Truncates and returns the string as a single line

352

def truncate_single_line(string, *args)

352

def truncate_single_line(string, *args)

353

truncate(string.to_s, *args).gsub(%r{[\r\n]+}m, ' ')

353

truncate(string.to_s, *args).gsub(%r{[\r\n]+}m, ' ')

354

end

354

end

355

356

# Truncates at line break after 250 characters or options[:length]

356

# Truncates at line break after 250 characters or options[:length]

357

def truncate_lines(string, options={})

357

def truncate_lines(string, options={})

358

length = options[:length] || 250

358

length = options[:length] || 250

359

if string.to_s =~ /\A(.{#{length}}.*?)$/m

359

if string.to_s =~ /\A(.{#{length}}.*?)$/m

360

"#{$1}..."

360

"#{$1}..."

361

else

361

else

362

string

362

string

363

end

363

end

364

end

364

end

365

366

def anchor(text)

366

def anchor(text)

367

text.to_s.gsub(' ', '_')

367

text.to_s.gsub(' ', '_')

368

end

368

end

369

370

def html_hours(text)

370

def html_hours(text)

371

text.gsub(%r{(\d+)\.(\d+)}, '<span class="hours hours-int">\1</span><span class="hours hours-dec">.\2</span>').html_safe

371

text.gsub(%r{(\d+)\.(\d+)}, '<span class="hours hours-int">\1</span><span class="hours hours-dec">.\2</span>').html_safe

372

end

372

end

373

374

def authoring(created, author, options={})

374

def authoring(created, author, options={})

375

l(options[:label] || :label_added_time_by, :author => link_to_user(author), :age => time_tag(created)).html_safe

375

l(options[:label] || :label_added_time_by, :author => link_to_user(author), :age => time_tag(created)).html_safe

376

end

376

end

377

378

def time_tag(time)

378

def time_tag(time)

379

text = distance_of_time_in_words(Time.now, time)

379

text = distance_of_time_in_words(Time.now, time)

380

if @project

380

if @project

381

link_to(text, {:controller => 'activities', :action => 'index', :id => @project, :from => User.current.time_to_date(time)}, :title => format_time(time))

381

link_to(text, {:controller => 'activities', :action => 'index', :id => @project, :from => User.current.time_to_date(time)}, :title => format_time(time))

382

else

382

else

383

content_tag('acronym', text, :title => format_time(time))

383

content_tag('acronym', text, :title => format_time(time))

384

end

384

end

385

end

385

end

386

387

def syntax_highlight_lines(name, content)

387

def syntax_highlight_lines(name, content)

388

lines = []

388

lines = []

389

syntax_highlight(name, content).each_line { |line| lines << line }

389

syntax_highlight(name, content).each_line { |line| lines << line }

390

lines

390

lines

391

end

391

end

392

393

def syntax_highlight(name, content)

393

def syntax_highlight(name, content)

394

Redmine::SyntaxHighlighting.highlight_by_filename(content, name)

394

Redmine::SyntaxHighlighting.highlight_by_filename(content, name)

395

end

395

end

396

397

def to_path_param(path)

397

def to_path_param(path)

398

str = path.to_s.split(%r{[/\\]}).select{|p| !p.blank?}.join("/")

398

str = path.to_s.split(%r{[/\\]}).select{|p| !p.blank?}.join("/")

399

str.blank? ? nil : str

399

str.blank? ? nil : str

400

end

400

end

401

402

def reorder_links(name, url, method = :post)

402

def reorder_links(name, url, method = :post)

403

link_to(image_tag('2uparrow.png', :alt => l(:label_sort_highest)),

403

link_to(image_tag('2uparrow.png', :alt => l(:label_sort_highest)),

404

url.merge({"#{name}[move_to]" => 'highest'}),

404

url.merge({"#{name}[move_to]" => 'highest'}),

405

:method => method, :title => l(:label_sort_highest)) +

405

:method => method, :title => l(:label_sort_highest)) +

406

link_to(image_tag('1uparrow.png', :alt => l(:label_sort_higher)),

406

link_to(image_tag('1uparrow.png', :alt => l(:label_sort_higher)),

407

url.merge({"#{name}[move_to]" => 'higher'}),

407

url.merge({"#{name}[move_to]" => 'higher'}),

408

:method => method, :title => l(:label_sort_higher)) +

408

:method => method, :title => l(:label_sort_higher)) +

409

link_to(image_tag('1downarrow.png', :alt => l(:label_sort_lower)),

409

link_to(image_tag('1downarrow.png', :alt => l(:label_sort_lower)),

410

url.merge({"#{name}[move_to]" => 'lower'}),

410

url.merge({"#{name}[move_to]" => 'lower'}),

411

:method => method, :title => l(:label_sort_lower)) +

411

:method => method, :title => l(:label_sort_lower)) +

412

link_to(image_tag('2downarrow.png', :alt => l(:label_sort_lowest)),

412

link_to(image_tag('2downarrow.png', :alt => l(:label_sort_lowest)),

413

url.merge({"#{name}[move_to]" => 'lowest'}),

413

url.merge({"#{name}[move_to]" => 'lowest'}),

414

:method => method, :title => l(:label_sort_lowest))

414

:method => method, :title => l(:label_sort_lowest))

415

end

415

end

416

417

def breadcrumb(*args)

417

def breadcrumb(*args)

418

elements = args.flatten

418

elements = args.flatten

419

elements.any? ? content_tag('p', (args.join(" \xc2\xbb ") + " \xc2\xbb ").html_safe, :class => 'breadcrumb') : nil

419

elements.any? ? content_tag('p', (args.join(" \xc2\xbb ") + " \xc2\xbb ").html_safe, :class => 'breadcrumb') : nil

420

end

420

end

421

422

def other_formats_links(&block)

422

def other_formats_links(&block)

423

concat('<p class="other-formats">'.html_safe + l(:label_export_to))

423

concat('<p class="other-formats">'.html_safe + l(:label_export_to))

424

yield Redmine::Views::OtherFormatsBuilder.new(self)

424

yield Redmine::Views::OtherFormatsBuilder.new(self)

425

concat('</p>'.html_safe)

425

concat('</p>'.html_safe)

426

end

426

end

427

428

def page_header_title

428

def page_header_title

429

if @project.nil? || @project.new_record?

429

if @project.nil? || @project.new_record?

430

h(Setting.app_title)

430

h(Setting.app_title)

431

else

431

else

432

b = []

432

b = []

433

ancestors = (@project.root? ? [] : @project.ancestors.visible.all)

433

ancestors = (@project.root? ? [] : @project.ancestors.visible.all)

434

if ancestors.any?

434

if ancestors.any?

435

root = ancestors.shift

435

root = ancestors.shift

436

b << link_to_project(root, {:jump => current_menu_item}, :class => 'root')

436

b << link_to_project(root, {:jump => current_menu_item}, :class => 'root')

437

if ancestors.size > 2

437

if ancestors.size > 2

438

b << "\xe2\x80\xa6"

438

b << "\xe2\x80\xa6"

439

ancestors = ancestors[-2, 2]

439

ancestors = ancestors[-2, 2]

440

end

440

end

441

b += ancestors.collect {|p| link_to_project(p, {:jump => current_menu_item}, :class => 'ancestor') }

441

b += ancestors.collect {|p| link_to_project(p, {:jump => current_menu_item}, :class => 'ancestor') }

442

end

442

end

443

b << h(@project)

443

b << h(@project)

444

b.join(" \xc2\xbb ").html_safe

444

b.join(" \xc2\xbb ").html_safe

445

end

445

end

446

end

446

end

447

448

def html_title(*args)

448

def html_title(*args)

449

if args.empty?

449

if args.empty?

450

title = @html_title || []

450

title = @html_title || []

451

title << @project.name if @project

451

title << @project.name if @project

452

title << Setting.app_title unless Setting.app_title == title.last

452

title << Setting.app_title unless Setting.app_title == title.last

453

title.select {|t| !t.blank? }.join(' - ')

453

title.select {|t| !t.blank? }.join(' - ')

454

else

454

else

455

@html_title ||= []

455

@html_title ||= []

456

@html_title += args

456

@html_title += args

457

end

457

end

458

end

458

end

459

460

# Returns the theme, controller name, and action as css classes for the

460

# Returns the theme, controller name, and action as css classes for the

461

# HTML body.

461

# HTML body.

462

def body_css_classes

462

def body_css_classes

463

css = []

463

css = []

464

if theme = Redmine::Themes.theme(Setting.ui_theme)

464

if theme = Redmine::Themes.theme(Setting.ui_theme)

465

css << 'theme-' + theme.name

465

css << 'theme-' + theme.name

466

end

466

end

467

468

css << 'controller-' + controller_name

468

css << 'controller-' + controller_name

469

css << 'action-' + action_name

469

css << 'action-' + action_name

470

css.join(' ')

470

css.join(' ')

471

end

471

end

472

473

def accesskey(s)

473

def accesskey(s)

474

Redmine::AccessKeys.key_for s

474

Redmine::AccessKeys.key_for s

475

end

475

end

476

477

# Formats text according to system settings.

477

# Formats text according to system settings.

478

# 2 ways to call this method:

478

# 2 ways to call this method:

479

# * with a String: textilizable(text, options)

479

# * with a String: textilizable(text, options)

480

# * with an object and one of its attribute: textilizable(issue, :description, options)

480

# * with an object and one of its attribute: textilizable(issue, :description, options)

481

def textilizable(*args)

481

def textilizable(*args)

482

options = args.last.is_a?(Hash) ? args.pop : {}

482

options = args.last.is_a?(Hash) ? args.pop : {}

483

case args.size

483

case args.size

484

when 1

484

when 1

485

obj = options[:object]

485

obj = options[:object]

486

text = args.shift

486

text = args.shift

487

when 2

487

when 2

488

obj = args.shift

488

obj = args.shift

489

attr = args.shift

489

attr = args.shift

490

text = obj.send(attr).to_s

490

text = obj.send(attr).to_s

491

else

491

else

492

raise ArgumentError, 'invalid arguments to textilizable'

492

raise ArgumentError, 'invalid arguments to textilizable'

493

end

493

end

494

return '' if text.blank?

494

return '' if text.blank?

495

project = options[:project] || @project || (obj && obj.respond_to?(:project) ? obj.project : nil)

495

project = options[:project] || @project || (obj && obj.respond_to?(:project) ? obj.project : nil)

496

only_path = options.delete(:only_path) == false ? false : true

496

only_path = options.delete(:only_path) == false ? false : true

497

498

text = text.dup

498

text = text.dup

499

macros = catch_macros(text)

499

macros = catch_macros(text)

500

text = Redmine::WikiFormatting.to_html(Setting.text_formatting, text, :object => obj, :attribute => attr)

500

text = Redmine::WikiFormatting.to_html(Setting.text_formatting, text, :object => obj, :attribute => attr)

501

502

@parsed_headings = []

502

@parsed_headings = []

503

@heading_anchors = {}

503

@heading_anchors = {}

504

@current_section = 0 if options[:edit_section_links]

504

@current_section = 0 if options[:edit_section_links]

505

506

parse_sections(text, project, obj, attr, only_path, options)

506

parse_sections(text, project, obj, attr, only_path, options)

507

text = parse_non_pre_blocks(text, obj, macros) do |text|

507

text = parse_non_pre_blocks(text, obj, macros) do |text|

508

[:parse_inline_attachments, :parse_wiki_links, :parse_redmine_links].each do |method_name|

508

[:parse_inline_attachments, :parse_wiki_links, :parse_redmine_links].each do |method_name|

509

send method_name, text, project, obj, attr, only_path, options

509

send method_name, text, project, obj, attr, only_path, options

510

end

510

end

511

end

511

end

512

parse_headings(text, project, obj, attr, only_path, options)

512

parse_headings(text, project, obj, attr, only_path, options)

513

514

if @parsed_headings.any?

514

if @parsed_headings.any?

515

replace_toc(text, @parsed_headings)

515

replace_toc(text, @parsed_headings)

516

end

516

end

517

518

text.html_safe

518

text.html_safe

519

end

519

end

520

521

def parse_non_pre_blocks(text, obj, macros)

521

def parse_non_pre_blocks(text, obj, macros)

522

s = StringScanner.new(text)

522

s = StringScanner.new(text)

523

tags = []

523

tags = []

524

parsed = ''

524

parsed = ''

525

while !s.eos?

525

while !s.eos?

526

s.scan(/(.*?)(<(\/)?(pre|code)(.*?)>|\z)/im)

526

s.scan(/(.*?)(<(\/)?(pre|code)(.*?)>|\z)/im)

527

text, full_tag, closing, tag = s[1], s[2], s[3], s[4]

527

text, full_tag, closing, tag = s[1], s[2], s[3], s[4]

528

if tags.empty?

528

if tags.empty?

529

yield text

529

yield text

530

inject_macros(text, obj, macros) if macros.any?

530

inject_macros(text, obj, macros) if macros.any?

531

else

531

else

532

inject_macros(text, obj, macros, false) if macros.any?

532

inject_macros(text, obj, macros, false) if macros.any?

533

end

533

end

534

parsed << text

534

parsed << text

535

if tag

535

if tag

536

if closing

536

if closing

537

if tags.last == tag.downcase

537

if tags.last == tag.downcase

538

tags.pop

538

tags.pop

539

end

539

end

540

else

540

else

541

tags << tag.downcase

541

tags << tag.downcase

542

end

542

end

543

parsed << full_tag

543

parsed << full_tag

544

end

544

end

545

end

545

end

546

# Close any non closing tags

546

# Close any non closing tags

547

while tag = tags.pop

547

while tag = tags.pop

548

parsed << "</#{tag}>"

548

parsed << "</#{tag}>"

549

end

549

end

550

parsed

550

parsed

551

end

551

end

552

553

def parse_inline_attachments(text, project, obj, attr, only_path, options)

553

def parse_inline_attachments(text, project, obj, attr, only_path, options)

554

# when using an image link, try to use an attachment, if possible

554

# when using an image link, try to use an attachment, if possible

555

attachments = options[:attachments] || []

555

attachments = options[:attachments] || []

556

attachments += obj.attachments if obj.respond_to?(:attachments)

556

attachments += obj.attachments if obj.respond_to?(:attachments)

557

if attachments.present?

557

if attachments.present?

558

text.gsub!(/src="([^\/"]+\.(bmp|gif|jpg|jpe|jpeg|png))"(\s+alt="([^"]*)")?/i) do |m|

558

text.gsub!(/src="([^\/"]+\.(bmp|gif|jpg|jpe|jpeg|png))"(\s+alt="([^"]*)")?/i) do |m|

559

filename, ext, alt, alttext = $1.downcase, $2, $3, $4

559

filename, ext, alt, alttext = $1.downcase, $2, $3, $4

560

# search for the picture in attachments

560

# search for the picture in attachments

561

if found = Attachment.latest_attach(attachments, filename)

561

if found = Attachment.latest_attach(attachments, filename)

562

image_url = download_named_attachment_path(found, found.filename, :only_path => only_path)

562

image_url = download_named_attachment_path(found, found.filename, :only_path => only_path)

563

desc = found.description.to_s.gsub('"', '')

563

desc = found.description.to_s.gsub('"', '')

564

if !desc.blank? && alttext.blank?

564

if !desc.blank? && alttext.blank?

565

alt = " title=\"#{desc}\" alt=\"#{desc}\""

565

alt = " title=\"#{desc}\" alt=\"#{desc}\""

566

end

566

end

567

"src=\"#{image_url}\"#{alt}"

567

"src=\"#{image_url}\"#{alt}"

568

else

568

else

569

m

569

m

570

end

570

end

571

end

571

end

572

end

572

end

573

end

573

end

574

575

# Wiki links

575

# Wiki links

576

#

576

#

577

# Examples:

577

# Examples:

578

# [[mypage]]

578

# [[mypage]]

579

# [[mypage|mytext]]

579

# [[mypage|mytext]]

580

# wiki links can refer other project wikis, using project name or identifier:

580

# wiki links can refer other project wikis, using project name or identifier:

581

# [[project:]] -> wiki starting page

581

# [[project:]] -> wiki starting page

582

# [[project:|mytext]]

582

# [[project:|mytext]]

583

# [[project:mypage]]

583

# [[project:mypage]]

584

# [[project:mypage|mytext]]

584

# [[project:mypage|mytext]]

585

def parse_wiki_links(text, project, obj, attr, only_path, options)

585

def parse_wiki_links(text, project, obj, attr, only_path, options)

586

text.gsub!(/(!)?(\[\[([^\]\n\|]+)(\|([^\]\n\|]+))?\]\])/) do |m|

586

text.gsub!(/(!)?(\[\[([^\]\n\|]+)(\|([^\]\n\|]+))?\]\])/) do |m|

587

link_project = project

587

link_project = project

588

esc, all, page, title = $1, $2, $3, $5

588

esc, all, page, title = $1, $2, $3, $5

589

if esc.nil?

589

if esc.nil?

590

if page =~ /^([^\:]+)\:(.*)$/

590

if page =~ /^([^\:]+)\:(.*)$/

591

link_project = Project.find_by_identifier($1) || Project.find_by_name($1)

591

link_project = Project.find_by_identifier($1) || Project.find_by_name($1)

592

page = $2

592

page = $2

593

title ||= $1 if page.blank?

593

title ||= $1 if page.blank?

594

end

594

end

595

596

if link_project && link_project.wiki

596

if link_project && link_project.wiki

597

# extract anchor

597

# extract anchor

598

anchor = nil

598

anchor = nil

599

if page =~ /^(.+?)\#(.+)$/

599

if page =~ /^(.+?)\#(.+)$/

600

page, anchor = $1, $2

600

page, anchor = $1, $2

601

end

601

end

602

anchor = sanitize_anchor_name(anchor) if anchor.present?

602

anchor = sanitize_anchor_name(anchor) if anchor.present?

603

# check if page exists

603

# check if page exists

604

wiki_page = link_project.wiki.find_page(page)

604

wiki_page = link_project.wiki.find_page(page)

605

url = if anchor.present? && wiki_page.present? && (obj.is_a?(WikiContent) || obj.is_a?(WikiContent::Version)) && obj.page == wiki_page

605

url = if anchor.present? && wiki_page.present? && (obj.is_a?(WikiContent) || obj.is_a?(WikiContent::Version)) && obj.page == wiki_page

606

"##{anchor}"

606

"##{anchor}"

607

else

607

else

608

case options[:wiki_links]

608

case options[:wiki_links]

609

when :local; "#{page.present? ? Wiki.titleize(page) : ''}.html" + (anchor.present? ? "##{anchor}" : '')

609

when :local; "#{page.present? ? Wiki.titleize(page) : ''}.html" + (anchor.present? ? "##{anchor}" : '')

610

when :anchor; "##{page.present? ? Wiki.titleize(page) : title}" + (anchor.present? ? "_#{anchor}" : '') # used for single-file wiki export

610

when :anchor; "##{page.present? ? Wiki.titleize(page) : title}" + (anchor.present? ? "_#{anchor}" : '') # used for single-file wiki export

611

else

611

else

612

wiki_page_id = page.present? ? Wiki.titleize(page) : nil

612

wiki_page_id = page.present? ? Wiki.titleize(page) : nil

613

parent = wiki_page.nil? && obj.is_a?(WikiContent) && obj.page && project == link_project ? obj.page.title : nil

613

parent = wiki_page.nil? && obj.is_a?(WikiContent) && obj.page && project == link_project ? obj.page.title : nil

614

url_for(:only_path => only_path, :controller => 'wiki', :action => 'show', :project_id => link_project,

614

url_for(:only_path => only_path, :controller => 'wiki', :action => 'show', :project_id => link_project,

615

:id => wiki_page_id, :version => nil, :anchor => anchor, :parent => parent)

615

:id => wiki_page_id, :version => nil, :anchor => anchor, :parent => parent)

616

end

616

end

617

end

617

end

618

link_to(title.present? ? title.html_safe : h(page), url, :class => ('wiki-page' + (wiki_page ? '' : ' new')))

618

link_to(title.present? ? title.html_safe : h(page), url, :class => ('wiki-page' + (wiki_page ? '' : ' new')))

619

else

619

else

620

# project or wiki doesn't exist

620

# project or wiki doesn't exist

621

all

621

all

622

end

622

end

623

else

623

else

624

all

624

all

625

end

625

end

626

end

626

end

627

end

627

end

628

629

# Redmine links

629

# Redmine links

630

#

630

#

631

# Examples:

631

# Examples:

632

# Issues:

632

# Issues:

633

# #52 -> Link to issue #52

633

# #52 -> Link to issue #52

634

# Changesets:

634

# Changesets:

635

# r52 -> Link to revision 52

635

# r52 -> Link to revision 52

636

# commit:a85130f -> Link to scmid starting with a85130f

636

# commit:a85130f -> Link to scmid starting with a85130f

637

# Documents:

637

# Documents:

638

# document#17 -> Link to document with id 17

638

# document#17 -> Link to document with id 17

639

# document:Greetings -> Link to the document with title "Greetings"

639

# document:Greetings -> Link to the document with title "Greetings"

640

# document:"Some document" -> Link to the document with title "Some document"

640

# document:"Some document" -> Link to the document with title "Some document"

641

# Versions:

641

# Versions:

642

# version#3 -> Link to version with id 3

642

# version#3 -> Link to version with id 3

643

# version:1.0.0 -> Link to version named "1.0.0"

643

# version:1.0.0 -> Link to version named "1.0.0"

644

# version:"1.0 beta 2" -> Link to version named "1.0 beta 2"

644

# version:"1.0 beta 2" -> Link to version named "1.0 beta 2"

645

# Attachments:

645

# Attachments:

646

# attachment:file.zip -> Link to the attachment of the current object named file.zip

646

# attachment:file.zip -> Link to the attachment of the current object named file.zip

647

# Source files:

647

# Source files:

648

# source:some/file -> Link to the file located at /some/file in the project's repository

648

# source:some/file -> Link to the file located at /some/file in the project's repository

649

# source:some/file@52 -> Link to the file's revision 52

649

# source:some/file@52 -> Link to the file's revision 52

650

# source:some/file#L120 -> Link to line 120 of the file

650

# source:some/file#L120 -> Link to line 120 of the file

651

# source:some/file@52#L120 -> Link to line 120 of the file's revision 52

651

# source:some/file@52#L120 -> Link to line 120 of the file's revision 52

652

# export:some/file -> Force the download of the file

652

# export:some/file -> Force the download of the file

653

# Forum messages:

653

# Forum messages:

654

# message#1218 -> Link to message with id 1218

654

# message#1218 -> Link to message with id 1218

655

#

655

#

656

# Links can refer other objects from other projects, using project identifier:

656

# Links can refer other objects from other projects, using project identifier:

657

# identifier:r52

657

# identifier:r52

658

# identifier:document:"Some document"

658

# identifier:document:"Some document"

659

# identifier:version:1.0.0

659

# identifier:version:1.0.0

660

# identifier:source:some/file

660

# identifier:source:some/file

661

def parse_redmine_links(text, project, obj, attr, only_path, options)

661

def parse_redmine_links(text, project, obj, attr, only_path, options)

662

text.gsub!(%r{([\s\(,\-\[\>]|^)(!)?(([a-z0-9\-_]+):)?(attachment|document|version|forum|news|message|project|commit|source|export)?(((#)|((([a-z0-9\-]+)\|)?(r)))((\d+)((#note)?-(\d+))?)|(:)([^"\s<>][^\s<>]*?|"[^"]+?"))(?=(?=[[:punct:]][^A-Za-z0-9_/])|,|\s|\]|<|$)}) do |m|

662

text.gsub!(%r{([\s\(,\-\[\>]|^)(!)?(([a-z0-9\-_]+):)?(attachment|document|version|forum|news|message|project|commit|source|export)?(((#)|((([a-z0-9\-]+)\|)?(r)))((\d+)((#note)?-(\d+))?)|(:)([^"\s<>][^\s<>]*?|"[^"]+?"))(?=(?=[[:punct:]][^A-Za-z0-9_/])|,|\s|\]|<|$)}) do |m|

663

leading, esc, project_prefix, project_identifier, prefix, repo_prefix, repo_identifier, sep, identifier, comment_suffix, comment_id = $1, $2, $3, $4, $5, $10, $11, $8 || $12 || $18, $14 || $19, $15, $17

663

leading, esc, project_prefix, project_identifier, prefix, repo_prefix, repo_identifier, sep, identifier, comment_suffix, comment_id = $1, $2, $3, $4, $5, $10, $11, $8 || $12 || $18, $14 || $19, $15, $17

664

link = nil

664

link = nil

665

if project_identifier

665

if project_identifier

666

project = Project.visible.find_by_identifier(project_identifier)

666

project = Project.visible.find_by_identifier(project_identifier)

667

end

667

end

668

if esc.nil?

668

if esc.nil?

669

if prefix.nil? && sep == 'r'

669

if prefix.nil? && sep == 'r'

670

if project

670

if project

671

repository = nil

671

repository = nil

672

if repo_identifier

672

if repo_identifier

673

repository = project.repositories.detect {|repo| repo.identifier == repo_identifier}

673

repository = project.repositories.detect {|repo| repo.identifier == repo_identifier}

674

else

674

else

675

repository = project.repository

675

repository = project.repository

676

end

676

end

677

# project.changesets.visible raises an SQL error because of a double join on repositories

677

# project.changesets.visible raises an SQL error because of a double join on repositories

678

if repository && (changeset = Changeset.visible.find_by_repository_id_and_revision(repository.id, identifier))

678

if repository && (changeset = Changeset.visible.find_by_repository_id_and_revision(repository.id, identifier))

679

link = link_to(h("#{project_prefix}#{repo_prefix}r#{identifier}"), {:only_path => only_path, :controller => 'repositories', :action => 'revision', :id => project, :repository_id => repository.identifier_param, :rev => changeset.revision},

679

link = link_to(h("#{project_prefix}#{repo_prefix}r#{identifier}"), {:only_path => only_path, :controller => 'repositories', :action => 'revision', :id => project, :repository_id => repository.identifier_param, :rev => changeset.revision},

680

:class => 'changeset',

680

:class => 'changeset',

681

:title => truncate_single_line(changeset.comments, :length => 100))

681

:title => truncate_single_line(changeset.comments, :length => 100))

682

end

682

end

683

end

683

end

684

elsif sep == '#'

684

elsif sep == '#'

685

oid = identifier.to_i

685

oid = identifier.to_i

686

case prefix

686

case prefix

687

when nil

687

when nil

688

if oid.to_s == identifier && issue = Issue.visible.find_by_id(oid, :include => :status)

688

if oid.to_s == identifier && issue = Issue.visible.find_by_id(oid, :include => :status)

689

anchor = comment_id ? "note-#{comment_id}" : nil

689

anchor = comment_id ? "note-#{comment_id}" : nil

690

link = link_to("##{oid}", {:only_path => only_path, :controller => 'issues', :action => 'show', :id => oid, :anchor => anchor},

690

link = link_to("##{oid}", {:only_path => only_path, :controller => 'issues', :action => 'show', :id => oid, :anchor => anchor},

691

:class => issue.css_classes,

691

:class => issue.css_classes,

692

:title => "#{truncate(issue.subject, :length => 100)} (#{issue.status.name})")

692

:title => "#{truncate(issue.subject, :length => 100)} (#{issue.status.name})")

693

end

693

end

694

when 'document'

694

when 'document'

695

if document = Document.visible.find_by_id(oid)

695

if document = Document.visible.find_by_id(oid)

696

link = link_to h(document.title), {:only_path => only_path, :controller => 'documents', :action => 'show', :id => document},

696

link = link_to h(document.title), {:only_path => only_path, :controller => 'documents', :action => 'show', :id => document},

697

:class => 'document'

697

:class => 'document'

698

end

698

end

699

when 'version'

699

when 'version'

700

if version = Version.visible.find_by_id(oid)

700

if version = Version.visible.find_by_id(oid)

701

link = link_to h(version.name), {:only_path => only_path, :controller => 'versions', :action => 'show', :id => version},

701

link = link_to h(version.name), {:only_path => only_path, :controller => 'versions', :action => 'show', :id => version},

702

:class => 'version'

702

:class => 'version'

703

end

703

end

704

when 'message'

704

when 'message'

705

if message = Message.visible.find_by_id(oid, :include => :parent)

705

if message = Message.visible.find_by_id(oid, :include => :parent)

706

link = link_to_message(message, {:only_path => only_path}, :class => 'message')

706

link = link_to_message(message, {:only_path => only_path}, :class => 'message')

707

end

707

end

708

when 'forum'

708

when 'forum'

709

if board = Board.visible.find_by_id(oid)

709

if board = Board.visible.find_by_id(oid)

710

link = link_to h(board.name), {:only_path => only_path, :controller => 'boards', :action => 'show', :id => board, :project_id => board.project},

710

link = link_to h(board.name), {:only_path => only_path, :controller => 'boards', :action => 'show', :id => board, :project_id => board.project},

711

:class => 'board'

711

:class => 'board'

712

end

712

end

713

when 'news'

713

when 'news'

714

if news = News.visible.find_by_id(oid)

714

if news = News.visible.find_by_id(oid)

715

link = link_to h(news.title), {:only_path => only_path, :controller => 'news', :action => 'show', :id => news},

715

link = link_to h(news.title), {:only_path => only_path, :controller => 'news', :action => 'show', :id => news},

716

:class => 'news'

716

:class => 'news'

717

end

717

end

718

when 'project'

718

when 'project'

719

if p = Project.visible.find_by_id(oid)

719

if p = Project.visible.find_by_id(oid)

720

link = link_to_project(p, {:only_path => only_path}, :class => 'project')

720

link = link_to_project(p, {:only_path => only_path}, :class => 'project')

721

end

721

end

722

end

722

end

723

elsif sep == ':'

723

elsif sep == ':'

724

# removes the double quotes if any

724

# removes the double quotes if any

725

name = identifier.gsub(%r{^"(.*)"$}, "\\1")

725

name = identifier.gsub(%r{^"(.*)"$}, "\\1")

726

case prefix

726

case prefix

727

when 'document'

727

when 'document'

728

if project && document = project.documents.visible.find_by_title(name)

728

if project && document = project.documents.visible.find_by_title(name)

729

link = link_to h(document.title), {:only_path => only_path, :controller => 'documents', :action => 'show', :id => document},

729

link = link_to h(document.title), {:only_path => only_path, :controller => 'documents', :action => 'show', :id => document},

730

:class => 'document'

730

:class => 'document'

731

end

731

end

732

when 'version'

732

when 'version'

733

if project && version = project.versions.visible.find_by_name(name)

733

if project && version = project.versions.visible.find_by_name(name)

734

link = link_to h(version.name), {:only_path => only_path, :controller => 'versions', :action => 'show', :id => version},

734

link = link_to h(version.name), {:only_path => only_path, :controller => 'versions', :action => 'show', :id => version},

735

:class => 'version'

735

:class => 'version'

736

end

736

end

737

when 'forum'

737

when 'forum'

738

if project && board = project.boards.visible.find_by_name(name)

738

if project && board = project.boards.visible.find_by_name(name)

739

link = link_to h(board.name), {:only_path => only_path, :controller => 'boards', :action => 'show', :id => board, :project_id => board.project},

739

link = link_to h(board.name), {:only_path => only_path, :controller => 'boards', :action => 'show', :id => board, :project_id => board.project},

740

:class => 'board'

740

:class => 'board'

741

end

741

end

742

when 'news'

742

when 'news'

743

if project && news = project.news.visible.find_by_title(name)

743

if project && news = project.news.visible.find_by_title(name)

744

link = link_to h(news.title), {:only_path => only_path, :controller => 'news', :action => 'show', :id => news},

744

link = link_to h(news.title), {:only_path => only_path, :controller => 'news', :action => 'show', :id => news},

745

:class => 'news'

745

:class => 'news'

746

end

746

end

747

when 'commit', 'source', 'export'

747

when 'commit', 'source', 'export'

748

if project

748

if project

749

repository = nil

749

repository = nil

750

if name =~ %r{^(([a-z0-9\-]+)\|)(.+)$}

750

if name =~ %r{^(([a-z0-9\-]+)\|)(.+)$}

751

repo_prefix, repo_identifier, name = $1, $2, $3

751

repo_prefix, repo_identifier, name = $1, $2, $3

752

repository = project.repositories.detect {|repo| repo.identifier == repo_identifier}

752

repository = project.repositories.detect {|repo| repo.identifier == repo_identifier}

753

else

753

else

754

repository = project.repository

754

repository = project.repository

755

end

755

end

756

if prefix == 'commit'

756

if prefix == 'commit'

757

if repository && (changeset = Changeset.visible.where("repository_id = ? AND scmid LIKE ?", repository.id, "#{name}%").first)

757

if repository && (changeset = Changeset.visible.where("repository_id = ? AND scmid LIKE ?", repository.id, "#{name}%").first)

758

link = link_to h("#{project_prefix}#{repo_prefix}#{name}"), {:only_path => only_path, :controller => 'repositories', :action => 'revision', :id => project, :repository_id => repository.identifier_param, :rev => changeset.identifier},

758

link = link_to h("#{project_prefix}#{repo_prefix}#{name}"), {:only_path => only_path, :controller => 'repositories', :action => 'revision', :id => project, :repository_id => repository.identifier_param, :rev => changeset.identifier},

759

:class => 'changeset',

759

:class => 'changeset',

760

:title => truncate_single_line(h(changeset.comments), :length => 100)

760

:title => truncate_single_line(h(changeset.comments), :length => 100)

761

end

761

end

762

else

762

else

763

if repository && User.current.allowed_to?(:browse_repository, project)

763

if repository && User.current.allowed_to?(:browse_repository, project)

764

name =~ %r{^[/\\]*(.*?)(@([^/\\@]+?))?(#(L\d+))?$}

764

name =~ %r{^[/\\]*(.*?)(@([^/\\@]+?))?(#(L\d+))?$}

765

path, rev, anchor = $1, $3, $5

765

path, rev, anchor = $1, $3, $5

766

link = link_to h("#{project_prefix}#{prefix}:#{repo_prefix}#{name}"), {:controller => 'repositories', :action => (prefix == 'export' ? 'raw' : 'entry'), :id => project, :repository_id => repository.identifier_param,

766

link = link_to h("#{project_prefix}#{prefix}:#{repo_prefix}#{name}"), {:controller => 'repositories', :action => (prefix == 'export' ? 'raw' : 'entry'), :id => project, :repository_id => repository.identifier_param,

767

:path => to_path_param(path),

767

:path => to_path_param(path),

768

:rev => rev,

768

:rev => rev,

769

:anchor => anchor},

769

:anchor => anchor},

770

:class => (prefix == 'export' ? 'source download' : 'source')

770

:class => (prefix == 'export' ? 'source download' : 'source')

771

end

771

end

772

end

772

end

773

repo_prefix = nil

773

repo_prefix = nil

774

end

774

end

775

when 'attachment'

775

when 'attachment'

776

attachments = options[:attachments] || (obj && obj.respond_to?(:attachments) ? obj.attachments : nil)

776

attachments = options[:attachments] || (obj && obj.respond_to?(:attachments) ? obj.attachments : nil)

777

if attachments && attachment = attachments.detect {|a| a.filename == name }

777

if attachments && attachment = attachments.detect {|a| a.filename == name }

778

link = link_to h(attachment.~~filename~~), {:only_path => only_path, :~~controller~~ => ~~'attachments'~~, :~~action~~ => '~~download'~~, ~~:id~~ => attachment},

778

link = link_to_attachment(attachment, :only_path => only_path, :download => true, :class => 'attachment')

779

:class => 'attachment'

780

end

779

end

781

when 'project'

780

when 'project'

782

if p = Project.visible.where("identifier = :s OR LOWER(name) = :s", :s => name.downcase).first

781

if p = Project.visible.where("identifier = :s OR LOWER(name) = :s", :s => name.downcase).first

783

link = link_to_project(p, {:only_path => only_path}, :class => 'project')

782

link = link_to_project(p, {:only_path => only_path}, :class => 'project')

784

end

783

end

785

end

784

end

786

end

785

end

787

end

786

end

788

(leading + (link || "#{project_prefix}#{prefix}#{repo_prefix}#{sep}#{identifier}#{comment_suffix}"))

787

(leading + (link || "#{project_prefix}#{prefix}#{repo_prefix}#{sep}#{identifier}#{comment_suffix}"))

789

end

788

end

790

end

789

end

791

790

792

HEADING_RE = /(<h(\d)( [^>]+)?>(.+?)<\/h(\d)>)/i unless const_defined?(:HEADING_RE)

791

HEADING_RE = /(<h(\d)( [^>]+)?>(.+?)<\/h(\d)>)/i unless const_defined?(:HEADING_RE)

793

792

794

def parse_sections(text, project, obj, attr, only_path, options)

793

def parse_sections(text, project, obj, attr, only_path, options)

795

return unless options[:edit_section_links]

794

return unless options[:edit_section_links]

796

text.gsub!(HEADING_RE) do

795

text.gsub!(HEADING_RE) do

797

heading = $1

796

heading = $1

798

@current_section += 1

797

@current_section += 1

799

if @current_section > 1

798

if @current_section > 1

800

content_tag('div',

799

content_tag('div',

801

link_to(image_tag('edit.png'), options[:edit_section_links].merge(:section => @current_section)),

800

link_to(image_tag('edit.png'), options[:edit_section_links].merge(:section => @current_section)),

802

:class => 'contextual',

801

:class => 'contextual',

803

:title => l(:button_edit_section)) + heading.html_safe

802

:title => l(:button_edit_section)) + heading.html_safe

804

else

803

else

805

heading

804

heading

806

end

805

end

807

end

806

end

808

end

807

end

809

808

810

# Headings and TOC

809

# Headings and TOC

811

# Adds ids and links to headings unless options[:headings] is set to false

810

# Adds ids and links to headings unless options[:headings] is set to false

812

def parse_headings(text, project, obj, attr, only_path, options)

811

def parse_headings(text, project, obj, attr, only_path, options)

813

return if options[:headings] == false

812

return if options[:headings] == false

814

813

815

text.gsub!(HEADING_RE) do

814

text.gsub!(HEADING_RE) do

816

level, attrs, content = $2.to_i, $3, $4

815

level, attrs, content = $2.to_i, $3, $4

817

item = strip_tags(content).strip

816

item = strip_tags(content).strip

818

anchor = sanitize_anchor_name(item)

817

anchor = sanitize_anchor_name(item)

819

# used for single-file wiki export

818

# used for single-file wiki export

820

anchor = "#{obj.page.title}_#{anchor}" if options[:wiki_links] == :anchor && (obj.is_a?(WikiContent) || obj.is_a?(WikiContent::Version))

819

anchor = "#{obj.page.title}_#{anchor}" if options[:wiki_links] == :anchor && (obj.is_a?(WikiContent) || obj.is_a?(WikiContent::Version))

821

@heading_anchors[anchor] ||= 0

820

@heading_anchors[anchor] ||= 0

822

idx = (@heading_anchors[anchor] += 1)

821

idx = (@heading_anchors[anchor] += 1)

823

if idx > 1

822

if idx > 1

824

anchor = "#{anchor}-#{idx}"

823

anchor = "#{anchor}-#{idx}"

825

end

824

end

826

@parsed_headings << [level, anchor, item]

825

@parsed_headings << [level, anchor, item]

827

"<a name=\"#{anchor}\"></a>\n<h#{level} #{attrs}>#{content}<a href=\"##{anchor}\" class=\"wiki-anchor\">¶</a></h#{level}>"

826

"<a name=\"#{anchor}\"></a>\n<h#{level} #{attrs}>#{content}<a href=\"##{anchor}\" class=\"wiki-anchor\">¶</a></h#{level}>"

828

end

827

end

829

end

828

end

830

829

831

MACROS_RE = /(

830

MACROS_RE = /(

832

(!)? # escaping

831

(!)? # escaping

833

(

832

(

834

\{\{ # opening tag

833

\{\{ # opening tag

835

([\w]+) # macro name

834

([\w]+) # macro name

836

($([^\n\r]*?)$)? # optional arguments

835

($([^\n\r]*?)$)? # optional arguments

837

([\n\r].*?[\n\r])? # optional block of text

836

([\n\r].*?[\n\r])? # optional block of text

838

\}\} # closing tag

837

\}\} # closing tag

839

)

838

)

840

)/mx unless const_defined?(:MACROS_RE)

839

)/mx unless const_defined?(:MACROS_RE)

841

840

842

MACRO_SUB_RE = /(

841

MACRO_SUB_RE = /(

843

\{\{

842

\{\{

844

macro$(\d+)$

843

macro$(\d+)$

845

\}\}

844

\}\}

846

)/x unless const_defined?(:MACRO_SUB_RE)

845

)/x unless const_defined?(:MACRO_SUB_RE)

847

846

848

# Extracts macros from text

847

# Extracts macros from text

849

def catch_macros(text)

848

def catch_macros(text)

850

macros = {}

849

macros = {}

851

text.gsub!(MACROS_RE) do

850

text.gsub!(MACROS_RE) do

852

all, macro = $1, $4.downcase

851

all, macro = $1, $4.downcase

853

if macro_exists?(macro) || all =~ MACRO_SUB_RE

852

if macro_exists?(macro) || all =~ MACRO_SUB_RE

854

index = macros.size

853

index = macros.size

855

macros[index] = all

854

macros[index] = all

856

"{{macro(#{index})}}"

855

"{{macro(#{index})}}"

857

else

856

else

858

all

857

all

859

end

858

end

860

end

859

end

861

macros

860

macros

862

end

861

end

863

862

864

# Executes and replaces macros in text

863

# Executes and replaces macros in text

865

def inject_macros(text, obj, macros, execute=true)

864

def inject_macros(text, obj, macros, execute=true)

866

text.gsub!(MACRO_SUB_RE) do

865

text.gsub!(MACRO_SUB_RE) do

867

all, index = $1, $2.to_i

866

all, index = $1, $2.to_i

868

orig = macros.delete(index)

867

orig = macros.delete(index)

869

if execute && orig && orig =~ MACROS_RE

868

if execute && orig && orig =~ MACROS_RE

870

esc, all, macro, args, block = $2, $3, $4.downcase, $6.to_s, $7.try(:strip)

869

esc, all, macro, args, block = $2, $3, $4.downcase, $6.to_s, $7.try(:strip)

871

if esc.nil?

870

if esc.nil?

872

h(exec_macro(macro, obj, args, block) || all)

871

h(exec_macro(macro, obj, args, block) || all)

873

else

872

else

874

h(all)

873

h(all)

875

end

874

end

876

elsif orig

875

elsif orig

877

h(orig)

876

h(orig)

878

else

877

else

879

h(all)

878

h(all)

880

end

879

end

881

end

880

end

882

end

881

end

883

882

884

TOC_RE = /<p>\{\{([<>]?)toc\}\}<\/p>/i unless const_defined?(:TOC_RE)

883

TOC_RE = /<p>\{\{([<>]?)toc\}\}<\/p>/i unless const_defined?(:TOC_RE)

885

884

886

# Renders the TOC with given headings

885

# Renders the TOC with given headings

887

def replace_toc(text, headings)

886

def replace_toc(text, headings)

888

text.gsub!(TOC_RE) do

887

text.gsub!(TOC_RE) do

889

# Keep only the 4 first levels

888

# Keep only the 4 first levels

890

headings = headings.select{|level, anchor, item| level <= 4}

889

headings = headings.select{|level, anchor, item| level <= 4}

891

if headings.empty?

890

if headings.empty?

892

''

891

''

893

else

892

else

894

div_class = 'toc'

893

div_class = 'toc'

895

div_class << ' right' if $1 == '>'

894

div_class << ' right' if $1 == '>'

896

div_class << ' left' if $1 == '<'

895

div_class << ' left' if $1 == '<'

897

out = "<ul class=\"#{div_class}\"><li>"

896

out = "<ul class=\"#{div_class}\"><li>"

898

root = headings.map(&:first).min

897

root = headings.map(&:first).min

899

current = root

898

current = root

900

started = false

899

started = false

901

headings.each do |level, anchor, item|

900

headings.each do |level, anchor, item|

902

if level > current

901

if level > current

903

out << '<ul><li>' * (level - current)

902

out << '<ul><li>' * (level - current)

904

elsif level < current

903

elsif level < current

905

out << "</li></ul>\n" * (current - level) + "</li><li>"

904

out << "</li></ul>\n" * (current - level) + "</li><li>"

906

elsif started

905

elsif started

907

out << '</li><li>'

906

out << '</li><li>'

908

end

907

end

909

out << "<a href=\"##{anchor}\">#{item}</a>"

908

out << "<a href=\"##{anchor}\">#{item}</a>"

910

current = level

909

current = level

911

started = true

910

started = true

912

end

911

end

913

out << '</li></ul>' * (current - root)

912

out << '</li></ul>' * (current - root)

914

out << '</li></ul>'

913

out << '</li></ul>'

915

end

914

end

916

end

915

end

917

end

916

end

918

917

919

# Same as Rails' simple_format helper without using paragraphs

918

# Same as Rails' simple_format helper without using paragraphs

920

def simple_format_without_paragraph(text)

919

def simple_format_without_paragraph(text)

921

text.to_s.

920

text.to_s.

922

gsub(/\r\n?/, "\n"). # \r\n and \r -> \n

921

gsub(/\r\n?/, "\n"). # \r\n and \r -> \n

923

gsub(/\n\n+/, "<br /><br />"). # 2+ newline -> 2 br

922

gsub(/\n\n+/, "<br /><br />"). # 2+ newline -> 2 br

924

gsub(/([^\n]\n)(?=[^\n])/, '\1<br />'). # 1 newline -> br

923

gsub(/([^\n]\n)(?=[^\n])/, '\1<br />'). # 1 newline -> br

925

html_safe

924

html_safe

926

end

925

end

927

926

928

def lang_options_for_select(blank=true)

927

def lang_options_for_select(blank=true)

929

(blank ? [["(auto)", ""]] : []) + languages_options

928

(blank ? [["(auto)", ""]] : []) + languages_options

930

end

929

end

931

930

932

def label_tag_for(name, option_tags = nil, options = {})

931

def label_tag_for(name, option_tags = nil, options = {})

933

label_text = l(("field_"+field.to_s.gsub(/\_id$/, "")).to_sym) + (options.delete(:required) ? @template.content_tag("span", " *", :class => "required"): "")

932

label_text = l(("field_"+field.to_s.gsub(/\_id$/, "")).to_sym) + (options.delete(:required) ? @template.content_tag("span", " *", :class => "required"): "")

934

content_tag("label", label_text)

933

content_tag("label", label_text)

935

end

934

end

936

935

937

def labelled_form_for(*args, &proc)

936

def labelled_form_for(*args, &proc)

938

args << {} unless args.last.is_a?(Hash)

937

args << {} unless args.last.is_a?(Hash)

939

options = args.last

938

options = args.last

940

if args.first.is_a?(Symbol)

939

if args.first.is_a?(Symbol)

941

options.merge!(:as => args.shift)

940

options.merge!(:as => args.shift)

942

end

941

end

943

options.merge!({:builder => Redmine::Views::LabelledFormBuilder})

942

options.merge!({:builder => Redmine::Views::LabelledFormBuilder})

944

form_for(*args, &proc)

943

form_for(*args, &proc)

945

end

944

end

946

945

947

def labelled_fields_for(*args, &proc)

946

def labelled_fields_for(*args, &proc)

948

args << {} unless args.last.is_a?(Hash)

947

args << {} unless args.last.is_a?(Hash)

949

options = args.last

948

options = args.last

950

options.merge!({:builder => Redmine::Views::LabelledFormBuilder})

949

options.merge!({:builder => Redmine::Views::LabelledFormBuilder})

951

fields_for(*args, &proc)

950

fields_for(*args, &proc)

952

end

951

end

953

952

954

def labelled_remote_form_for(*args, &proc)

953

def labelled_remote_form_for(*args, &proc)

955

ActiveSupport::Deprecation.warn "ApplicationHelper#labelled_remote_form_for is deprecated and will be removed in Redmine 2.2."

954

ActiveSupport::Deprecation.warn "ApplicationHelper#labelled_remote_form_for is deprecated and will be removed in Redmine 2.2."

956

args << {} unless args.last.is_a?(Hash)

955

args << {} unless args.last.is_a?(Hash)

957

options = args.last

956

options = args.last

958

options.merge!({:builder => Redmine::Views::LabelledFormBuilder, :remote => true})

957

options.merge!({:builder => Redmine::Views::LabelledFormBuilder, :remote => true})

959

form_for(*args, &proc)

958

form_for(*args, &proc)

960

end

959

end

961

960

962

def error_messages_for(*objects)

961

def error_messages_for(*objects)

963

html = ""

962

html = ""

964

objects = objects.map {|o| o.is_a?(String) ? instance_variable_get("@#{o}") : o}.compact

963

objects = objects.map {|o| o.is_a?(String) ? instance_variable_get("@#{o}") : o}.compact

965

errors = objects.map {|o| o.errors.full_messages}.flatten

964

errors = objects.map {|o| o.errors.full_messages}.flatten

966

if errors.any?

965

if errors.any?

967

html << "<div id='errorExplanation'><ul>\n"

966

html << "<div id='errorExplanation'><ul>\n"

968

errors.each do |error|

967

errors.each do |error|

969

html << "<li>#{h error}</li>\n"

968

html << "<li>#{h error}</li>\n"

970

end

969

end

971

html << "</ul></div>\n"

970

html << "</ul></div>\n"

972

end

971

end

973

html.html_safe

972

html.html_safe

974

end

973

end

975

974

976

def delete_link(url, options={})

975

def delete_link(url, options={})

977

options = {

976

options = {

978

:method => :delete,

977

:method => :delete,

979

:data => {:confirm => l(:text_are_you_sure)},

978

:data => {:confirm => l(:text_are_you_sure)},

980

:class => 'icon icon-del'

979

:class => 'icon icon-del'

981

}.merge(options)

980

}.merge(options)

982

981

983

link_to l(:button_delete), url, options

982

link_to l(:button_delete), url, options

984

end

983

end

985

984

986

def preview_link(url, form, target='preview', options={})

985

def preview_link(url, form, target='preview', options={})

987

content_tag 'a', l(:label_preview), {

986

content_tag 'a', l(:label_preview), {

988

:href => "#",

987

:href => "#",

989

:onclick => %|submitPreview("#{escape_javascript url_for(url)}", "#{escape_javascript form}", "#{escape_javascript target}"); return false;|,

988

:onclick => %|submitPreview("#{escape_javascript url_for(url)}", "#{escape_javascript form}", "#{escape_javascript target}"); return false;|,

990

:accesskey => accesskey(:preview)

989

:accesskey => accesskey(:preview)

991

}.merge(options)

990

}.merge(options)

992

end

991

end

993

992

994

def link_to_function(name, function, html_options={})

993

def link_to_function(name, function, html_options={})

995

content_tag(:a, name, {:href => '#', :onclick => "#{function}; return false;"}.merge(html_options))

994

content_tag(:a, name, {:href => '#', :onclick => "#{function}; return false;"}.merge(html_options))

996

end

995

end

997

996

998

# Helper to render JSON in views

997

# Helper to render JSON in views

999

def raw_json(arg)

998

def raw_json(arg)

1000

arg.to_json.to_s.gsub('/', '\/').html_safe

999

arg.to_json.to_s.gsub('/', '\/').html_safe

1001

end

1000

end

1002

1001

1003

def back_url

1002

def back_url

1004

url = params[:back_url]

1003

url = params[:back_url]

1005

if url.nil? && referer = request.env['HTTP_REFERER']

1004

if url.nil? && referer = request.env['HTTP_REFERER']

1006

url = CGI.unescape(referer.to_s)

1005

url = CGI.unescape(referer.to_s)

1007

end

1006

end

1008

url

1007

url

1009

end

1008

end

1010

1009

1011

def back_url_hidden_field_tag

1010

def back_url_hidden_field_tag

1012

url = back_url

1011

url = back_url

1013

hidden_field_tag('back_url', url, :id => nil) unless url.blank?

1012

hidden_field_tag('back_url', url, :id => nil) unless url.blank?

1014

end

1013

end

1015

1014

1016

def check_all_links(form_name)

1015

def check_all_links(form_name)

1017

link_to_function(l(:button_check_all), "checkAll('#{form_name}', true)") +

1016

link_to_function(l(:button_check_all), "checkAll('#{form_name}', true)") +

1018

" | ".html_safe +

1017

" | ".html_safe +

1019

link_to_function(l(:button_uncheck_all), "checkAll('#{form_name}', false)")

1018

link_to_function(l(:button_uncheck_all), "checkAll('#{form_name}', false)")

1020

end

1019

end

1021

1020

1022

def progress_bar(pcts, options={})

1021

def progress_bar(pcts, options={})

1023

pcts = [pcts, pcts] unless pcts.is_a?(Array)

1022

pcts = [pcts, pcts] unless pcts.is_a?(Array)

1024

pcts = pcts.collect(&:round)

1023

pcts = pcts.collect(&:round)

1025

pcts[1] = pcts[1] - pcts[0]

1024

pcts[1] = pcts[1] - pcts[0]

1026

pcts << (100 - pcts[1] - pcts[0])

1025

pcts << (100 - pcts[1] - pcts[0])

1027

width = options[:width] || '100px;'

1026

width = options[:width] || '100px;'

1028

legend = options[:legend] || ''

1027

legend = options[:legend] || ''

1029

content_tag('table',

1028

content_tag('table',

1030

content_tag('tr',

1029

content_tag('tr',

1031

(pcts[0] > 0 ? content_tag('td', '', :style => "width: #{pcts[0]}%;", :class => 'closed') : ''.html_safe) +

1030

(pcts[0] > 0 ? content_tag('td', '', :style => "width: #{pcts[0]}%;", :class => 'closed') : ''.html_safe) +

1032

(pcts[1] > 0 ? content_tag('td', '', :style => "width: #{pcts[1]}%;", :class => 'done') : ''.html_safe) +

1031

(pcts[1] > 0 ? content_tag('td', '', :style => "width: #{pcts[1]}%;", :class => 'done') : ''.html_safe) +

1033

(pcts[2] > 0 ? content_tag('td', '', :style => "width: #{pcts[2]}%;", :class => 'todo') : ''.html_safe)

1032

(pcts[2] > 0 ? content_tag('td', '', :style => "width: #{pcts[2]}%;", :class => 'todo') : ''.html_safe)

1034

), :class => 'progress', :style => "width: #{width};").html_safe +

1033

), :class => 'progress', :style => "width: #{width};").html_safe +

1035

content_tag('p', legend, :class => 'percent').html_safe

1034

content_tag('p', legend, :class => 'percent').html_safe

1036

end

1035

end

1037

1036

1038

def checked_image(checked=true)

1037

def checked_image(checked=true)

1039

if checked

1038

if checked

1040

image_tag 'toggle_check.png'

1039

image_tag 'toggle_check.png'

1041

end

1040

end

1042

end

1041

end

1043

1042

1044

def context_menu(url)

1043

def context_menu(url)

1045

unless @context_menu_included

1044

unless @context_menu_included

1046

content_for :header_tags do

1045

content_for :header_tags do

1047

javascript_include_tag('context_menu') +

1046

javascript_include_tag('context_menu') +

1048

stylesheet_link_tag('context_menu')

1047

stylesheet_link_tag('context_menu')

1049

end

1048

end

1050

if l(:direction) == 'rtl'

1049

if l(:direction) == 'rtl'

1051

content_for :header_tags do

1050

content_for :header_tags do

1052

stylesheet_link_tag('context_menu_rtl')

1051

stylesheet_link_tag('context_menu_rtl')

1053

end

1052

end

1054

end

1053

end

1055

@context_menu_included = true

1054

@context_menu_included = true

1056

end

1055

end

1057

javascript_tag "contextMenuInit('#{ url_for(url) }')"

1056

javascript_tag "contextMenuInit('#{ url_for(url) }')"

1058

end

1057

end

1059

1058

1060

def calendar_for(field_id)

1059

def calendar_for(field_id)

1061

include_calendar_headers_tags

1060

include_calendar_headers_tags

1062

javascript_tag("$(function() { $('##{field_id}').datepicker(datepickerOptions); });")

1061

javascript_tag("$(function() { $('##{field_id}').datepicker(datepickerOptions); });")

1063

end

1062

end

1064

1063

1065

def include_calendar_headers_tags

1064

def include_calendar_headers_tags

1066

unless @calendar_headers_tags_included

1065

unless @calendar_headers_tags_included

1067

@calendar_headers_tags_included = true

1066

@calendar_headers_tags_included = true

1068

content_for :header_tags do

1067

content_for :header_tags do

1069

start_of_week = Setting.start_of_week

1068

start_of_week = Setting.start_of_week

1070

start_of_week = l(:general_first_day_of_week, :default => '1') if start_of_week.blank?

1069

start_of_week = l(:general_first_day_of_week, :default => '1') if start_of_week.blank?

1071

# Redmine uses 1..7 (monday..sunday) in settings and locales

1070

# Redmine uses 1..7 (monday..sunday) in settings and locales

1072

# JQuery uses 0..6 (sunday..saturday), 7 needs to be changed to 0

1071

# JQuery uses 0..6 (sunday..saturday), 7 needs to be changed to 0

1073

start_of_week = start_of_week.to_i % 7

1072

start_of_week = start_of_week.to_i % 7

1074

1073

1075

tags = javascript_tag(

1074

tags = javascript_tag(

1076

"var datepickerOptions={dateFormat: 'yy-mm-dd', firstDay: #{start_of_week}, " +

1075

"var datepickerOptions={dateFormat: 'yy-mm-dd', firstDay: #{start_of_week}, " +

1077

"showOn: 'button', buttonImageOnly: true, buttonImage: '" +

1076

"showOn: 'button', buttonImageOnly: true, buttonImage: '" +

1078

path_to_image('/images/calendar.png') +

1077

path_to_image('/images/calendar.png') +

1079

"', showButtonPanel: true};")

1078

"', showButtonPanel: true};")

1080

jquery_locale = l('jquery.locale', :default => current_language.to_s)

1079

jquery_locale = l('jquery.locale', :default => current_language.to_s)

1081

unless jquery_locale == 'en'

1080

unless jquery_locale == 'en'

1082

tags << javascript_include_tag("i18n/jquery.ui.datepicker-#{jquery_locale}.js")

1081

tags << javascript_include_tag("i18n/jquery.ui.datepicker-#{jquery_locale}.js")

1083

end

1082

end

1084

tags

1083

tags

1085

end

1084

end

1086

end

1085

end

1087

end

1086

end

1088

1087

1089

# Overrides Rails' stylesheet_link_tag with themes and plugins support.

1088

# Overrides Rails' stylesheet_link_tag with themes and plugins support.

1090

# Examples:

1089

# Examples:

1091

# stylesheet_link_tag('styles') # => picks styles.css from the current theme or defaults

1090

# stylesheet_link_tag('styles') # => picks styles.css from the current theme or defaults

1092

# stylesheet_link_tag('styles', :plugin => 'foo) # => picks styles.css from plugin's assets

1091

# stylesheet_link_tag('styles', :plugin => 'foo) # => picks styles.css from plugin's assets

1093

#

1092

#

1094

def stylesheet_link_tag(*sources)

1093

def stylesheet_link_tag(*sources)

1095

options = sources.last.is_a?(Hash) ? sources.pop : {}

1094

options = sources.last.is_a?(Hash) ? sources.pop : {}

1096

plugin = options.delete(:plugin)

1095

plugin = options.delete(:plugin)

1097

sources = sources.map do |source|

1096

sources = sources.map do |source|

1098

if plugin

1097

if plugin

1099

"/plugin_assets/#{plugin}/stylesheets/#{source}"

1098

"/plugin_assets/#{plugin}/stylesheets/#{source}"

1100

elsif current_theme && current_theme.stylesheets.include?(source)

1099

elsif current_theme && current_theme.stylesheets.include?(source)

1101

current_theme.stylesheet_path(source)

1100

current_theme.stylesheet_path(source)

1102

else

1101

else

1103

source

1102

source

1104

end

1103

end

1105

end

1104

end

1106

super sources, options

1105

super sources, options

1107

end

1106

end

1108

1107

1109

# Overrides Rails' image_tag with themes and plugins support.

1108

# Overrides Rails' image_tag with themes and plugins support.

1110

# Examples:

1109

# Examples:

1111

# image_tag('image.png') # => picks image.png from the current theme or defaults

1110

# image_tag('image.png') # => picks image.png from the current theme or defaults

1112

# image_tag('image.png', :plugin => 'foo) # => picks image.png from plugin's assets

1111

# image_tag('image.png', :plugin => 'foo) # => picks image.png from plugin's assets

1113

#

1112

#

1114

def image_tag(source, options={})

1113

def image_tag(source, options={})

1115

if plugin = options.delete(:plugin)

1114

if plugin = options.delete(:plugin)

1116

source = "/plugin_assets/#{plugin}/images/#{source}"

1115

source = "/plugin_assets/#{plugin}/images/#{source}"

1117

elsif current_theme && current_theme.images.include?(source)

1116

elsif current_theme && current_theme.images.include?(source)

1118

source = current_theme.image_path(source)

1117

source = current_theme.image_path(source)

1119

end

1118

end

1120

super source, options

1119

super source, options

1121

end

1120

end

1122

1121

1123

# Overrides Rails' javascript_include_tag with plugins support

1122

# Overrides Rails' javascript_include_tag with plugins support

1124

# Examples:

1123

# Examples:

1125

# javascript_include_tag('scripts') # => picks scripts.js from defaults

1124

# javascript_include_tag('scripts') # => picks scripts.js from defaults

1126

# javascript_include_tag('scripts', :plugin => 'foo) # => picks scripts.js from plugin's assets

1125

# javascript_include_tag('scripts', :plugin => 'foo) # => picks scripts.js from plugin's assets

1127

#

1126

#

1128

def javascript_include_tag(*sources)

1127

def javascript_include_tag(*sources)

1129

options = sources.last.is_a?(Hash) ? sources.pop : {}

1128

options = sources.last.is_a?(Hash) ? sources.pop : {}

1130

if plugin = options.delete(:plugin)

1129

if plugin = options.delete(:plugin)

1131

sources = sources.map do |source|

1130

sources = sources.map do |source|

1132

if plugin

1131

if plugin

1133

"/plugin_assets/#{plugin}/javascripts/#{source}"

1132

"/plugin_assets/#{plugin}/javascripts/#{source}"

1134

else

1133

else

1135

source

1134

source

1136

end

1135

end

1137

end

1136

end

1138

end

1137

end

1139

super sources, options

1138

super sources, options

1140

end

1139

end

1141

1140

1142

def content_for(name, content = nil, &block)

1141

def content_for(name, content = nil, &block)

1143

@has_content ||= {}

1142

@has_content ||= {}

1144

@has_content[name] = true

1143

@has_content[name] = true

1145

super(name, content, &block)

1144

super(name, content, &block)

1146

end

1145

end

1147

1146

1148

def has_content?(name)

1147

def has_content?(name)

1149

(@has_content && @has_content[name]) || false

1148

(@has_content && @has_content[name]) || false

1150

end

1149

end

1151

1150

1152

def sidebar_content?

1151

def sidebar_content?

1153

has_content?(:sidebar) || view_layouts_base_sidebar_hook_response.present?

1152

has_content?(:sidebar) || view_layouts_base_sidebar_hook_response.present?

1154

end

1153

end

1155

1154

1156

def view_layouts_base_sidebar_hook_response

1155

def view_layouts_base_sidebar_hook_response

1157

@view_layouts_base_sidebar_hook_response ||= call_hook(:view_layouts_base_sidebar)

1156

@view_layouts_base_sidebar_hook_response ||= call_hook(:view_layouts_base_sidebar)

1158

end

1157

end

1159

1158

1160

def email_delivery_enabled?

1159

def email_delivery_enabled?

1161

!!ActionMailer::Base.perform_deliveries

1160

!!ActionMailer::Base.perform_deliveries

1162

end

1161

end

1163

1162

1164

# Returns the avatar image tag for the given +user+ if avatars are enabled

1163

# Returns the avatar image tag for the given +user+ if avatars are enabled

1165

# +user+ can be a User or a string that will be scanned for an email address (eg. 'joe <joe@foo.bar>')

1164

# +user+ can be a User or a string that will be scanned for an email address (eg. 'joe <joe@foo.bar>')

1166

def avatar(user, options = { })

1165

def avatar(user, options = { })

1167

if Setting.gravatar_enabled?

1166

if Setting.gravatar_enabled?

1168

options.merge!({:ssl => (request && request.ssl?), :default => Setting.gravatar_default})

1167

options.merge!({:ssl => (request && request.ssl?), :default => Setting.gravatar_default})

1169

email = nil

1168

email = nil

1170

if user.respond_to?(:mail)

1169

if user.respond_to?(:mail)

1171

email = user.mail

1170

email = user.mail

1172

elsif user.to_s =~ %r{<(.+?)>}

1171

elsif user.to_s =~ %r{<(.+?)>}

1173

email = $1

1172

email = $1

1174

end

1173

end

1175

return gravatar(email.to_s.downcase, options) unless email.blank? rescue nil

1174

return gravatar(email.to_s.downcase, options) unless email.blank? rescue nil

1176

else

1175

else

1177

''

1176

''

1178

end

1177

end

1179

end

1178

end

1180

1179

1181

def sanitize_anchor_name(anchor)

1180

def sanitize_anchor_name(anchor)

1182

if ''.respond_to?(:encoding) || RUBY_PLATFORM == 'java'

1181

if ''.respond_to?(:encoding) || RUBY_PLATFORM == 'java'

1183

anchor.gsub(%r{[^\p{Word}\s\-]}, '').gsub(%r{\s+(\-+\s*)?}, '-')

1182

anchor.gsub(%r{[^\p{Word}\s\-]}, '').gsub(%r{\s+(\-+\s*)?}, '-')

1184

else

1183

else

1185

# TODO: remove when ruby1.8 is no longer supported

1184

# TODO: remove when ruby1.8 is no longer supported

1186

anchor.gsub(%r{[^\w\s\-]}, '').gsub(%r{\s+(\-+\s*)?}, '-')

1185

anchor.gsub(%r{[^\w\s\-]}, '').gsub(%r{\s+(\-+\s*)?}, '-')

1187

end

1186

end

1188

end

1187

end

1189

1188

1190

# Returns the javascript tags that are included in the html layout head

1189

# Returns the javascript tags that are included in the html layout head

1191

def javascript_heads

1190

def javascript_heads

1192

tags = javascript_include_tag('jquery-1.8.3-ui-1.9.2-ujs-2.0.3', 'application')

1191

tags = javascript_include_tag('jquery-1.8.3-ui-1.9.2-ujs-2.0.3', 'application')

1193

unless User.current.pref.warn_on_leaving_unsaved == '0'

1192

unless User.current.pref.warn_on_leaving_unsaved == '0'

1194

tags << "\n".html_safe + javascript_tag("$(window).load(function(){ warnLeavingUnsaved('#{escape_javascript l(:text_warn_on_leaving_unsaved)}'); });")

1193

tags << "\n".html_safe + javascript_tag("$(window).load(function(){ warnLeavingUnsaved('#{escape_javascript l(:text_warn_on_leaving_unsaved)}'); });")

1195

end

1194

end

1196

tags

1195

tags

1197

end

1196

end

1198

1197

1199

def favicon

1198

def favicon

1200

"<link rel='shortcut icon' href='#{image_path('/favicon.ico')}' />".html_safe

1199

"<link rel='shortcut icon' href='#{image_path('/favicon.ico')}' />".html_safe

1201

end

1200

end

1202

1201

1203

def robot_exclusion_tag

1202

def robot_exclusion_tag

1204

'<meta name="robots" content="noindex,follow,noarchive" />'.html_safe

1203

'<meta name="robots" content="noindex,follow,noarchive" />'.html_safe

1205

end

1204

end

1206

1205

1207

# Returns true if arg is expected in the API response

1206

# Returns true if arg is expected in the API response

1208

def include_in_api_response?(arg)

1207

def include_in_api_response?(arg)

1209

unless @included_in_api_response

1208

unless @included_in_api_response

1210

param = params[:include]

1209

param = params[:include]

1211

@included_in_api_response = param.is_a?(Array) ? param.collect(&:to_s) : param.to_s.split(',')

1210

@included_in_api_response = param.is_a?(Array) ? param.collect(&:to_s) : param.to_s.split(',')

1212

@included_in_api_response.collect!(&:strip)

1211

@included_in_api_response.collect!(&:strip)

1213

end

1212

end

1214

@included_in_api_response.include?(arg.to_s)

1213

@included_in_api_response.include?(arg.to_s)

1215

end

1214

end

1216

1215

1217

# Returns options or nil if nometa param or X-Redmine-Nometa header

1216

# Returns options or nil if nometa param or X-Redmine-Nometa header

1218

# was set in the request

1217

# was set in the request

1219

def api_meta(options)

1218

def api_meta(options)

1220

if params[:nometa].present? || request.headers['X-Redmine-Nometa']

1219

if params[:nometa].present? || request.headers['X-Redmine-Nometa']

1221

# compatibility mode for activeresource clients that raise

1220

# compatibility mode for activeresource clients that raise

1222

# an error when unserializing an array with attributes

1221

# an error when unserializing an array with attributes

1223

nil

1222

nil

1224

else

1223

else

1225

options

1224

options

1226

end

1225

end

1227

end

1226

end

1228

1227

1229

private

1228

private

1230

1229

1231

def wiki_helper

1230

def wiki_helper

1232

helper = Redmine::WikiFormatting.helper_for(Setting.text_formatting)

1231

helper = Redmine::WikiFormatting.helper_for(Setting.text_formatting)

1233

extend helper

1232

extend helper

1234

return self

1233

return self

1235

end

1234

end

1236

1235

1237

def link_to_content_update(text, url_params = {}, html_options = {})

1236

def link_to_content_update(text, url_params = {}, html_options = {})

1238

link_to(text, url_params, html_options)

1237

link_to(text, url_params, html_options)

1239

end

1238

end

1240

end

1239

end

	Site-wide shortcuts
/	Use quick search box
g h	Goto home page
g g	Goto my private gists page
g G	Goto my public gists page
g 0-9	Goto bookmarked items from 0-9
n r	New repository page
n g	New gist page

	Repositories
g s	Goto summary page
g c	Goto changelog page
g f	Goto files page
g F	Goto files page with file search activated
g p	Goto pull requests page
g o	Goto repository settings
g O	Goto repository access permissions settings
t s	Toggle sidebar on some pages

             # encoding: utf-8
             #
             # Redmine - project management software
             # Copyright (C) 2006-2013  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.
             require 'forwardable'
             require 'cgi'
             module ApplicationHelper
               include Redmine::WikiFormatting::Macros::Definitions
               include Redmine::I18n
               include GravatarHelper::PublicMethods
               include Redmine::Pagination::Helper
               extend Forwardable
               def_delegators :wiki_helper, :wikitoolbar_for, :heads_for_wiki_formatter
               # Return true if user is authorized for controller/action, otherwise false
               def authorize_for(controller, action)
                 User.current.allowed_to?({:controller => controller, :action => action}, @project)
               end
               # Display a link if user is authorized
               #
               # @param [String] name Anchor text (passed to link_to)
               # @param [Hash] options Hash params. This will checked by authorize_for to see if the user is authorized
               # @param [optional, Hash] html_options Options passed to link_to
               # @param [optional, Hash] parameters_for_method_reference Extra parameters for link_to
               def link_to_if_authorized(name, options = {}, html_options = nil, *parameters_for_method_reference)
                 link_to(name, options, html_options, *parameters_for_method_reference) if authorize_for(options[:controller] || params[:controller], options[:action])
               end
               # Displays a link to user's account page if active
               def link_to_user(user, options={})
                 if user.is_a?(User)
                   name = h(user.name(options[:format]))
                   if user.active? || (User.current.admin? && user.logged?)
                     link_to name, user_path(user), :class => user.css_classes
                   else
                     name
                   end
                 else
                   h(user.to_s)
                 end
               end
               # Displays a link to +issue+ with its subject.
               # Examples:
               #
               #   link_to_issue(issue)                        # => Defect #6: This is the subject
               #   link_to_issue(issue, :truncate => 6)        # => Defect #6: This i...
               #   link_to_issue(issue, :subject => false)     # => Defect #6
               #   link_to_issue(issue, :project => true)      # => Foo - Defect #6
               #   link_to_issue(issue, :subject => false, :tracker => false)     # => #6
               #
               def link_to_issue(issue, options={})
                 title = nil
                 subject = nil
                 text = options[:tracker] == false ? "##{issue.id}" : "#{issue.tracker} ##{issue.id}"
                 if options[:subject] == false
                   title = truncate(issue.subject, :length => 60)
                 else
                   subject = issue.subject
                   if options[:truncate]
                     subject = truncate(subject, :length => options[:truncate])
                   end
                 end
                 s = link_to text, issue_path(issue), :class => issue.css_classes, :title => title
                 s << h(": #{subject}") if subject
                 s = h("#{issue.project} - ") + s if options[:project]
                 s
               end
               # Generates a link to an attachment.
               # Options:
               # * :text - Link text (default to attachment filename)
               # * :download - Force download (default: false)
               def link_to_attachment(attachment, options={})
                 text = options.delete(:text) || attachment.filename
                 route_method = options.delete(:download) ? :download_named_attachment_path : :named_attachment_path
                 html_options = options.slice!(:only_path)
                 url = send(route_method, attachment, attachment.filename, options)
                 link_to text, url, html_options
               end
               # Generates a link to a SCM revision
               # Options:
               # * :text - Link text (default to the formatted revision)
               def link_to_revision(revision, repository, options={})
                 if repository.is_a?(Project)
                   repository = repository.repository
                 end
                 text = options.delete(:text) || format_revision(revision)
                 rev = revision.respond_to?(:identifier) ? revision.identifier : revision
                 link_to(
                     h(text),
                     {:controller => 'repositories', :action => 'revision', :id => repository.project, :repository_id => repository.identifier_param, :rev => rev},
                     :title => l(:label_revision_id, format_revision(revision))
                   )
               end
               # Generates a link to a message
               def link_to_message(message, options={}, html_options = nil)
                 link_to(
                   truncate(message.subject, :length => 60),
                   board_message_path(message.board_id, message.parent_id || message.id, {
                     :r => (message.parent_id && message.id),
                     :anchor => (message.parent_id ? "message-#{message.id}" : nil)
                   }.merge(options)),
                   html_options
                 )
               end
               # Generates a link to a project if active
               # Examples:
               #
               #   link_to_project(project)                          # => link to the specified project overview
               #   link_to_project(project, {:only_path => false}, :class => "project") # => 3rd arg adds html options
               #   link_to_project(project, {}, :class => "project") # => html options with default url (project overview)
               #
               def link_to_project(project, options={}, html_options = nil)
                 if project.archived?
                   h(project.name)
                 elsif options.key?(:action)
                   ActiveSupport::Deprecation.warn "#link_to_project with :action option is deprecated and will be removed in Redmine 3.0."
                   url = {:controller => 'projects', :action => 'show', :id => project}.merge(options)
                   link_to project.name, url, html_options
                 else
                   link_to project.name, project_path(project, options), html_options
                 end
               end
               # Generates a link to a project settings if active
               def link_to_project_settings(project, options={}, html_options=nil)
                 if project.active?
                   link_to project.name, settings_project_path(project, options), html_options
                 elsif project.archived?
                   h(project.name)
                 else
                   link_to project.name, project_path(project, options), html_options
                 end
               end
               def wiki_page_path(page, options={})
                 url_for({:controller => 'wiki', :action => 'show', :project_id => page.project, :id => page.title}.merge(options))
               end
               def thumbnail_tag(attachment)
                 link_to image_tag(thumbnail_path(attachment)),
                   named_attachment_path(attachment, attachment.filename),
                   :title => attachment.filename
               end
               def toggle_link(name, id, options={})
                 onclick = "$('##{id}').toggle(); "
                 onclick << (options[:focus] ? "$('##{options[:focus]}').focus(); " : "this.blur(); ")
                 onclick << "return false;"
                 link_to(name, "#", :onclick => onclick)
               end
               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
               def format_activity_title(text)
                 h(truncate_single_line(text, :length => 100))
               end
               def format_activity_day(date)
                 date == User.current.today ? l(:label_today).titleize : format_date(date)
               end
               def format_activity_description(text)
                 h(truncate(text.to_s, :length => 120).gsub(%r{[\r\n]*<(pre|code)>.*$}m, '...')
                    ).gsub(/[\r\n]+/, "<br />").html_safe
               end
               def format_version_name(version)
                 if version.project == @project
                 	h(version)
                 else
                   h("#{version.project} - #{version}")
                 end
               end
               def due_date_distance_in_words(date)
                 if date
                   l((date < Date.today ? :label_roadmap_overdue : :label_roadmap_due_in), distance_of_date_in_words(Date.today, date))
                 end
               end
               # Renders a tree of projects as a nested set of unordered lists
               # The given collection may be a subset of the whole project tree
               # (eg. some intermediate nodes are private and can not be seen)
               def render_project_nested_lists(projects)
                 s = ''
                 if projects.any?
                   ancestors = []
                   original_project = @project
                   projects.sort_by(&:lft).each do |project|
                     # set the project environment to please macros.
                     @project = project
                     if (ancestors.empty? || project.is_descendant_of?(ancestors.last))
                       s << "<ul class='projects #{ ancestors.empty? ? 'root' : nil}'>\n"
                     else
                       ancestors.pop
                       s << "</li>"
                       while (ancestors.any? && !project.is_descendant_of?(ancestors.last))
                         ancestors.pop
                         s << "</ul></li>\n"
                       end
                     end
                     classes = (ancestors.empty? ? 'root' : 'child')
                     s << "<li class='#{classes}'><div class='#{classes}'>"
                     s << h(block_given? ? yield(project) : project.name)
                     s << "</div>\n"
                     ancestors << project
                   end
                   s << ("</li></ul>\n" * ancestors.size)
                   @project = original_project
                 end
                 s.html_safe
               end
               def render_page_hierarchy(pages, node=nil, options={})
                 content = ''
                 if pages[node]
                   content << "<ul class=\"pages-hierarchy\">\n"
                   pages[node].each do |page|
                     content << "<li>"
                     content << link_to(h(page.pretty_title), {:controller => 'wiki', :action => 'show', :project_id => page.project, :id => page.title, :version => nil},
                                        :title => (options[:timestamp] && page.updated_on ? l(:label_updated_time, distance_of_time_in_words(Time.now, page.updated_on)) : nil))
                     content << "\n" + render_page_hierarchy(pages, page.id, options) if pages[page.id]
                     content << "</li>\n"
                   end
                   content << "</ul>\n"
                 end
                 content.html_safe
               end
               # Renders flash messages
               def render_flash_messages
                 s = ''
                 flash.each do |k,v|
                   s << content_tag('div', v.html_safe, :class => "flash #{k}", :id => "flash_#{k}")
                 end
                 s.html_safe
               end
               # Renders tabs and their content
               def render_tabs(tabs)
                 if tabs.any?
                   render :partial => 'common/tabs', :locals => {:tabs => tabs}
                 else
                   content_tag 'p', l(:label_no_data), :class => "nodata"
                 end
               end
               # Renders the project quick-jump box
               def render_project_jump_box
                 return unless User.current.logged?
                 projects = User.current.memberships.collect(&:project).compact.select(&:active?).uniq
                 if projects.any?
                   options =
                     ("<option value=''>#{ l(:label_jump_to_a_project) }</option>" +
                      '<option value="" disabled="disabled">---</option>').html_safe
                   options << project_tree_options_for_select(projects, :selected => @project) do |p|
                     { :value => project_path(:id => p, :jump => current_menu_item) }
                   end
                   select_tag('project_quick_jump_box', options, :onchange => 'if (this.value != \'\') { window.location = this.value; }')
                 end
               end
               def project_tree_options_for_select(projects, options = {})
                 s = ''
                 project_tree(projects) do |project, level|
                   name_prefix = (level > 0 ? '&nbsp;' * 2 * level + '&#187; ' : '').html_safe
                   tag_options = {:value => project.id}
                   if project == options[:selected] || (options[:selected].respond_to?(:include?) && options[:selected].include?(project))
                     tag_options[:selected] = 'selected'
                   else
                     tag_options[:selected] = nil
                   end
                   tag_options.merge!(yield(project)) if block_given?
                   s << content_tag('option', name_prefix + h(project), tag_options)
                 end
                 s.html_safe
               end
               # Yields the given block for each project with its level in the tree
               #
               # Wrapper for Project#project_tree
               def project_tree(projects, &block)
                 Project.project_tree(projects, &block)
               end
               def principals_check_box_tags(name, principals)
                 s = ''
                 principals.sort.each do |principal|
                   s << "<label>#{ check_box_tag name, principal.id, false } #{h principal}</label>\n"
                 end
                 s.html_safe
               end
               # Returns a string for users/groups option tags
               def principals_options_for_select(collection, selected=nil)
                 s = ''
                 if collection.include?(User.current)
                   s << content_tag('option', "<< #{l(:label_me)} >>", :value => User.current.id)
                 end
                 groups = ''
                 collection.sort.each do |element|
                   selected_attribute = ' selected="selected"' if option_value_selected?(element, selected)
                   (element.is_a?(Group) ? groups : s) << %(<option value="#{element.id}"#{selected_attribute}>#{h element.name}</option>)
                 end
                 unless groups.empty?
                   s << %(<optgroup label="#{h(l(:label_group_plural))}">#{groups}</optgroup>)
                 end
                 s.html_safe
               end
               # Options for the new membership projects combo-box
               def options_for_membership_project_select(principal, projects)
                 options = content_tag('option', "--- #{l(:actionview_instancetag_blank_option)} ---")
                 options << project_tree_options_for_select(projects) do |p|
                   {:disabled => principal.projects.include?(p)}
                 end
                 options
               end
               # Truncates and returns the string as a single line
               def truncate_single_line(string, *args)
                 truncate(string.to_s, *args).gsub(%r{[\r\n]+}m, ' ')
               end
               # Truncates at line break after 250 characters or options[:length]
               def truncate_lines(string, options={})
                 length = options[:length] || 250
                 if string.to_s =~ /\A(.{#{length}}.*?)$/m
                   "#{$1}..."
                 else
                   string
                 end
               end
               def anchor(text)
                 text.to_s.gsub(' ', '_')
               end
               def html_hours(text)
                 text.gsub(%r{(\d+)\.(\d+)}, '<span class="hours hours-int">\1</span><span class="hours hours-dec">.\2</span>').html_safe
               end
               def authoring(created, author, options={})
                 l(options[:label] || :label_added_time_by, :author => link_to_user(author), :age => time_tag(created)).html_safe
               end
               def time_tag(time)
                 text = distance_of_time_in_words(Time.now, time)
                 if @project
                   link_to(text, {:controller => 'activities', :action => 'index', :id => @project, :from => User.current.time_to_date(time)}, :title => format_time(time))
                 else
                   content_tag('acronym', text, :title => format_time(time))
                 end
               end
               def syntax_highlight_lines(name, content)
                 lines = []
                 syntax_highlight(name, content).each_line { |line| lines << line }
                 lines
               end
               def syntax_highlight(name, content)
                 Redmine::SyntaxHighlighting.highlight_by_filename(content, name)
               end
               def to_path_param(path)
                 str = path.to_s.split(%r{[/\\]}).select{|p| !p.blank?}.join("/")
                 str.blank? ? nil : str
               end
               def reorder_links(name, url, method = :post)
                 link_to(image_tag('2uparrow.png', :alt => l(:label_sort_highest)),
                         url.merge({"#{name}[move_to]" => 'highest'}),
                         :method => method, :title => l(:label_sort_highest)) +
                 link_to(image_tag('1uparrow.png',   :alt => l(:label_sort_higher)),
                         url.merge({"#{name}[move_to]" => 'higher'}),
                        :method => method, :title => l(:label_sort_higher)) +
                 link_to(image_tag('1downarrow.png', :alt => l(:label_sort_lower)),
                         url.merge({"#{name}[move_to]" => 'lower'}),
                         :method => method, :title => l(:label_sort_lower)) +
                 link_to(image_tag('2downarrow.png', :alt => l(:label_sort_lowest)),
                         url.merge({"#{name}[move_to]" => 'lowest'}),
                        :method => method, :title => l(:label_sort_lowest))
               end
               def breadcrumb(*args)
                 elements = args.flatten
                 elements.any? ? content_tag('p', (args.join(" \xc2\xbb ") + " \xc2\xbb ").html_safe, :class => 'breadcrumb') : nil
               end
               def other_formats_links(&block)
                 concat('<p class="other-formats">'.html_safe + l(:label_export_to))
                 yield Redmine::Views::OtherFormatsBuilder.new(self)
                 concat('</p>'.html_safe)
               end
               def page_header_title
                 if @project.nil? || @project.new_record?
                   h(Setting.app_title)
                 else
                   b = []
                   ancestors = (@project.root? ? [] : @project.ancestors.visible.all)
                   if ancestors.any?
                     root = ancestors.shift
                     b << link_to_project(root, {:jump => current_menu_item}, :class => 'root')
                     if ancestors.size > 2
                       b << "\xe2\x80\xa6"
                       ancestors = ancestors[-2, 2]
                     end
                     b += ancestors.collect {|p| link_to_project(p, {:jump => current_menu_item}, :class => 'ancestor') }
                   end
                   b << h(@project)
                   b.join(" \xc2\xbb ").html_safe
                 end
               end
               def html_title(*args)
                 if args.empty?
                   title = @html_title || []
                   title << @project.name if @project
                   title << Setting.app_title unless Setting.app_title == title.last
                   title.select {|t| !t.blank? }.join(' - ')
                 else
                   @html_title ||= []
                   @html_title += args
                 end
               end
               # Returns the theme, controller name, and action as css classes for the
               # HTML body.
               def body_css_classes
                 css = []
                 if theme = Redmine::Themes.theme(Setting.ui_theme)
                   css << 'theme-' + theme.name
                 end
                 css << 'controller-' + controller_name
                 css << 'action-' + action_name
                 css.join(' ')
               end
               def accesskey(s)
                 Redmine::AccessKeys.key_for s
               end
               # Formats text according to system settings.
               # 2 ways to call this method:
               # * with a String: textilizable(text, options)
               # * with an object and one of its attribute: textilizable(issue, :description, options)
               def textilizable(*args)
                 options = args.last.is_a?(Hash) ? args.pop : {}
                 case args.size
                 when 1
                   obj = options[:object]
                   text = args.shift
                 when 2
                   obj = args.shift
                   attr = args.shift
                   text = obj.send(attr).to_s
                 else
                   raise ArgumentError, 'invalid arguments to textilizable'
                 end
                 return '' if text.blank?
                 project = options[:project] || @project || (obj && obj.respond_to?(:project) ? obj.project : nil)
                 only_path = options.delete(:only_path) == false ? false : true
                 text = text.dup
                 macros = catch_macros(text)
                 text = Redmine::WikiFormatting.to_html(Setting.text_formatting, text, :object => obj, :attribute => attr)
                 @parsed_headings = []
                 @heading_anchors = {}
                 @current_section = 0 if options[:edit_section_links]
                 parse_sections(text, project, obj, attr, only_path, options)
                 text = parse_non_pre_blocks(text, obj, macros) do |text|
                   [:parse_inline_attachments, :parse_wiki_links, :parse_redmine_links].each do |method_name|
                     send method_name, text, project, obj, attr, only_path, options
                   end
                 end
                 parse_headings(text, project, obj, attr, only_path, options)
                 if @parsed_headings.any?
                   replace_toc(text, @parsed_headings)
                 end
                 text.html_safe
               end
               def parse_non_pre_blocks(text, obj, macros)
                 s = StringScanner.new(text)
                 tags = []
                 parsed = ''
                 while !s.eos?
                   s.scan(/(.*?)(<(\/)?(pre|code)(.*?)>|\z)/im)
                   text, full_tag, closing, tag = s[1], s[2], s[3], s[4]
                   if tags.empty?
                     yield text
                     inject_macros(text, obj, macros) if macros.any?
                   else
                     inject_macros(text, obj, macros, false) if macros.any?
                   end
                   parsed << text
                   if tag
                     if closing
                       if tags.last == tag.downcase
                         tags.pop
                       end
                     else
                       tags << tag.downcase
                     end
                     parsed << full_tag
                   end
                 end
                 # Close any non closing tags
                 while tag = tags.pop
                   parsed << "</#{tag}>"
                 end
                 parsed
               end
               def parse_inline_attachments(text, project, obj, attr, only_path, options)
                 # when using an image link, try to use an attachment, if possible
                 attachments = options[:attachments] || []
                 attachments += obj.attachments if obj.respond_to?(:attachments)
                 if attachments.present?
                   text.gsub!(/src="([^\/"]+\.(bmp|gif|jpg|jpe|jpeg|png))"(\s+alt="([^"]*)")?/i) do |m|
                     filename, ext, alt, alttext = $1.downcase, $2, $3, $4
                     # search for the picture in attachments
                     if found = Attachment.latest_attach(attachments, filename)
                       image_url = download_named_attachment_path(found, found.filename, :only_path => only_path)
                       desc = found.description.to_s.gsub('"', '')
                       if !desc.blank? && alttext.blank?
                         alt = " title=\"#{desc}\" alt=\"#{desc}\""
                       end
                       "src=\"#{image_url}\"#{alt}"
                     else
                       m
                     end
                   end
                 end
               end
               # Wiki links
               #
               # Examples:
               #   [[mypage]]
               #   [[mypage|mytext]]
               # wiki links can refer other project wikis, using project name or identifier:
               #   [[project:]] -> wiki starting page
               #   [[project:|mytext]]
               #   [[project:mypage]]
               #   [[project:mypage|mytext]]
               def parse_wiki_links(text, project, obj, attr, only_path, options)
                 text.gsub!(/(!)?(\[\[([^\]\n\|]+)(\|([^\]\n\|]+))?\]\])/) do |m|
                   link_project = project
                   esc, all, page, title = $1, $2, $3, $5
                   if esc.nil?
                     if page =~ /^([^\:]+)\:(.*)$/
                       link_project = Project.find_by_identifier($1) || Project.find_by_name($1)
                       page = $2
                       title ||= $1 if page.blank?
                     end
                     if link_project && link_project.wiki
                       # extract anchor
                       anchor = nil
                       if page =~ /^(.+?)\#(.+)$/
                         page, anchor = $1, $2
                       end
                       anchor = sanitize_anchor_name(anchor) if anchor.present?
                       # check if page exists
                       wiki_page = link_project.wiki.find_page(page)
                       url = if anchor.present? && wiki_page.present? && (obj.is_a?(WikiContent) || obj.is_a?(WikiContent::Version)) && obj.page == wiki_page
                         "##{anchor}"
                       else
                         case options[:wiki_links]
                         when :local; "#{page.present? ? Wiki.titleize(page) : ''}.html" + (anchor.present? ? "##{anchor}" : '')
                         when :anchor; "##{page.present? ? Wiki.titleize(page) : title}" + (anchor.present? ? "_#{anchor}" : '') # used for single-file wiki export
                         else
                           wiki_page_id = page.present? ? Wiki.titleize(page) : nil
                           parent = wiki_page.nil? && obj.is_a?(WikiContent) && obj.page && project == link_project ? obj.page.title : nil
                           url_for(:only_path => only_path, :controller => 'wiki', :action => 'show', :project_id => link_project,
                            :id => wiki_page_id, :version => nil, :anchor => anchor, :parent => parent)
                         end
                       end
                       link_to(title.present? ? title.html_safe : h(page), url, :class => ('wiki-page' + (wiki_page ? '' : ' new')))
                     else
                       # project or wiki doesn't exist
                       all
                     end
                   else
                     all
                   end
                 end
               end
               # Redmine links
               #
               # Examples:
               #   Issues:
               #     #52 -> Link to issue #52
               #   Changesets:
               #     r52 -> Link to revision 52
               #     commit:a85130f -> Link to scmid starting with a85130f
               #   Documents:
               #     document#17 -> Link to document with id 17
               #     document:Greetings -> Link to the document with title "Greetings"
               #     document:"Some document" -> Link to the document with title "Some document"
               #   Versions:
               #     version#3 -> Link to version with id 3
               #     version:1.0.0 -> Link to version named "1.0.0"
               #     version:"1.0 beta 2" -> Link to version named "1.0 beta 2"
               #   Attachments:
               #     attachment:file.zip -> Link to the attachment of the current object named file.zip
               #   Source files:
               #     source:some/file -> Link to the file located at /some/file in the project's repository
               #     source:some/file@52 -> Link to the file's revision 52
               #     source:some/file#L120 -> Link to line 120 of the file
               #     source:some/file@52#L120 -> Link to line 120 of the file's revision 52
               #     export:some/file -> Force the download of the file
               #   Forum messages:
               #     message#1218 -> Link to message with id 1218
               #
               #   Links can refer other objects from other projects, using project identifier:
               #     identifier:r52
               #     identifier:document:"Some document"
               #     identifier:version:1.0.0
               #     identifier:source:some/file
               def parse_redmine_links(text, project, obj, attr, only_path, options)
                 text.gsub!(%r{([\s\(,\-\[\>]|^)(!)?(([a-z0-9\-_]+):)?(attachment|document|version|forum|news|message|project|commit|source|export)?(((#)|((([a-z0-9\-]+)\|)?(r)))((\d+)((#note)?-(\d+))?)|(:)([^"\s<>][^\s<>]*?|"[^"]+?"))(?=(?=[[:punct:]][^A-Za-z0-9_/])|,|\s|\]|<|$)}) do |m|
                   leading, esc, project_prefix, project_identifier, prefix, repo_prefix, repo_identifier, sep, identifier, comment_suffix, comment_id = $1, $2, $3, $4, $5, $10, $11, $8 || $12 || $18, $14 || $19, $15, $17
                   link = nil
                   if project_identifier
                     project = Project.visible.find_by_identifier(project_identifier)
                   end
                   if esc.nil?
                     if prefix.nil? && sep == 'r'
                       if project
                         repository = nil
                         if repo_identifier
                           repository = project.repositories.detect {|repo| repo.identifier == repo_identifier}
                         else
                           repository = project.repository
                         end
                         # project.changesets.visible raises an SQL error because of a double join on repositories
                         if repository && (changeset = Changeset.visible.find_by_repository_id_and_revision(repository.id, identifier))
                           link = link_to(h("#{project_prefix}#{repo_prefix}r#{identifier}"), {:only_path => only_path, :controller => 'repositories', :action => 'revision', :id => project, :repository_id => repository.identifier_param, :rev => changeset.revision},
                                                     :class => 'changeset',
                                                     :title => truncate_single_line(changeset.comments, :length => 100))
                         end
                       end
                     elsif sep == '#'
                       oid = identifier.to_i
                       case prefix
                       when nil
                         if oid.to_s == identifier && issue = Issue.visible.find_by_id(oid, :include => :status)
                           anchor = comment_id ? "note-#{comment_id}" : nil
                           link = link_to("##{oid}", {:only_path => only_path, :controller => 'issues', :action => 'show', :id => oid, :anchor => anchor},
                                                     :class => issue.css_classes,
                                                     :title => "#{truncate(issue.subject, :length => 100)} (#{issue.status.name})")
                         end
                       when 'document'
                         if document = Document.visible.find_by_id(oid)
                           link = link_to h(document.title), {:only_path => only_path, :controller => 'documents', :action => 'show', :id => document},
                                                             :class => 'document'
                         end
                       when 'version'
                         if version = Version.visible.find_by_id(oid)
                           link = link_to h(version.name), {:only_path => only_path, :controller => 'versions', :action => 'show', :id => version},
                                                           :class => 'version'
                         end
                       when 'message'
                         if message = Message.visible.find_by_id(oid, :include => :parent)
                           link = link_to_message(message, {:only_path => only_path}, :class => 'message')
                         end
                       when 'forum'
                         if board = Board.visible.find_by_id(oid)
                           link = link_to h(board.name), {:only_path => only_path, :controller => 'boards', :action => 'show', :id => board, :project_id => board.project},
                                                          :class => 'board'
                         end
                       when 'news'
                         if news = News.visible.find_by_id(oid)
                           link = link_to h(news.title), {:only_path => only_path, :controller => 'news', :action => 'show', :id => news},
                                                         :class => 'news'
                         end
                       when 'project'
                         if p = Project.visible.find_by_id(oid)
                           link = link_to_project(p, {:only_path => only_path}, :class => 'project')
                         end
                       end
                     elsif sep == ':'
                       # removes the double quotes if any
                       name = identifier.gsub(%r{^"(.*)"$}, "\\1")
                       case prefix
                       when 'document'
                         if project && document = project.documents.visible.find_by_title(name)
                           link = link_to h(document.title), {:only_path => only_path, :controller => 'documents', :action => 'show', :id => document},
                                                             :class => 'document'
                         end
                       when 'version'
                         if project && version = project.versions.visible.find_by_name(name)
                           link = link_to h(version.name), {:only_path => only_path, :controller => 'versions', :action => 'show', :id => version},
                                                           :class => 'version'
                         end
                       when 'forum'
                         if project && board = project.boards.visible.find_by_name(name)
                           link = link_to h(board.name), {:only_path => only_path, :controller => 'boards', :action => 'show', :id => board, :project_id => board.project},
                                                          :class => 'board'
                         end
                       when 'news'
                         if project && news = project.news.visible.find_by_title(name)
                           link = link_to h(news.title), {:only_path => only_path, :controller => 'news', :action => 'show', :id => news},
                                                         :class => 'news'
                         end
                       when 'commit', 'source', 'export'
                         if project
                           repository = nil
                           if name =~ %r{^(([a-z0-9\-]+)\|)(.+)$}
                             repo_prefix, repo_identifier, name = $1, $2, $3
                             repository = project.repositories.detect {|repo| repo.identifier == repo_identifier}
                           else
                             repository = project.repository
                           end
                           if prefix == 'commit'
                             if repository && (changeset = Changeset.visible.where("repository_id = ? AND scmid LIKE ?", repository.id, "#{name}%").first)
                               link = link_to h("#{project_prefix}#{repo_prefix}#{name}"), {:only_path => only_path, :controller => 'repositories', :action => 'revision', :id => project, :repository_id => repository.identifier_param, :rev => changeset.identifier},
                                                            :class => 'changeset',
                                                            :title => truncate_single_line(h(changeset.comments), :length => 100)
                             end
                           else
                             if repository && User.current.allowed_to?(:browse_repository, project)
                               name =~ %r{^[/\\]*(.*?)(@([^/\\@]+?))?(#(L\d+))?$}
                               path, rev, anchor = $1, $3, $5
                               link = link_to h("#{project_prefix}#{prefix}:#{repo_prefix}#{name}"), {:controller => 'repositories', :action => (prefix == 'export' ? 'raw' : 'entry'), :id => project, :repository_id => repository.identifier_param,
                                                                       :path => to_path_param(path),
                                                                       :rev => rev,
                                                                       :anchor => anchor},
                                                                      :class => (prefix == 'export' ? 'source download' : 'source')
                             end
                           end
                           repo_prefix = nil
                         end
                       when 'attachment'
                         attachments = options[:attachments] || (obj && obj.respond_to?(:attachments) ? obj.attachments : nil)
                         if attachments && attachment = attachments.detect {|a| a.filename == name }
-                          link = link_to h(attachment.filename), {:only_path => only_path, :controller => 'attachments', :action => 'download', :id => attachment},
+                          link = link_to_attachment(attachment, :only_path => only_path, :download => true, :class => 'attachment')
-                                                                 :class => 'attachment'
                         end
                       when 'project'
                         if p = Project.visible.where("identifier = :s OR LOWER(name) = :s", :s => name.downcase).first
                           link = link_to_project(p, {:only_path => only_path}, :class => 'project')
                         end
                       end
                     end
                   end
                   (leading + (link || "#{project_prefix}#{prefix}#{repo_prefix}#{sep}#{identifier}#{comment_suffix}"))
                 end
               end
               HEADING_RE = /(<h(\d)( [^>]+)?>(.+?)<\/h(\d)>)/i unless const_defined?(:HEADING_RE)
               def parse_sections(text, project, obj, attr, only_path, options)
                 return unless options[:edit_section_links]
                 text.gsub!(HEADING_RE) do
                   heading = $1
                   @current_section += 1
                   if @current_section > 1
                     content_tag('div',
                       link_to(image_tag('edit.png'), options[:edit_section_links].merge(:section => @current_section)),
                       :class => 'contextual',
                       :title => l(:button_edit_section)) + heading.html_safe
                   else
                     heading
                   end
                 end
               end
               # Headings and TOC
               # Adds ids and links to headings unless options[:headings] is set to false
               def parse_headings(text, project, obj, attr, only_path, options)
                 return if options[:headings] == false
                 text.gsub!(HEADING_RE) do
                   level, attrs, content = $2.to_i, $3, $4
                   item = strip_tags(content).strip
                   anchor = sanitize_anchor_name(item)
                   # used for single-file wiki export
                   anchor = "#{obj.page.title}_#{anchor}" if options[:wiki_links] == :anchor && (obj.is_a?(WikiContent) || obj.is_a?(WikiContent::Version))
                   @heading_anchors[anchor] ||= 0
                   idx = (@heading_anchors[anchor] += 1)
                   if idx > 1
                     anchor = "#{anchor}-#{idx}"
                   end
                   @parsed_headings << [level, anchor, item]
                   "<a name=\"#{anchor}\"></a>\n<h#{level} #{attrs}>#{content}<a href=\"##{anchor}\" class=\"wiki-anchor\">&para;</a></h#{level}>"
                 end
               end
               MACROS_RE = /(
                             (!)?                        # escaping
                             (
                             \{\{                        # opening tag
                             ([\w]+)                     # macro name
                             (\(([^\n\r]*?)\))?          # optional arguments
                             ([\n\r].*?[\n\r])?          # optional block of text
                             \}\}                        # closing tag
                             )
                            )/mx unless const_defined?(:MACROS_RE)
               MACRO_SUB_RE = /(
                               \{\{
                               macro\((\d+)\)
                               \}\}
                               )/x unless const_defined?(:MACRO_SUB_RE)
               # Extracts macros from text
               def catch_macros(text)
                 macros = {}
                 text.gsub!(MACROS_RE) do
                   all, macro = $1, $4.downcase
                   if macro_exists?(macro) || all =~ MACRO_SUB_RE
                     index = macros.size
                     macros[index] = all
                     "{{macro(#{index})}}"
                   else
                     all
                   end
                 end
                 macros
               end
               # Executes and replaces macros in text
               def inject_macros(text, obj, macros, execute=true)
                 text.gsub!(MACRO_SUB_RE) do
                   all, index = $1, $2.to_i
                   orig = macros.delete(index)
                   if execute && orig && orig =~ MACROS_RE
                     esc, all, macro, args, block = $2, $3, $4.downcase, $6.to_s, $7.try(:strip)
                     if esc.nil?
                       h(exec_macro(macro, obj, args, block) || all)
                     else
                       h(all)
                     end
                   elsif orig
                     h(orig)
                   else
                     h(all)
                   end
                 end
               end
               TOC_RE = /<p>\{\{([<>]?)toc\}\}<\/p>/i unless const_defined?(:TOC_RE)
               # Renders the TOC with given headings
               def replace_toc(text, headings)
                 text.gsub!(TOC_RE) do
                   # Keep only the 4 first levels
                   headings = headings.select{|level, anchor, item| level <= 4}
                   if headings.empty?
                     ''
                   else
                     div_class = 'toc'
                     div_class << ' right' if $1 == '>'
                     div_class << ' left' if $1 == '<'
                     out = "<ul class=\"#{div_class}\"><li>"
                     root = headings.map(&:first).min
                     current = root
                     started = false
                     headings.each do |level, anchor, item|
                       if level > current
                         out << '<ul><li>' * (level - current)
                       elsif level < current
                         out << "</li></ul>\n" * (current - level) + "</li><li>"
                       elsif started
                         out << '</li><li>'
                       end
                       out << "<a href=\"##{anchor}\">#{item}</a>"
                       current = level
                       started = true
                     end
                     out << '</li></ul>' * (current - root)
                     out << '</li></ul>'
                   end
                 end
               end
               # 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
                   html_safe
               end
               def lang_options_for_select(blank=true)
                 (blank ? [["(auto)", ""]] : []) + languages_options
               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_form_for(*args, &proc)
                 args << {} unless args.last.is_a?(Hash)
                 options = args.last
                 if args.first.is_a?(Symbol)
                   options.merge!(:as => args.shift)
                 end
                 options.merge!({:builder => Redmine::Views::LabelledFormBuilder})
                 form_for(*args, &proc)
               end
               def labelled_fields_for(*args, &proc)
                 args << {} unless args.last.is_a?(Hash)
                 options = args.last
                 options.merge!({:builder => Redmine::Views::LabelledFormBuilder})
                 fields_for(*args, &proc)
               end
               def labelled_remote_form_for(*args, &proc)
                 ActiveSupport::Deprecation.warn "ApplicationHelper#labelled_remote_form_for is deprecated and will be removed in Redmine 2.2."
                 args << {} unless args.last.is_a?(Hash)
                 options = args.last
                 options.merge!({:builder => Redmine::Views::LabelledFormBuilder, :remote => true})
                 form_for(*args, &proc)
               end
               def error_messages_for(*objects)
                 html = ""
                 objects = objects.map {|o| o.is_a?(String) ? instance_variable_get("@#{o}") : o}.compact
                 errors = objects.map {|o| o.errors.full_messages}.flatten
                 if errors.any?
                   html << "<div id='errorExplanation'><ul>\n"
                   errors.each do |error|
                     html << "<li>#{h error}</li>\n"
                   end
                   html << "</ul></div>\n"
                 end
                 html.html_safe
               end
               def delete_link(url, options={})
                 options = {
                   :method => :delete,
                   :data => {:confirm => l(:text_are_you_sure)},
                   :class => 'icon icon-del'
                 }.merge(options)
                 link_to l(:button_delete), url, options
               end
               def preview_link(url, form, target='preview', options={})
                 content_tag 'a', l(:label_preview), {
                     :href => "#",
                     :onclick => %|submitPreview("#{escape_javascript url_for(url)}", "#{escape_javascript form}", "#{escape_javascript target}"); return false;|,
                     :accesskey => accesskey(:preview)
                   }.merge(options)
               end
               def link_to_function(name, function, html_options={})
                 content_tag(:a, name, {:href => '#', :onclick => "#{function}; return false;"}.merge(html_options))
               end
               # Helper to render JSON in views
               def raw_json(arg)
                 arg.to_json.to_s.gsub('/', '\/').html_safe
               end
               def back_url
                 url = params[:back_url]
                 if url.nil? && referer = request.env['HTTP_REFERER']
                   url = CGI.unescape(referer.to_s)
                 end
                 url
               end
               def back_url_hidden_field_tag
                 url = back_url
                 hidden_field_tag('back_url', url, :id => nil) unless url.blank?
               end
               def check_all_links(form_name)
                 link_to_function(l(:button_check_all), "checkAll('#{form_name}', true)") +
                 " | ".html_safe +
                 link_to_function(l(:button_uncheck_all), "checkAll('#{form_name}', false)")
               end
               def progress_bar(pcts, options={})
                 pcts = [pcts, pcts] unless pcts.is_a?(Array)
                 pcts = pcts.collect(&:round)
                 pcts[1] = pcts[1] - pcts[0]
                 pcts << (100 - pcts[1] - pcts[0])
                 width = options[:width] || '100px;'
                 legend = options[:legend] || ''
                 content_tag('table',
                   content_tag('tr',
                     (pcts[0] > 0 ? content_tag('td', '', :style => "width: #{pcts[0]}%;", :class => 'closed') : ''.html_safe) +
                     (pcts[1] > 0 ? content_tag('td', '', :style => "width: #{pcts[1]}%;", :class => 'done') : ''.html_safe) +
                     (pcts[2] > 0 ? content_tag('td', '', :style => "width: #{pcts[2]}%;", :class => 'todo') : ''.html_safe)
                   ), :class => 'progress', :style => "width: #{width};").html_safe +
                   content_tag('p', legend, :class => 'percent').html_safe
               end
               def checked_image(checked=true)
                 if checked
                   image_tag 'toggle_check.png'
                 end
               end
               def context_menu(url)
                 unless @context_menu_included
                   content_for :header_tags do
                     javascript_include_tag('context_menu') +
                       stylesheet_link_tag('context_menu')
                   end
                   if l(:direction) == 'rtl'
                     content_for :header_tags do
                       stylesheet_link_tag('context_menu_rtl')
                     end
                   end
                   @context_menu_included = true
                 end
                 javascript_tag "contextMenuInit('#{ url_for(url) }')"
               end
               def calendar_for(field_id)
                 include_calendar_headers_tags
                 javascript_tag("$(function() { $('##{field_id}').datepicker(datepickerOptions); });")
               end
               def include_calendar_headers_tags
                 unless @calendar_headers_tags_included
                   @calendar_headers_tags_included = true
                   content_for :header_tags do
                     start_of_week = Setting.start_of_week
                     start_of_week = l(:general_first_day_of_week, :default => '1') if start_of_week.blank?
                     # Redmine uses 1..7 (monday..sunday) in settings and locales
                     # JQuery uses 0..6 (sunday..saturday), 7 needs to be changed to 0
                     start_of_week = start_of_week.to_i % 7
                     tags = javascript_tag(
                                "var datepickerOptions={dateFormat: 'yy-mm-dd', firstDay: #{start_of_week}, " +
                                  "showOn: 'button', buttonImageOnly: true, buttonImage: '" +
                                  path_to_image('/images/calendar.png') +
                                  "', showButtonPanel: true};")
                     jquery_locale = l('jquery.locale', :default => current_language.to_s)
                     unless jquery_locale == 'en'
                       tags << javascript_include_tag("i18n/jquery.ui.datepicker-#{jquery_locale}.js")
                     end
                     tags
                   end
                 end
               end
               # Overrides Rails' stylesheet_link_tag with themes and plugins support.
               # Examples:
               #   stylesheet_link_tag('styles') # => picks styles.css from the current theme or defaults
               #   stylesheet_link_tag('styles', :plugin => 'foo) # => picks styles.css from plugin's assets
               #
               def stylesheet_link_tag(*sources)
                 options = sources.last.is_a?(Hash) ? sources.pop : {}
                 plugin = options.delete(:plugin)
                 sources = sources.map do |source|
                   if plugin
                     "/plugin_assets/#{plugin}/stylesheets/#{source}"
                   elsif current_theme && current_theme.stylesheets.include?(source)
                     current_theme.stylesheet_path(source)
                   else
                     source
                   end
                 end
                 super sources, options
               end
               # Overrides Rails' image_tag with themes and plugins support.
               # Examples:
               #   image_tag('image.png') # => picks image.png from the current theme or defaults
               #   image_tag('image.png', :plugin => 'foo) # => picks image.png from plugin's assets
               #
               def image_tag(source, options={})
                 if plugin = options.delete(:plugin)
                   source = "/plugin_assets/#{plugin}/images/#{source}"
                 elsif current_theme && current_theme.images.include?(source)
                   source = current_theme.image_path(source)
                 end
                 super source, options
               end
               # Overrides Rails' javascript_include_tag with plugins support
               # Examples:
               #   javascript_include_tag('scripts') # => picks scripts.js from defaults
               #   javascript_include_tag('scripts', :plugin => 'foo) # => picks scripts.js from plugin's assets
               #
               def javascript_include_tag(*sources)
                 options = sources.last.is_a?(Hash) ? sources.pop : {}
                 if plugin = options.delete(:plugin)
                   sources = sources.map do |source|
                     if plugin
                       "/plugin_assets/#{plugin}/javascripts/#{source}"
                     else
                       source
                     end
                   end
                 end
                 super sources, options
               end
               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
               def sidebar_content?
                 has_content?(:sidebar) || view_layouts_base_sidebar_hook_response.present?
               end
               def view_layouts_base_sidebar_hook_response
                 @view_layouts_base_sidebar_hook_response ||= call_hook(:view_layouts_base_sidebar)
               end
               def email_delivery_enabled?
                 !!ActionMailer::Base.perform_deliveries
               end
               # Returns the avatar image tag for the given +user+ if avatars are enabled
               # +user+ can be a User or a string that will be scanned for an email address (eg. 'joe <joe@foo.bar>')
               def avatar(user, options = { })
                 if Setting.gravatar_enabled?
                   options.merge!({:ssl => (request && request.ssl?), :default => Setting.gravatar_default})
                   email = nil
                   if user.respond_to?(:mail)
                     email = user.mail
                   elsif user.to_s =~ %r{<(.+?)>}
                     email = $1
                   end
                   return gravatar(email.to_s.downcase, options) unless email.blank? rescue nil
                 else
                   ''
                 end
               end
               def sanitize_anchor_name(anchor)
                 if ''.respond_to?(:encoding) || RUBY_PLATFORM == 'java'
                   anchor.gsub(%r{[^\p{Word}\s\-]}, '').gsub(%r{\s+(\-+\s*)?}, '-')
                 else
                   # TODO: remove when ruby1.8 is no longer supported
                   anchor.gsub(%r{[^\w\s\-]}, '').gsub(%r{\s+(\-+\s*)?}, '-')
                 end
               end
               # Returns the javascript tags that are included in the html layout head
               def javascript_heads
                 tags = javascript_include_tag('jquery-1.8.3-ui-1.9.2-ujs-2.0.3', 'application')
                 unless User.current.pref.warn_on_leaving_unsaved == '0'
                   tags << "\n".html_safe + javascript_tag("$(window).load(function(){ warnLeavingUnsaved('#{escape_javascript l(:text_warn_on_leaving_unsaved)}'); });")
                 end
                 tags
               end
               def favicon
                 "<link rel='shortcut icon' href='#{image_path('/favicon.ico')}' />".html_safe
               end
               def robot_exclusion_tag
                 '<meta name="robots" content="noindex,follow,noarchive" />'.html_safe
               end
               # Returns true if arg is expected in the API response
               def include_in_api_response?(arg)
                 unless @included_in_api_response
                   param = params[:include]
                   @included_in_api_response = param.is_a?(Array) ? param.collect(&:to_s) : param.to_s.split(',')
                   @included_in_api_response.collect!(&:strip)
                 end
                 @included_in_api_response.include?(arg.to_s)
               end
               # Returns options or nil if nometa param or X-Redmine-Nometa header
               # was set in the request
               def api_meta(options)
                 if params[:nometa].present? || request.headers['X-Redmine-Nometa']
                   # compatibility mode for activeresource clients that raise
                   # an error when unserializing an array with attributes
                   nil
                 else
                   options
                 end
               end
               private
               def wiki_helper
                 helper = Redmine::WikiFormatting.helper_for(Setting.text_formatting)
                 extend helper
                 return self
               end
               def link_to_content_update(text, url_params = {}, html_options = {})
                 link_to(text, url_params, html_options)
               end
             end