jro_apps/redmine Commit - r12755:a8d3f491e681

1

# Redmine - project management software

1

# Redmine - project management software

2

3

#

3

#

4

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

4

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

5

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

5

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

6

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

6

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

7

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

7

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

8

#

8

#

9

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

9

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

10

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

10

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

11

# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the

11

# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the

12

# GNU General Public License for more details.

12

# GNU General Public License for more details.

13

#

13

#

14

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

14

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

15

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

15

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

16

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

16

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

17

18

class Mailer < ActionMailer::Base

18

class Mailer < ActionMailer::Base

19

layout 'mailer'

19

layout 'mailer'

20

helper :application

20

helper :application

21

helper :issues

21

helper :issues

22

helper :custom_fields

22

helper :custom_fields

23

24

include Redmine::I18n

24

include Redmine::I18n

25

26

def self.default_url_options

26

def self.default_url_options

27

{ :host => Setting.host_name, :protocol => Setting.protocol }

27

{ :host => Setting.host_name, :protocol => Setting.protocol }

28

end

28

end

29

30

# Builds a mail for notifying to_users and cc_users about a new issue

30

# Builds a mail for notifying to_users and cc_users about a new issue

31

def issue_add(issue, to_users, cc_users)

31

def issue_add(issue, to_users, cc_users)

32

redmine_headers 'Project' => issue.project.identifier,

32

redmine_headers 'Project' => issue.project.identifier,

33

'Issue-Id' => issue.id,

33

'Issue-Id' => issue.id,

34

'Issue-Author' => issue.author.login

34

'Issue-Author' => issue.author.login

35

redmine_headers 'Issue-Assignee' => issue.assigned_to.login if issue.assigned_to

35

redmine_headers 'Issue-Assignee' => issue.assigned_to.login if issue.assigned_to

36

message_id issue

36

message_id issue

37

references issue

37

references issue

38

@author = issue.author

38

@author = issue.author

39

@issue = issue

39

@issue = issue

40

@users = to_users + cc_users

40

@users = to_users + cc_users

41

@issue_url = url_for(:controller => 'issues', :action => 'show', :id => issue)

41

@issue_url = url_for(:controller => 'issues', :action => 'show', :id => issue)

42

mail :to => to_users.map(&:mail),

42

mail :to => to_users.map(&:mail),

43

:cc => cc_users.map(&:mail),

43

:cc => cc_users.map(&:mail),

44

:subject => "[#{issue.project.name} - #{issue.tracker.name} ##{issue.id}] (#{issue.status.name}) #{issue.subject}"

44

:subject => "[#{issue.project.name} - #{issue.tracker.name} ##{issue.id}] (#{issue.status.name}) #{issue.subject}"

45

end

45

end

46

47

# Notifies users about a new issue

47

# Notifies users about a new issue

48

def self.deliver_issue_add(issue)

48

def self.deliver_issue_add(issue)

49

to = issue.notified_users

49

to = issue.notified_users

50

cc = issue.notified_watchers - to

50

cc = issue.notified_watchers - to

51

issue.each_notification(to + cc) do |users|

51

issue.each_notification(to + cc) do |users|

52

Mailer.issue_add(issue, to & users, cc & users).deliver

52

Mailer.issue_add(issue, to & users, cc & users).deliver

53

end

53

end

54

end

54

end

55

56

# Builds a mail for notifying to_users and cc_users about an issue update

56

# Builds a mail for notifying to_users and cc_users about an issue update

57

def issue_edit(journal, to_users, cc_users)

57

def issue_edit(journal, to_users, cc_users)

58

issue = journal.journalized

58

issue = journal.journalized

59

redmine_headers 'Project' => issue.project.identifier,

59

redmine_headers 'Project' => issue.project.identifier,

60

'Issue-Id' => issue.id,

60

'Issue-Id' => issue.id,

61

'Issue-Author' => issue.author.login

61

'Issue-Author' => issue.author.login

62

redmine_headers 'Issue-Assignee' => issue.assigned_to.login if issue.assigned_to

62

redmine_headers 'Issue-Assignee' => issue.assigned_to.login if issue.assigned_to

63

message_id journal

63

message_id journal

64

references issue

64

references issue

65

@author = journal.user

65

@author = journal.user

66

s = "[#{issue.project.name} - #{issue.tracker.name} ##{issue.id}] "

66

s = "[#{issue.project.name} - #{issue.tracker.name} ##{issue.id}] "

67

s << "(#{issue.status.name}) " if journal.new_value_for('status_id')

67

s << "(#{issue.status.name}) " if journal.new_value_for('status_id')

68

s << issue.subject

68

s << issue.subject

69

@issue = issue

69

@issue = issue

70

@users = to_users + cc_users

70

@users = to_users + cc_users

71

@journal = journal

71

@journal = journal

72

@journal_details = journal.visible_details(@users.first)

72

@journal_details = journal.visible_details(@users.first)

73

@issue_url = url_for(:controller => 'issues', :action => 'show', :id => issue, :anchor => "change-#{journal.id}")

73

@issue_url = url_for(:controller => 'issues', :action => 'show', :id => issue, :anchor => "change-#{journal.id}")

74

mail :to => to_users.map(&:mail),

74

mail :to => to_users.map(&:mail),

75

:cc => cc_users.map(&:mail),

75

:cc => cc_users.map(&:mail),

76

:subject => s

76

:subject => s

77

end

77

end

78

79

# Notifies users about an issue update

79

# Notifies users about an issue update

80

def self.deliver_issue_edit(journal)

80

def self.deliver_issue_edit(journal)

81

issue = journal.journalized.reload

81

issue = journal.journalized.reload

82

to = journal.notified_users

82

to = journal.notified_users

83

cc = journal.notified_watchers

83

cc = journal.notified_watchers - to

84

journal.each_notification(to + cc) do |users|

84

journal.each_notification(to + cc) do |users|

85

issue.each_notification(users) do |users2|

85

issue.each_notification(users) do |users2|

86

Mailer.issue_edit(journal, to & users2, cc & users2).deliver

86

Mailer.issue_edit(journal, to & users2, cc & users2).deliver

87

end

87

end

88

end

88

end

89

end

89

end

90

91

def reminder(user, issues, days)

91

def reminder(user, issues, days)

92

set_language_if_valid user.language

92

set_language_if_valid user.language

93

@issues = issues

93

@issues = issues

94

@days = days

94

@days = days

95

@issues_url = url_for(:controller => 'issues', :action => 'index',

95

@issues_url = url_for(:controller => 'issues', :action => 'index',

96

:set_filter => 1, :assigned_to_id => user.id,

96

:set_filter => 1, :assigned_to_id => user.id,

97

:sort => 'due_date:asc')

97

:sort => 'due_date:asc')

98

mail :to => user.mail,

98

mail :to => user.mail,

99

:subject => l(:mail_subject_reminder, :count => issues.size, :days => days)

99

:subject => l(:mail_subject_reminder, :count => issues.size, :days => days)

100

end

100

end

101

102

# Builds a Mail::Message object used to email users belonging to the added document's project.

102

# Builds a Mail::Message object used to email users belonging to the added document's project.

103

#

103

#

104

# Example:

104

# Example:

105

# document_added(document) => Mail::Message object

105

# document_added(document) => Mail::Message object

106

# Mailer.document_added(document).deliver => sends an email to the document's project recipients

106

# Mailer.document_added(document).deliver => sends an email to the document's project recipients

107

def document_added(document)

107

def document_added(document)

108

redmine_headers 'Project' => document.project.identifier

108

redmine_headers 'Project' => document.project.identifier

109

@author = User.current

109

@author = User.current

110

@document = document

110

@document = document

111

@document_url = url_for(:controller => 'documents', :action => 'show', :id => document)

111

@document_url = url_for(:controller => 'documents', :action => 'show', :id => document)

112

mail :to => document.recipients,

112

mail :to => document.recipients,

113

:subject => "[#{document.project.name}] #{l(:label_document_new)}: #{document.title}"

113

:subject => "[#{document.project.name}] #{l(:label_document_new)}: #{document.title}"

114

end

114

end

115

116

# Builds a Mail::Message object used to email recipients of a project when an attachements are added.

116

# Builds a Mail::Message object used to email recipients of a project when an attachements are added.

117

#

117

#

118

# Example:

118

# Example:

119

# attachments_added(attachments) => Mail::Message object

119

# attachments_added(attachments) => Mail::Message object

120

# Mailer.attachments_added(attachments).deliver => sends an email to the project's recipients

120

# Mailer.attachments_added(attachments).deliver => sends an email to the project's recipients

121

def attachments_added(attachments)

121

def attachments_added(attachments)

122

container = attachments.first.container

122

container = attachments.first.container

123

added_to = ''

123

added_to = ''

124

added_to_url = ''

124

added_to_url = ''

125

@author = attachments.first.author

125

@author = attachments.first.author

126

case container.class.name

126

case container.class.name

127

when 'Project'

127

when 'Project'

128

added_to_url = url_for(:controller => 'files', :action => 'index', :project_id => container)

128

added_to_url = url_for(:controller => 'files', :action => 'index', :project_id => container)

129

added_to = "#{l(:label_project)}: #{container}"

129

added_to = "#{l(:label_project)}: #{container}"

130

recipients = container.project.notified_users.select {|user| user.allowed_to?(:view_files, container.project)}.collect {|u| u.mail}

130

recipients = container.project.notified_users.select {|user| user.allowed_to?(:view_files, container.project)}.collect {|u| u.mail}

131

when 'Version'

131

when 'Version'

132

added_to_url = url_for(:controller => 'files', :action => 'index', :project_id => container.project)

132

added_to_url = url_for(:controller => 'files', :action => 'index', :project_id => container.project)

133

added_to = "#{l(:label_version)}: #{container.name}"

133

added_to = "#{l(:label_version)}: #{container.name}"

134

recipients = container.project.notified_users.select {|user| user.allowed_to?(:view_files, container.project)}.collect {|u| u.mail}

134

recipients = container.project.notified_users.select {|user| user.allowed_to?(:view_files, container.project)}.collect {|u| u.mail}

135

when 'Document'

135

when 'Document'

136

added_to_url = url_for(:controller => 'documents', :action => 'show', :id => container.id)

136

added_to_url = url_for(:controller => 'documents', :action => 'show', :id => container.id)

137

added_to = "#{l(:label_document)}: #{container.title}"

137

added_to = "#{l(:label_document)}: #{container.title}"

138

recipients = container.recipients

138

recipients = container.recipients

139

end

139

end

140

redmine_headers 'Project' => container.project.identifier

140

redmine_headers 'Project' => container.project.identifier

141

@attachments = attachments

141

@attachments = attachments

142

@added_to = added_to

142

@added_to = added_to

143

@added_to_url = added_to_url

143

@added_to_url = added_to_url

144

mail :to => recipients,

144

mail :to => recipients,

145

:subject => "[#{container.project.name}] #{l(:label_attachment_new)}"

145

:subject => "[#{container.project.name}] #{l(:label_attachment_new)}"

146

end

146

end

147

148

# Builds a Mail::Message object used to email recipients of a news' project when a news item is added.

148

# Builds a Mail::Message object used to email recipients of a news' project when a news item is added.

149

#

149

#

150

# Example:

150

# Example:

151

# news_added(news) => Mail::Message object

151

# news_added(news) => Mail::Message object

152

# Mailer.news_added(news).deliver => sends an email to the news' project recipients

152

# Mailer.news_added(news).deliver => sends an email to the news' project recipients

153

def news_added(news)

153

def news_added(news)

154

redmine_headers 'Project' => news.project.identifier

154

redmine_headers 'Project' => news.project.identifier

155

@author = news.author

155

@author = news.author

156

message_id news

156

message_id news

157

references news

157

references news

158

@news = news

158

@news = news

159

@news_url = url_for(:controller => 'news', :action => 'show', :id => news)

159

@news_url = url_for(:controller => 'news', :action => 'show', :id => news)

160

mail :to => news.recipients,

160

mail :to => news.recipients,

161

:cc => news.cc_for_added_news,

161

:cc => news.cc_for_added_news,

162

:subject => "[#{news.project.name}] #{l(:label_news)}: #{news.title}"

162

:subject => "[#{news.project.name}] #{l(:label_news)}: #{news.title}"

163

end

163

end

164

165

# Builds a Mail::Message object used to email recipients of a news' project when a news comment is added.

165

# Builds a Mail::Message object used to email recipients of a news' project when a news comment is added.

166

#

166

#

167

# Example:

167

# Example:

168

# news_comment_added(comment) => Mail::Message object

168

# news_comment_added(comment) => Mail::Message object

169

# Mailer.news_comment_added(comment) => sends an email to the news' project recipients

169

# Mailer.news_comment_added(comment) => sends an email to the news' project recipients

170

def news_comment_added(comment)

170

def news_comment_added(comment)

171

news = comment.commented

171

news = comment.commented

172

redmine_headers 'Project' => news.project.identifier

172

redmine_headers 'Project' => news.project.identifier

173

@author = comment.author

173

@author = comment.author

174

message_id comment

174

message_id comment

175

references news

175

references news

176

@news = news

176

@news = news

177

@comment = comment

177

@comment = comment

178

@news_url = url_for(:controller => 'news', :action => 'show', :id => news)

178

@news_url = url_for(:controller => 'news', :action => 'show', :id => news)

179

mail :to => news.recipients,

179

mail :to => news.recipients,

180

:cc => news.watcher_recipients,

180

:cc => news.watcher_recipients,

181

:subject => "Re: [#{news.project.name}] #{l(:label_news)}: #{news.title}"

181

:subject => "Re: [#{news.project.name}] #{l(:label_news)}: #{news.title}"

182

end

182

end

183

184

# Builds a Mail::Message object used to email the recipients of the specified message that was posted.

184

# Builds a Mail::Message object used to email the recipients of the specified message that was posted.

185

#

185

#

186

# Example:

186

# Example:

187

# message_posted(message) => Mail::Message object

187

# message_posted(message) => Mail::Message object

188

# Mailer.message_posted(message).deliver => sends an email to the recipients

188

# Mailer.message_posted(message).deliver => sends an email to the recipients

189

def message_posted(message)

189

def message_posted(message)

190

redmine_headers 'Project' => message.project.identifier,

190

redmine_headers 'Project' => message.project.identifier,

191

'Topic-Id' => (message.parent_id || message.id)

191

'Topic-Id' => (message.parent_id || message.id)

192

@author = message.author

192

@author = message.author

193

message_id message

193

message_id message

194

references message.root

194

references message.root

195

recipients = message.recipients

195

recipients = message.recipients

196

cc = ((message.root.watcher_recipients + message.board.watcher_recipients).uniq - recipients)

196

cc = ((message.root.watcher_recipients + message.board.watcher_recipients).uniq - recipients)

197

@message = message

197

@message = message

198

@message_url = url_for(message.event_url)

198

@message_url = url_for(message.event_url)

199

mail :to => recipients,

199

mail :to => recipients,

200

:cc => cc,

200

:cc => cc,

201

:subject => "[#{message.board.project.name} - #{message.board.name} - msg#{message.root.id}] #{message.subject}"

201

:subject => "[#{message.board.project.name} - #{message.board.name} - msg#{message.root.id}] #{message.subject}"

202

end

202

end

203

204

# Builds a Mail::Message object used to email the recipients of a project of the specified wiki content was added.

204

# Builds a Mail::Message object used to email the recipients of a project of the specified wiki content was added.

205

#

205

#

206

# Example:

206

# Example:

207

# wiki_content_added(wiki_content) => Mail::Message object

207

# wiki_content_added(wiki_content) => Mail::Message object

208

# Mailer.wiki_content_added(wiki_content).deliver => sends an email to the project's recipients

208

# Mailer.wiki_content_added(wiki_content).deliver => sends an email to the project's recipients

209

def wiki_content_added(wiki_content)

209

def wiki_content_added(wiki_content)

210

redmine_headers 'Project' => wiki_content.project.identifier,

210

redmine_headers 'Project' => wiki_content.project.identifier,

211

'Wiki-Page-Id' => wiki_content.page.id

211

'Wiki-Page-Id' => wiki_content.page.id

212

@author = wiki_content.author

212

@author = wiki_content.author

213

message_id wiki_content

213

message_id wiki_content

214

recipients = wiki_content.recipients

214

recipients = wiki_content.recipients

215

cc = wiki_content.page.wiki.watcher_recipients - recipients

215

cc = wiki_content.page.wiki.watcher_recipients - recipients

216

@wiki_content = wiki_content

216

@wiki_content = wiki_content

217

@wiki_content_url = url_for(:controller => 'wiki', :action => 'show',

217

@wiki_content_url = url_for(:controller => 'wiki', :action => 'show',

218

:project_id => wiki_content.project,

218

:project_id => wiki_content.project,

219

:id => wiki_content.page.title)

219

:id => wiki_content.page.title)

220

mail :to => recipients,

220

mail :to => recipients,

221

:cc => cc,

221

:cc => cc,

222

:subject => "[#{wiki_content.project.name}] #{l(:mail_subject_wiki_content_added, :id => wiki_content.page.pretty_title)}"

222

:subject => "[#{wiki_content.project.name}] #{l(:mail_subject_wiki_content_added, :id => wiki_content.page.pretty_title)}"

223

end

223

end

224

225

# Builds a Mail::Message object used to email the recipients of a project of the specified wiki content was updated.

225

# Builds a Mail::Message object used to email the recipients of a project of the specified wiki content was updated.

226

#

226

#

227

# Example:

227

# Example:

228

# wiki_content_updated(wiki_content) => Mail::Message object

228

# wiki_content_updated(wiki_content) => Mail::Message object

229

# Mailer.wiki_content_updated(wiki_content).deliver => sends an email to the project's recipients

229

# Mailer.wiki_content_updated(wiki_content).deliver => sends an email to the project's recipients

230

def wiki_content_updated(wiki_content)

230

def wiki_content_updated(wiki_content)

231

redmine_headers 'Project' => wiki_content.project.identifier,

231

redmine_headers 'Project' => wiki_content.project.identifier,

232

'Wiki-Page-Id' => wiki_content.page.id

232

'Wiki-Page-Id' => wiki_content.page.id

233

@author = wiki_content.author

233

@author = wiki_content.author

234

message_id wiki_content

234

message_id wiki_content

235

recipients = wiki_content.recipients

235

recipients = wiki_content.recipients

236

cc = wiki_content.page.wiki.watcher_recipients + wiki_content.page.watcher_recipients - recipients

236

cc = wiki_content.page.wiki.watcher_recipients + wiki_content.page.watcher_recipients - recipients

237

@wiki_content = wiki_content

237

@wiki_content = wiki_content

238

@wiki_content_url = url_for(:controller => 'wiki', :action => 'show',

238

@wiki_content_url = url_for(:controller => 'wiki', :action => 'show',

239

:project_id => wiki_content.project,

239

:project_id => wiki_content.project,

240

:id => wiki_content.page.title)

240

:id => wiki_content.page.title)

241

@wiki_diff_url = url_for(:controller => 'wiki', :action => 'diff',

241

@wiki_diff_url = url_for(:controller => 'wiki', :action => 'diff',

242

:project_id => wiki_content.project, :id => wiki_content.page.title,

242

:project_id => wiki_content.project, :id => wiki_content.page.title,

243

:version => wiki_content.version)

243

:version => wiki_content.version)

244

mail :to => recipients,

244

mail :to => recipients,

245

:cc => cc,

245

:cc => cc,

246

:subject => "[#{wiki_content.project.name}] #{l(:mail_subject_wiki_content_updated, :id => wiki_content.page.pretty_title)}"

246

:subject => "[#{wiki_content.project.name}] #{l(:mail_subject_wiki_content_updated, :id => wiki_content.page.pretty_title)}"

247

end

247

end

248

249

# Builds a Mail::Message object used to email the specified user their account information.

249

# Builds a Mail::Message object used to email the specified user their account information.

250

#

250

#

251

# Example:

251

# Example:

252

# account_information(user, password) => Mail::Message object

252

# account_information(user, password) => Mail::Message object

253

# Mailer.account_information(user, password).deliver => sends account information to the user

253

# Mailer.account_information(user, password).deliver => sends account information to the user

254

def account_information(user, password)

254

def account_information(user, password)

255

set_language_if_valid user.language

255

set_language_if_valid user.language

256

@user = user

256

@user = user

257

@password = password

257

@password = password

258

@login_url = url_for(:controller => 'account', :action => 'login')

258

@login_url = url_for(:controller => 'account', :action => 'login')

259

mail :to => user.mail,

259

mail :to => user.mail,

260

:subject => l(:mail_subject_register, Setting.app_title)

260

:subject => l(:mail_subject_register, Setting.app_title)

261

end

261

end

262

263

# Builds a Mail::Message object used to email all active administrators of an account activation request.

263

# Builds a Mail::Message object used to email all active administrators of an account activation request.

264

#

264

#

265

# Example:

265

# Example:

266

# account_activation_request(user) => Mail::Message object

266

# account_activation_request(user) => Mail::Message object

267

# Mailer.account_activation_request(user).deliver => sends an email to all active administrators

267

# Mailer.account_activation_request(user).deliver => sends an email to all active administrators

268

def account_activation_request(user)

268

def account_activation_request(user)

269

# Send the email to all active administrators

269

# Send the email to all active administrators

270

recipients = User.active.where(:admin => true).collect { |u| u.mail }.compact

270

recipients = User.active.where(:admin => true).collect { |u| u.mail }.compact

271

@user = user

271

@user = user

272

@url = url_for(:controller => 'users', :action => 'index',

272

@url = url_for(:controller => 'users', :action => 'index',

273

:status => User::STATUS_REGISTERED,

273

:status => User::STATUS_REGISTERED,

274

:sort_key => 'created_on', :sort_order => 'desc')

274

:sort_key => 'created_on', :sort_order => 'desc')

275

mail :to => recipients,

275

mail :to => recipients,

276

:subject => l(:mail_subject_account_activation_request, Setting.app_title)

276

:subject => l(:mail_subject_account_activation_request, Setting.app_title)

277

end

277

end

278

279

# Builds a Mail::Message object used to email the specified user that their account was activated by an administrator.

279

# Builds a Mail::Message object used to email the specified user that their account was activated by an administrator.

280

#

280

#

281

# Example:

281

# Example:

282

# account_activated(user) => Mail::Message object

282

# account_activated(user) => Mail::Message object

283

# Mailer.account_activated(user).deliver => sends an email to the registered user

283

# Mailer.account_activated(user).deliver => sends an email to the registered user

284

def account_activated(user)

284

def account_activated(user)

285

set_language_if_valid user.language

285

set_language_if_valid user.language

286

@user = user

286

@user = user

287

@login_url = url_for(:controller => 'account', :action => 'login')

287

@login_url = url_for(:controller => 'account', :action => 'login')

288

mail :to => user.mail,

288

mail :to => user.mail,

289

:subject => l(:mail_subject_register, Setting.app_title)

289

:subject => l(:mail_subject_register, Setting.app_title)

290

end

290

end

291

292

def lost_password(token)

292

def lost_password(token)

293

set_language_if_valid(token.user.language)

293

set_language_if_valid(token.user.language)

294

@token = token

294

@token = token

295

@url = url_for(:controller => 'account', :action => 'lost_password', :token => token.value)

295

@url = url_for(:controller => 'account', :action => 'lost_password', :token => token.value)

296

mail :to => token.user.mail,

296

mail :to => token.user.mail,

297

:subject => l(:mail_subject_lost_password, Setting.app_title)

297

:subject => l(:mail_subject_lost_password, Setting.app_title)

298

end

298

end

299

300

def register(token)

300

def register(token)

301

set_language_if_valid(token.user.language)

301

set_language_if_valid(token.user.language)

302

@token = token

302

@token = token

303

@url = url_for(:controller => 'account', :action => 'activate', :token => token.value)

303

@url = url_for(:controller => 'account', :action => 'activate', :token => token.value)

304

mail :to => token.user.mail,

304

mail :to => token.user.mail,

305

:subject => l(:mail_subject_register, Setting.app_title)

305

:subject => l(:mail_subject_register, Setting.app_title)

306

end

306

end

307

308

def test_email(user)

308

def test_email(user)

309

set_language_if_valid(user.language)

309

set_language_if_valid(user.language)

310

@url = url_for(:controller => 'welcome')

310

@url = url_for(:controller => 'welcome')

311

mail :to => user.mail,

311

mail :to => user.mail,

312

:subject => 'Redmine test'

312

:subject => 'Redmine test'

313

end

313

end

314

315

# Sends reminders to issue assignees

315

# Sends reminders to issue assignees

316

# Available options:

316

# Available options:

317

# * :days => how many days in the future to remind about (defaults to 7)

317

# * :days => how many days in the future to remind about (defaults to 7)

318

# * :tracker => id of tracker for filtering issues (defaults to all trackers)

318

# * :tracker => id of tracker for filtering issues (defaults to all trackers)

319

# * :project => id or identifier of project to process (defaults to all projects)

319

# * :project => id or identifier of project to process (defaults to all projects)

320

# * :users => array of user/group ids who should be reminded

320

# * :users => array of user/group ids who should be reminded

321

def self.reminders(options={})

321

def self.reminders(options={})

322

days = options[:days] || 7

322

days = options[:days] || 7

323

project = options[:project] ? Project.find(options[:project]) : nil

323

project = options[:project] ? Project.find(options[:project]) : nil

324

tracker = options[:tracker] ? Tracker.find(options[:tracker]) : nil

324

tracker = options[:tracker] ? Tracker.find(options[:tracker]) : nil

325

user_ids = options[:users]

325

user_ids = options[:users]

326

327

scope = Issue.open.where("#{Issue.table_name}.assigned_to_id IS NOT NULL" +

327

scope = Issue.open.where("#{Issue.table_name}.assigned_to_id IS NOT NULL" +

328

" AND #{Project.table_name}.status = #{Project::STATUS_ACTIVE}" +

328

" AND #{Project.table_name}.status = #{Project::STATUS_ACTIVE}" +

329

" AND #{Issue.table_name}.due_date <= ?", days.day.from_now.to_date

329

" AND #{Issue.table_name}.due_date <= ?", days.day.from_now.to_date

330

)

330

)

331

scope = scope.where(:assigned_to_id => user_ids) if user_ids.present?

331

scope = scope.where(:assigned_to_id => user_ids) if user_ids.present?

332

scope = scope.where(:project_id => project.id) if project

332

scope = scope.where(:project_id => project.id) if project

333

scope = scope.where(:tracker_id => tracker.id) if tracker

333

scope = scope.where(:tracker_id => tracker.id) if tracker

334

issues_by_assignee = scope.includes(:status, :assigned_to, :project, :tracker).

334

issues_by_assignee = scope.includes(:status, :assigned_to, :project, :tracker).

335

group_by(&:assigned_to)

335

group_by(&:assigned_to)

336

issues_by_assignee.keys.each do |assignee|

336

issues_by_assignee.keys.each do |assignee|

337

if assignee.is_a?(Group)

337

if assignee.is_a?(Group)

338

assignee.users.each do |user|

338

assignee.users.each do |user|

339

issues_by_assignee[user] ||= []

339

issues_by_assignee[user] ||= []

340

issues_by_assignee[user] += issues_by_assignee[assignee]

340

issues_by_assignee[user] += issues_by_assignee[assignee]

341

end

341

end

342

end

342

end

343

end

343

end

344

345

issues_by_assignee.each do |assignee, issues|

345

issues_by_assignee.each do |assignee, issues|

346

reminder(assignee, issues, days).deliver if assignee.is_a?(User) && assignee.active?

346

reminder(assignee, issues, days).deliver if assignee.is_a?(User) && assignee.active?

347

end

347

end

348

end

348

end

349

350

# Activates/desactivates email deliveries during +block+

350

# Activates/desactivates email deliveries during +block+

351

def self.with_deliveries(enabled = true, &block)

351

def self.with_deliveries(enabled = true, &block)

352

was_enabled = ActionMailer::Base.perform_deliveries

352

was_enabled = ActionMailer::Base.perform_deliveries

353

ActionMailer::Base.perform_deliveries = !!enabled

353

ActionMailer::Base.perform_deliveries = !!enabled

354

yield

354

yield

355

ensure

355

ensure

356

ActionMailer::Base.perform_deliveries = was_enabled

356

ActionMailer::Base.perform_deliveries = was_enabled

357

end

357

end

358

359

# Sends emails synchronously in the given block

359

# Sends emails synchronously in the given block

360

def self.with_synched_deliveries(&block)

360

def self.with_synched_deliveries(&block)

361

saved_method = ActionMailer::Base.delivery_method

361

saved_method = ActionMailer::Base.delivery_method

362

if m = saved_method.to_s.match(%r{^async_(.+)$})

362

if m = saved_method.to_s.match(%r{^async_(.+)$})

363

synched_method = m[1]

363

synched_method = m[1]

364

ActionMailer::Base.delivery_method = synched_method.to_sym

364

ActionMailer::Base.delivery_method = synched_method.to_sym

365

ActionMailer::Base.send "#{synched_method}_settings=", ActionMailer::Base.send("async_#{synched_method}_settings")

365

ActionMailer::Base.send "#{synched_method}_settings=", ActionMailer::Base.send("async_#{synched_method}_settings")

366

end

366

end

367

yield

367

yield

368

ensure

368

ensure

369

ActionMailer::Base.delivery_method = saved_method

369

ActionMailer::Base.delivery_method = saved_method

370

end

370

end

371

372

def mail(headers={}, &block)

372

def mail(headers={}, &block)

373

headers.merge! 'X-Mailer' => 'Redmine',

373

headers.merge! 'X-Mailer' => 'Redmine',

374

'X-Redmine-Host' => Setting.host_name,

374

'X-Redmine-Host' => Setting.host_name,

375

'X-Redmine-Site' => Setting.app_title,

375

'X-Redmine-Site' => Setting.app_title,

376

'X-Auto-Response-Suppress' => 'OOF',

376

'X-Auto-Response-Suppress' => 'OOF',

377

'Auto-Submitted' => 'auto-generated',

377

'Auto-Submitted' => 'auto-generated',

378

'From' => Setting.mail_from,

378

'From' => Setting.mail_from,

379

'List-Id' => "<#{Setting.mail_from.to_s.gsub('@', '.')}>"

379

'List-Id' => "<#{Setting.mail_from.to_s.gsub('@', '.')}>"

380

381

# Removes the author from the recipients and cc

381

# Removes the author from the recipients and cc

382

# if the author does not want to receive notifications

382

# if the author does not want to receive notifications

383

# about what the author do

383

# about what the author do

384

if @author && @author.logged? && @author.pref.no_self_notified

384

if @author && @author.logged? && @author.pref.no_self_notified

385

headers[:to].delete(@author.mail) if headers[:to].is_a?(Array)

385

headers[:to].delete(@author.mail) if headers[:to].is_a?(Array)

386

headers[:cc].delete(@author.mail) if headers[:cc].is_a?(Array)

386

headers[:cc].delete(@author.mail) if headers[:cc].is_a?(Array)

387

end

387

end

388

389

if @author && @author.logged?

389

if @author && @author.logged?

390

redmine_headers 'Sender' => @author.login

390

redmine_headers 'Sender' => @author.login

391

end

391

end

392

393

# Blind carbon copy recipients

393

# Blind carbon copy recipients

394

if Setting.bcc_recipients?

394

if Setting.bcc_recipients?

395

headers[:bcc] = [headers[:to], headers[:cc]].flatten.uniq.reject(&:blank?)

395

headers[:bcc] = [headers[:to], headers[:cc]].flatten.uniq.reject(&:blank?)

396

headers[:to] = nil

396

headers[:to] = nil

397

headers[:cc] = nil

397

headers[:cc] = nil

398

end

398

end

399

400

if @message_id_object

400

if @message_id_object

401

headers[:message_id] = "<#{self.class.message_id_for(@message_id_object)}>"

401

headers[:message_id] = "<#{self.class.message_id_for(@message_id_object)}>"

402

end

402

end

403

if @references_objects

403

if @references_objects

404

headers[:references] = @references_objects.collect {|o| "<#{self.class.references_for(o)}>"}.join(' ')

404

headers[:references] = @references_objects.collect {|o| "<#{self.class.references_for(o)}>"}.join(' ')

405

end

405

end

406

407

m = if block_given?

407

m = if block_given?

408

super headers, &block

408

super headers, &block

409

else

409

else

410

super headers do |format|

410

super headers do |format|

411

format.text

411

format.text

412

format.html unless Setting.plain_text_mail?

412

format.html unless Setting.plain_text_mail?

413

end

413

end

414

end

414

end

415

set_language_if_valid @initial_language

415

set_language_if_valid @initial_language

416

417

m

417

m

418

end

418

end

419

420

def initialize(*args)

420

def initialize(*args)

421

@initial_language = current_language

421

@initial_language = current_language

422

set_language_if_valid Setting.default_language

422

set_language_if_valid Setting.default_language

423

super

423

super

424

end

424

end

425

426

def self.deliver_mail(mail)

426

def self.deliver_mail(mail)

427

return false if mail.to.blank? && mail.cc.blank? && mail.bcc.blank?

427

return false if mail.to.blank? && mail.cc.blank? && mail.bcc.blank?

428

begin

428

begin

429

# Log errors when raise_delivery_errors is set to false, Rails does not

429

# Log errors when raise_delivery_errors is set to false, Rails does not

430

mail.raise_delivery_errors = true

430

mail.raise_delivery_errors = true

431

super

431

super

432

rescue Exception => e

432

rescue Exception => e

433

if ActionMailer::Base.raise_delivery_errors

433

if ActionMailer::Base.raise_delivery_errors

434

raise e

434

raise e

435

else

435

else

436

Rails.logger.error "Email delivery error: #{e.message}"

436

Rails.logger.error "Email delivery error: #{e.message}"

437

end

437

end

438

end

438

end

439

end

439

end

440

441

def self.method_missing(method, *args, &block)

441

def self.method_missing(method, *args, &block)

442

if m = method.to_s.match(%r{^deliver_(.+)$})

442

if m = method.to_s.match(%r{^deliver_(.+)$})

443

ActiveSupport::Deprecation.warn "Mailer.deliver_#{m[1]}(*args) is deprecated. Use Mailer.#{m[1]}(*args).deliver instead."

443

ActiveSupport::Deprecation.warn "Mailer.deliver_#{m[1]}(*args) is deprecated. Use Mailer.#{m[1]}(*args).deliver instead."

444

send(m[1], *args).deliver

444

send(m[1], *args).deliver

445

else

445

else

446

super

446

super

447

end

447

end

448

end

448

end

449

450

private

450

private

451

452

# Appends a Redmine header field (name is prepended with 'X-Redmine-')

452

# Appends a Redmine header field (name is prepended with 'X-Redmine-')

453

def redmine_headers(h)

453

def redmine_headers(h)

454

h.each { |k,v| headers["X-Redmine-#{k}"] = v.to_s }

454

h.each { |k,v| headers["X-Redmine-#{k}"] = v.to_s }

455

end

455

end

456

457

def self.token_for(object, rand=true)

457

def self.token_for(object, rand=true)

458

timestamp = object.send(object.respond_to?(:created_on) ? :created_on : :updated_on)

458

timestamp = object.send(object.respond_to?(:created_on) ? :created_on : :updated_on)

459

hash = [

459

hash = [

460

"redmine",

460

"redmine",

461

"#{object.class.name.demodulize.underscore}-#{object.id}",

461

"#{object.class.name.demodulize.underscore}-#{object.id}",

462

timestamp.strftime("%Y%m%d%H%M%S")

462

timestamp.strftime("%Y%m%d%H%M%S")

463

]

463

]

464

if rand

464

if rand

465

hash << Redmine::Utils.random_hex(8)

465

hash << Redmine::Utils.random_hex(8)

466

end

466

end

467

host = Setting.mail_from.to_s.gsub(%r{^.*@}, '')

467

host = Setting.mail_from.to_s.gsub(%r{^.*@}, '')

468

host = "#{::Socket.gethostname}.redmine" if host.empty?

468

host = "#{::Socket.gethostname}.redmine" if host.empty?

469

"#{hash.join('.')}@#{host}"

469

"#{hash.join('.')}@#{host}"

470

end

470

end

471

472

# Returns a Message-Id for the given object

472

# Returns a Message-Id for the given object

473

def self.message_id_for(object)

473

def self.message_id_for(object)

474

token_for(object, true)

474

token_for(object, true)

475

end

475

end

476

477

# Returns a uniq token for a given object referenced by all notifications

477

# Returns a uniq token for a given object referenced by all notifications

478

# related to this object

478

# related to this object

479

def self.references_for(object)

479

def self.references_for(object)

480

token_for(object, false)

480

token_for(object, false)

481

end

481

end

482

483

def message_id(object)

483

def message_id(object)

484

@message_id_object = object

484

@message_id_object = object

485

end

485

end

486

487

def references(object)

487

def references(object)

488

@references_objects ||= []

488

@references_objects ||= []

489

@references_objects << object

489

@references_objects << object

490

end

490

end

491

492

def mylogger

492

def mylogger

493

Rails.logger

493

Rails.logger

494

end

494

end

495

end

495

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

             # Redmine - project management software
             # Copyright (C) 2006-2014  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.
             class Mailer < ActionMailer::Base
               layout 'mailer'
               helper :application
               helper :issues
               helper :custom_fields
               include Redmine::I18n
               def self.default_url_options
                 { :host => Setting.host_name, :protocol => Setting.protocol }
               end
               # Builds a mail for notifying to_users and cc_users about a new issue
               def issue_add(issue, to_users, cc_users)
                 redmine_headers 'Project' => issue.project.identifier,
                                 'Issue-Id' => issue.id,
                                 'Issue-Author' => issue.author.login
                 redmine_headers 'Issue-Assignee' => issue.assigned_to.login if issue.assigned_to
                 message_id issue
                 references issue
                 @author = issue.author
                 @issue = issue
                 @users = to_users + cc_users
                 @issue_url = url_for(:controller => 'issues', :action => 'show', :id => issue)
                 mail :to => to_users.map(&:mail),
                   :cc => cc_users.map(&:mail),
                   :subject => "[#{issue.project.name} - #{issue.tracker.name} ##{issue.id}] (#{issue.status.name}) #{issue.subject}"
               end
               # Notifies users about a new issue
               def self.deliver_issue_add(issue)
                 to = issue.notified_users
                 cc = issue.notified_watchers - to
                 issue.each_notification(to + cc) do |users|
                   Mailer.issue_add(issue, to & users, cc & users).deliver
                 end
               end
               # Builds a mail for notifying to_users and cc_users about an issue update
               def issue_edit(journal, to_users, cc_users)
                 issue = journal.journalized
                 redmine_headers 'Project' => issue.project.identifier,
                                 'Issue-Id' => issue.id,
                                 'Issue-Author' => issue.author.login
                 redmine_headers 'Issue-Assignee' => issue.assigned_to.login if issue.assigned_to
                 message_id journal
                 references issue
                 @author = journal.user
                 s = "[#{issue.project.name} - #{issue.tracker.name} ##{issue.id}] "
                 s << "(#{issue.status.name}) " if journal.new_value_for('status_id')
                 s << issue.subject
                 @issue = issue
                 @users = to_users + cc_users
                 @journal = journal
                 @journal_details = journal.visible_details(@users.first)
                 @issue_url = url_for(:controller => 'issues', :action => 'show', :id => issue, :anchor => "change-#{journal.id}")
                 mail :to => to_users.map(&:mail),
                   :cc => cc_users.map(&:mail),
                   :subject => s
               end
               # Notifies users about an issue update
               def self.deliver_issue_edit(journal)
                 issue = journal.journalized.reload
                 to = journal.notified_users
-                cc = journal.notified_watchers
+                cc = journal.notified_watchers - to
                 journal.each_notification(to + cc) do |users|
                   issue.each_notification(users) do |users2|
                     Mailer.issue_edit(journal, to & users2, cc & users2).deliver
                   end
                 end
               end
               def reminder(user, issues, days)
                 set_language_if_valid user.language
                 @issues = issues
                 @days = days
                 @issues_url = url_for(:controller => 'issues', :action => 'index',
                                             :set_filter => 1, :assigned_to_id => user.id,
                                             :sort => 'due_date:asc')
                 mail :to => user.mail,
                   :subject => l(:mail_subject_reminder, :count => issues.size, :days => days)
               end
               # Builds a Mail::Message object used to email users belonging to the added document's project.
               #
               # Example:
               #   document_added(document) => Mail::Message object
               #   Mailer.document_added(document).deliver => sends an email to the document's project recipients
               def document_added(document)
                 redmine_headers 'Project' => document.project.identifier
                 @author = User.current
                 @document = document
                 @document_url = url_for(:controller => 'documents', :action => 'show', :id => document)
                 mail :to => document.recipients,
                   :subject => "[#{document.project.name}] #{l(:label_document_new)}: #{document.title}"
               end
               # Builds a Mail::Message object used to email recipients of a project when an attachements are added.
               #
               # Example:
               #   attachments_added(attachments) => Mail::Message object
               #   Mailer.attachments_added(attachments).deliver => sends an email to the project's recipients
               def attachments_added(attachments)
                 container = attachments.first.container
                 added_to = ''
                 added_to_url = ''
                 @author = attachments.first.author
                 case container.class.name
                 when 'Project'
                   added_to_url = url_for(:controller => 'files', :action => 'index', :project_id => container)
                   added_to = "#{l(:label_project)}: #{container}"
                   recipients = container.project.notified_users.select {|user| user.allowed_to?(:view_files, container.project)}.collect  {|u| u.mail}
                 when 'Version'
                   added_to_url = url_for(:controller => 'files', :action => 'index', :project_id => container.project)
                   added_to = "#{l(:label_version)}: #{container.name}"
                   recipients = container.project.notified_users.select {|user| user.allowed_to?(:view_files, container.project)}.collect  {|u| u.mail}
                 when 'Document'
                   added_to_url = url_for(:controller => 'documents', :action => 'show', :id => container.id)
                   added_to = "#{l(:label_document)}: #{container.title}"
                   recipients = container.recipients
                 end
                 redmine_headers 'Project' => container.project.identifier
                 @attachments = attachments
                 @added_to = added_to
                 @added_to_url = added_to_url
                 mail :to => recipients,
                   :subject => "[#{container.project.name}] #{l(:label_attachment_new)}"
               end
               # Builds a Mail::Message object used to email recipients of a news' project when a news item is added.
               #
               # Example:
               #   news_added(news) => Mail::Message object
               #   Mailer.news_added(news).deliver => sends an email to the news' project recipients
               def news_added(news)
                 redmine_headers 'Project' => news.project.identifier
                 @author = news.author
                 message_id news
                 references news
                 @news = news
                 @news_url = url_for(:controller => 'news', :action => 'show', :id => news)
                 mail :to => news.recipients,
                   :cc => news.cc_for_added_news,
                   :subject => "[#{news.project.name}] #{l(:label_news)}: #{news.title}"
               end
               # Builds a Mail::Message object used to email recipients of a news' project when a news comment is added.
               #
               # Example:
               #   news_comment_added(comment) => Mail::Message object
               #   Mailer.news_comment_added(comment) => sends an email to the news' project recipients
               def news_comment_added(comment)
                 news = comment.commented
                 redmine_headers 'Project' => news.project.identifier
                 @author = comment.author
                 message_id comment
                 references news
                 @news = news
                 @comment = comment
                 @news_url = url_for(:controller => 'news', :action => 'show', :id => news)
                 mail :to => news.recipients,
                  :cc => news.watcher_recipients,
                  :subject => "Re: [#{news.project.name}] #{l(:label_news)}: #{news.title}"
               end
               # Builds a Mail::Message object used to email the recipients of the specified message that was posted.
               #
               # Example:
               #   message_posted(message) => Mail::Message object
               #   Mailer.message_posted(message).deliver => sends an email to the recipients
               def message_posted(message)
                 redmine_headers 'Project' => message.project.identifier,
                                 'Topic-Id' => (message.parent_id || message.id)
                 @author = message.author
                 message_id message
                 references message.root
                 recipients = message.recipients
                 cc = ((message.root.watcher_recipients + message.board.watcher_recipients).uniq - recipients)
                 @message = message
                 @message_url = url_for(message.event_url)
                 mail :to => recipients,
                   :cc => cc,
                   :subject => "[#{message.board.project.name} - #{message.board.name} - msg#{message.root.id}] #{message.subject}"
               end
               # Builds a Mail::Message object used to email the recipients of a project of the specified wiki content was added.
               #
               # Example:
               #   wiki_content_added(wiki_content) => Mail::Message object
               #   Mailer.wiki_content_added(wiki_content).deliver => sends an email to the project's recipients
               def wiki_content_added(wiki_content)
                 redmine_headers 'Project' => wiki_content.project.identifier,
                                 'Wiki-Page-Id' => wiki_content.page.id
                 @author = wiki_content.author
                 message_id wiki_content
                 recipients = wiki_content.recipients
                 cc = wiki_content.page.wiki.watcher_recipients - recipients
                 @wiki_content = wiki_content
                 @wiki_content_url = url_for(:controller => 'wiki', :action => 'show',
                                                   :project_id => wiki_content.project,
                                                   :id => wiki_content.page.title)
                 mail :to => recipients,
                   :cc => cc,
                   :subject => "[#{wiki_content.project.name}] #{l(:mail_subject_wiki_content_added, :id => wiki_content.page.pretty_title)}"
               end
               # Builds a Mail::Message object used to email the recipients of a project of the specified wiki content was updated.
               #
               # Example:
               #   wiki_content_updated(wiki_content) => Mail::Message object
               #   Mailer.wiki_content_updated(wiki_content).deliver => sends an email to the project's recipients
               def wiki_content_updated(wiki_content)
                 redmine_headers 'Project' => wiki_content.project.identifier,
                                 'Wiki-Page-Id' => wiki_content.page.id
                 @author = wiki_content.author
                 message_id wiki_content
                 recipients = wiki_content.recipients
                 cc = wiki_content.page.wiki.watcher_recipients + wiki_content.page.watcher_recipients - recipients
                 @wiki_content = wiki_content
                 @wiki_content_url = url_for(:controller => 'wiki', :action => 'show',
                                                   :project_id => wiki_content.project,
                                                   :id => wiki_content.page.title)
                 @wiki_diff_url = url_for(:controller => 'wiki', :action => 'diff',
                                                :project_id => wiki_content.project, :id => wiki_content.page.title,
                                                :version => wiki_content.version)
                 mail :to => recipients,
                   :cc => cc,
                   :subject => "[#{wiki_content.project.name}] #{l(:mail_subject_wiki_content_updated, :id => wiki_content.page.pretty_title)}"
               end
               # Builds a Mail::Message object used to email the specified user their account information.
               #
               # Example:
               #   account_information(user, password) => Mail::Message object
               #   Mailer.account_information(user, password).deliver => sends account information to the user
               def account_information(user, password)
                 set_language_if_valid user.language
                 @user = user
                 @password = password
                 @login_url = url_for(:controller => 'account', :action => 'login')
                 mail :to => user.mail,
                   :subject => l(:mail_subject_register, Setting.app_title)
               end
               # Builds a Mail::Message object used to email all active administrators of an account activation request.
               #
               # Example:
               #   account_activation_request(user) => Mail::Message object
               #   Mailer.account_activation_request(user).deliver => sends an email to all active administrators
               def account_activation_request(user)
                 # Send the email to all active administrators
                 recipients = User.active.where(:admin => true).collect { |u| u.mail }.compact
                 @user = user
                 @url = url_for(:controller => 'users', :action => 'index',
                                      :status => User::STATUS_REGISTERED,
                                      :sort_key => 'created_on', :sort_order => 'desc')
                 mail :to => recipients,
                   :subject => l(:mail_subject_account_activation_request, Setting.app_title)
               end
               # Builds a Mail::Message object used to email the specified user that their account was activated by an administrator.
               #
               # Example:
               #   account_activated(user) => Mail::Message object
               #   Mailer.account_activated(user).deliver => sends an email to the registered user
               def account_activated(user)
                 set_language_if_valid user.language
                 @user = user
                 @login_url = url_for(:controller => 'account', :action => 'login')
                 mail :to => user.mail,
                   :subject => l(:mail_subject_register, Setting.app_title)
               end
               def lost_password(token)
                 set_language_if_valid(token.user.language)
                 @token = token
                 @url = url_for(:controller => 'account', :action => 'lost_password', :token => token.value)
                 mail :to => token.user.mail,
                   :subject => l(:mail_subject_lost_password, Setting.app_title)
               end
               def register(token)
                 set_language_if_valid(token.user.language)
                 @token = token
                 @url = url_for(:controller => 'account', :action => 'activate', :token => token.value)
                 mail :to => token.user.mail,
                   :subject => l(:mail_subject_register, Setting.app_title)
               end
               def test_email(user)
                 set_language_if_valid(user.language)
                 @url = url_for(:controller => 'welcome')
                 mail :to => user.mail,
                   :subject => 'Redmine test'
               end
               # Sends reminders to issue assignees
               # Available options:
               # * :days     => how many days in the future to remind about (defaults to 7)
               # * :tracker  => id of tracker for filtering issues (defaults to all trackers)
               # * :project  => id or identifier of project to process (defaults to all projects)
               # * :users    => array of user/group ids who should be reminded
               def self.reminders(options={})
                 days = options[:days] || 7
                 project = options[:project] ? Project.find(options[:project]) : nil
                 tracker = options[:tracker] ? Tracker.find(options[:tracker]) : nil
                 user_ids = options[:users]
                 scope = Issue.open.where("#{Issue.table_name}.assigned_to_id IS NOT NULL" +
                   " AND #{Project.table_name}.status = #{Project::STATUS_ACTIVE}" +
                   " AND #{Issue.table_name}.due_date <= ?", days.day.from_now.to_date
                 )
                 scope = scope.where(:assigned_to_id => user_ids) if user_ids.present?
                 scope = scope.where(:project_id => project.id) if project
                 scope = scope.where(:tracker_id => tracker.id) if tracker
                 issues_by_assignee = scope.includes(:status, :assigned_to, :project, :tracker).
                                           group_by(&:assigned_to)
                 issues_by_assignee.keys.each do |assignee|
                   if assignee.is_a?(Group)
                     assignee.users.each do |user|
                       issues_by_assignee[user] ||= []
                       issues_by_assignee[user] += issues_by_assignee[assignee]
                     end
                   end
                 end
                 issues_by_assignee.each do |assignee, issues|
                   reminder(assignee, issues, days).deliver if assignee.is_a?(User) && assignee.active?
                 end
               end
               # Activates/desactivates email deliveries during +block+
               def self.with_deliveries(enabled = true, &block)
                 was_enabled = ActionMailer::Base.perform_deliveries
                 ActionMailer::Base.perform_deliveries = !!enabled
                 yield
               ensure
                 ActionMailer::Base.perform_deliveries = was_enabled
               end
               # Sends emails synchronously in the given block
               def self.with_synched_deliveries(&block)
                 saved_method = ActionMailer::Base.delivery_method
                 if m = saved_method.to_s.match(%r{^async_(.+)$})
                   synched_method = m[1]
                   ActionMailer::Base.delivery_method = synched_method.to_sym
                   ActionMailer::Base.send "#{synched_method}_settings=", ActionMailer::Base.send("async_#{synched_method}_settings")
                 end
                 yield
               ensure
                 ActionMailer::Base.delivery_method = saved_method
               end
               def mail(headers={}, &block)
                 headers.merge! 'X-Mailer' => 'Redmine',
                         'X-Redmine-Host' => Setting.host_name,
                         'X-Redmine-Site' => Setting.app_title,
                         'X-Auto-Response-Suppress' => 'OOF',
                         'Auto-Submitted' => 'auto-generated',
                         'From' => Setting.mail_from,
                         'List-Id' => "<#{Setting.mail_from.to_s.gsub('@', '.')}>"
                 # Removes the author from the recipients and cc
                 # if the author does not want to receive notifications
                 # about what the author do
                 if @author && @author.logged? && @author.pref.no_self_notified
                   headers[:to].delete(@author.mail) if headers[:to].is_a?(Array)
                   headers[:cc].delete(@author.mail) if headers[:cc].is_a?(Array)
                 end
                 if @author && @author.logged?
                   redmine_headers 'Sender' => @author.login
                 end
                 # Blind carbon copy recipients
                 if Setting.bcc_recipients?
                   headers[:bcc] = [headers[:to], headers[:cc]].flatten.uniq.reject(&:blank?)
                   headers[:to] = nil
                   headers[:cc] = nil
                 end
                 if @message_id_object
                   headers[:message_id] = "<#{self.class.message_id_for(@message_id_object)}>"
                 end
                 if @references_objects
                   headers[:references] = @references_objects.collect {|o| "<#{self.class.references_for(o)}>"}.join(' ')
                 end
                 m = if block_given?
                   super headers, &block
                 else
                   super headers do |format|
                     format.text
                     format.html unless Setting.plain_text_mail?
                   end
                 end
                 set_language_if_valid @initial_language
                 m
               end
               def initialize(*args)
                 @initial_language = current_language
                 set_language_if_valid Setting.default_language
                 super
               end
               def self.deliver_mail(mail)
                 return false if mail.to.blank? && mail.cc.blank? && mail.bcc.blank?
                 begin
                   # Log errors when raise_delivery_errors is set to false, Rails does not
                   mail.raise_delivery_errors = true
                   super
                 rescue Exception => e
                   if ActionMailer::Base.raise_delivery_errors
                     raise e
                   else
                     Rails.logger.error "Email delivery error: #{e.message}"
                   end
                 end
               end
               def self.method_missing(method, *args, &block)
                 if m = method.to_s.match(%r{^deliver_(.+)$})
                   ActiveSupport::Deprecation.warn "Mailer.deliver_#{m[1]}(*args) is deprecated. Use Mailer.#{m[1]}(*args).deliver instead."
                   send(m[1], *args).deliver
                 else
                   super
                 end
               end
               private
               # Appends a Redmine header field (name is prepended with 'X-Redmine-')
               def redmine_headers(h)
                 h.each { |k,v| headers["X-Redmine-#{k}"] = v.to_s }
               end
               def self.token_for(object, rand=true)
                 timestamp = object.send(object.respond_to?(:created_on) ? :created_on : :updated_on)
                 hash = [
                   "redmine",
                   "#{object.class.name.demodulize.underscore}-#{object.id}",
                   timestamp.strftime("%Y%m%d%H%M%S")
                 ]
                 if rand
                   hash << Redmine::Utils.random_hex(8)
                 end
                 host = Setting.mail_from.to_s.gsub(%r{^.*@}, '')
                 host = "#{::Socket.gethostname}.redmine" if host.empty?
                 "#{hash.join('.')}@#{host}"
               end
               # Returns a Message-Id for the given object
               def self.message_id_for(object)
                 token_for(object, true)
               end
               # Returns a uniq token for a given object referenced by all notifications
               # related to this object
               def self.references_for(object)
                 token_for(object, false)
               end
               def message_id(object)
                 @message_id_object = object
               end
               def references(object)
                 @references_objects ||= []
                 @references_objects << object
               end
               def mylogger
                 Rails.logger
               end
             end