2018-08-15 21:45:57 +00:00
|
|
|
# frozen_string_literal: true
|
|
|
|
|
2020-01-27 21:08:47 +00:00
|
|
|
class Notify < ApplicationMailer
|
2014-02-24 11:12:29 +00:00
|
|
|
include ActionDispatch::Routing::PolymorphicRoutes
|
2017-06-29 17:06:35 +00:00
|
|
|
include GitlabRoutingHelper
|
2018-12-13 11:15:48 +00:00
|
|
|
include EmailsHelper
|
2019-04-07 18:35:16 +00:00
|
|
|
include IssuablesHelper
|
2014-02-24 11:12:29 +00:00
|
|
|
|
2013-03-19 18:00:41 +00:00
|
|
|
include Emails::Issues
|
|
|
|
include Emails::MergeRequests
|
|
|
|
include Emails::Notes
|
2018-02-06 13:25:46 +00:00
|
|
|
include Emails::PagesDomains
|
2013-03-19 18:00:41 +00:00
|
|
|
include Emails::Projects
|
2013-09-11 18:17:28 +00:00
|
|
|
include Emails::Profile
|
2016-08-25 12:01:10 +00:00
|
|
|
include Emails::Pipelines
|
2016-06-02 14:14:02 +00:00
|
|
|
include Emails::Members
|
2018-09-06 19:20:42 +00:00
|
|
|
include Emails::AutoDevops
|
2018-12-05 15:22:52 +00:00
|
|
|
include Emails::RemoteMirrors
|
2019-10-17 18:08:05 +00:00
|
|
|
include Emails::Releases
|
2020-05-14 03:07:52 +00:00
|
|
|
include Emails::Groups
|
2020-05-27 18:08:14 +00:00
|
|
|
include Emails::Reviews
|
2020-07-14 15:09:05 +00:00
|
|
|
include Emails::ServiceDesk
|
2013-01-09 05:44:05 +00:00
|
|
|
|
2020-05-27 18:08:14 +00:00
|
|
|
helper TimeboxesHelper
|
2016-11-06 19:27:51 +00:00
|
|
|
helper MergeRequestsHelper
|
|
|
|
helper DiffHelper
|
|
|
|
helper BlobHelper
|
|
|
|
helper EmailsHelper
|
|
|
|
helper MembersHelper
|
2018-04-26 09:27:44 +00:00
|
|
|
helper AvatarsHelper
|
2016-11-06 19:27:51 +00:00
|
|
|
helper GitlabRoutingHelper
|
2019-04-07 18:35:16 +00:00
|
|
|
helper IssuablesHelper
|
2012-04-23 12:32:56 +00:00
|
|
|
|
2015-01-18 15:29:37 +00:00
|
|
|
def test_email(recipient_email, subject, body)
|
|
|
|
mail(to: recipient_email,
|
2014-12-04 14:22:10 +00:00
|
|
|
subject: subject,
|
|
|
|
body: body.html_safe,
|
|
|
|
content_type: 'text/html'
|
2015-12-15 02:53:52 +00:00
|
|
|
)
|
2014-12-04 14:22:10 +00:00
|
|
|
end
|
|
|
|
|
2015-02-25 14:49:40 +00:00
|
|
|
# Splits "gitlab.corp.company.com" up into "gitlab.corp.company.com",
|
|
|
|
# "corp.company.com" and "company.com".
|
|
|
|
# Respects set tld length so "company.co.uk" won't match "somethingelse.uk"
|
|
|
|
def self.allowed_email_domains
|
|
|
|
domain_parts = Gitlab.config.gitlab.host.split(".")
|
|
|
|
allowed_domains = []
|
|
|
|
begin
|
|
|
|
allowed_domains << domain_parts.join(".")
|
|
|
|
domain_parts.shift
|
|
|
|
end while domain_parts.length > ActionDispatch::Http::URL.tld_length
|
|
|
|
|
|
|
|
allowed_domains
|
|
|
|
end
|
|
|
|
|
2015-04-14 10:52:33 +00:00
|
|
|
def can_send_from_user_email?(sender)
|
|
|
|
sender_domain = sender.email.split("@").last
|
|
|
|
self.class.allowed_email_domains.include?(sender_domain)
|
|
|
|
end
|
|
|
|
|
2015-11-18 09:12:09 +00:00
|
|
|
private
|
|
|
|
|
2014-02-17 17:49:42 +00:00
|
|
|
# Return an email address that displays the name of the sender.
|
|
|
|
# Only the displayed name changes; the actual email address is always the same.
|
2020-01-09 18:07:52 +00:00
|
|
|
def sender(sender_id, send_from_user_email: false, sender_name: nil)
|
2015-04-14 10:52:33 +00:00
|
|
|
return unless sender = User.find(sender_id)
|
2015-04-25 23:18:09 +00:00
|
|
|
|
2015-04-14 10:52:33 +00:00
|
|
|
address = default_sender_address
|
2020-01-09 18:07:52 +00:00
|
|
|
address.display_name = sender_name.presence || sender.name
|
2015-02-25 13:05:45 +00:00
|
|
|
|
2015-04-14 10:52:33 +00:00
|
|
|
if send_from_user_email && can_send_from_user_email?(sender)
|
|
|
|
address.address = sender.email
|
2014-02-17 17:49:42 +00:00
|
|
|
end
|
2015-04-14 10:52:33 +00:00
|
|
|
|
|
|
|
address.format
|
2014-02-17 17:49:42 +00:00
|
|
|
end
|
|
|
|
|
2012-08-21 03:04:53 +00:00
|
|
|
# Formats arguments into a String suitable for use as an email subject
|
|
|
|
#
|
|
|
|
# extra - Extra Strings to be inserted into the subject
|
|
|
|
#
|
|
|
|
# Examples
|
|
|
|
#
|
|
|
|
# >> subject('Lorem ipsum')
|
2014-02-17 15:45:28 +00:00
|
|
|
# => "Lorem ipsum"
|
2012-08-21 03:04:53 +00:00
|
|
|
#
|
|
|
|
# # Automatically inserts Project name when @project is set
|
|
|
|
# >> @project = Project.last
|
|
|
|
# => #<Project id: 1, name: "Ruby on Rails", path: "ruby_on_rails", ...>
|
|
|
|
# >> subject('Lorem ipsum')
|
2014-02-17 15:45:28 +00:00
|
|
|
# => "Ruby on Rails | Lorem ipsum "
|
2012-08-21 03:04:53 +00:00
|
|
|
#
|
|
|
|
# # Accepts multiple arguments
|
|
|
|
# >> subject('Lorem ipsum', 'Dolor sit amet')
|
2014-02-17 15:45:28 +00:00
|
|
|
# => "Lorem ipsum | Dolor sit amet"
|
2012-08-21 03:04:53 +00:00
|
|
|
def subject(*extra)
|
2018-08-15 21:45:57 +00:00
|
|
|
subject = []
|
|
|
|
|
|
|
|
subject << @project.name if @project
|
|
|
|
subject << @group.name if @group
|
|
|
|
subject.concat(extra) if extra.present?
|
|
|
|
subject << Gitlab.config.gitlab.email_subject_suffix if Gitlab.config.gitlab.email_subject_suffix.present?
|
|
|
|
|
|
|
|
subject.join(' | ')
|
2011-12-18 14:07:47 +00:00
|
|
|
end
|
2014-02-24 11:12:29 +00:00
|
|
|
|
|
|
|
# Return a string suitable for inclusion in the 'Message-Id' mail header.
|
|
|
|
#
|
|
|
|
# The message-id is generated from the unique URL to a model object.
|
|
|
|
def message_id(model)
|
|
|
|
model_name = model.class.model_name.singular_route_key
|
|
|
|
"<#{model_name}_#{model.id}@#{Gitlab.config.gitlab.host}>"
|
|
|
|
end
|
|
|
|
|
2015-08-19 17:17:20 +00:00
|
|
|
def mail_thread(model, headers = {})
|
2015-12-19 19:04:40 +00:00
|
|
|
add_project_headers
|
2016-10-12 17:07:36 +00:00
|
|
|
add_unsubscription_headers_and_links
|
2019-08-21 19:23:27 +00:00
|
|
|
add_model_headers(model)
|
2016-10-12 17:07:36 +00:00
|
|
|
|
2015-12-09 10:59:25 +00:00
|
|
|
headers['X-GitLab-Reply-Key'] = reply_key
|
2015-08-18 22:46:36 +00:00
|
|
|
|
2017-12-28 17:25:02 +00:00
|
|
|
@reason = headers['X-GitLab-NotificationReason']
|
|
|
|
|
2017-03-21 15:28:47 +00:00
|
|
|
if Gitlab::IncomingEmail.enabled? && @sent_notification
|
2018-05-03 21:32:20 +00:00
|
|
|
headers['Reply-To'] = Mail::Address.new(Gitlab::IncomingEmail.reply_address(reply_key)).tap do |address|
|
|
|
|
address.display_name = reply_display_name(model)
|
|
|
|
end
|
2015-08-19 17:17:32 +00:00
|
|
|
|
2018-12-11 12:33:27 +00:00
|
|
|
fallback_reply_message_id = "<reply-#{reply_key}@#{Gitlab.config.gitlab.host}>"
|
2017-12-08 21:45:57 +00:00
|
|
|
headers['References'] ||= []
|
2018-07-27 12:10:18 +00:00
|
|
|
headers['References'].unshift(fallback_reply_message_id)
|
2016-03-17 19:03:51 +00:00
|
|
|
|
2015-08-19 17:17:32 +00:00
|
|
|
@reply_by_email = true
|
2015-08-18 22:46:36 +00:00
|
|
|
end
|
|
|
|
|
|
|
|
mail(headers)
|
2014-02-24 11:12:29 +00:00
|
|
|
end
|
|
|
|
|
2018-05-03 21:32:20 +00:00
|
|
|
# `model` is used on EE code
|
|
|
|
def reply_display_name(_model)
|
|
|
|
@project.full_name
|
|
|
|
end
|
|
|
|
|
2015-08-19 17:17:20 +00:00
|
|
|
# Send an email that starts a new conversation thread,
|
|
|
|
# with headers suitable for grouping by thread in email clients.
|
|
|
|
#
|
|
|
|
# See: mail_answer_thread
|
|
|
|
def mail_new_thread(model, headers = {})
|
2016-03-17 19:03:51 +00:00
|
|
|
headers['Message-ID'] = message_id(model)
|
2015-08-19 17:17:20 +00:00
|
|
|
|
|
|
|
mail_thread(model, headers)
|
|
|
|
end
|
|
|
|
|
2014-02-24 11:12:29 +00:00
|
|
|
# Send an email that responds to an existing conversation thread,
|
|
|
|
# with headers suitable for grouping by thread in email clients.
|
|
|
|
#
|
|
|
|
# For grouping emails by thread, email clients heuristics require the answers to:
|
|
|
|
#
|
|
|
|
# * have a subject that begin by 'Re: '
|
|
|
|
# * have a 'In-Reply-To' or 'References' header that references the original 'Message-ID'
|
|
|
|
#
|
2015-08-18 22:46:36 +00:00
|
|
|
def mail_answer_thread(model, headers = {})
|
2015-10-01 08:44:50 +00:00
|
|
|
headers['Message-ID'] = "<#{SecureRandom.hex}@#{Gitlab.config.gitlab.host}>"
|
2014-02-24 11:12:29 +00:00
|
|
|
headers['In-Reply-To'] = message_id(model)
|
2018-07-27 12:10:18 +00:00
|
|
|
headers['References'] = [message_id(model)]
|
2014-02-24 11:12:29 +00:00
|
|
|
|
2018-12-10 12:59:17 +00:00
|
|
|
headers[:subject] = "Re: #{headers[:subject]}" if headers[:subject]
|
2015-08-19 00:02:26 +00:00
|
|
|
|
2015-08-19 17:17:20 +00:00
|
|
|
mail_thread(model, headers)
|
2014-02-24 11:12:29 +00:00
|
|
|
end
|
2015-03-27 11:58:23 +00:00
|
|
|
|
2017-09-15 06:58:21 +00:00
|
|
|
def mail_answer_note_thread(model, note, headers = {})
|
|
|
|
headers['Message-ID'] = message_id(note)
|
2017-12-08 21:45:57 +00:00
|
|
|
headers['In-Reply-To'] = message_id(note.references.last)
|
|
|
|
headers['References'] = note.references.map { |ref| message_id(ref) }
|
2017-09-15 06:58:21 +00:00
|
|
|
|
|
|
|
headers['X-GitLab-Discussion-ID'] = note.discussion.id if note.part_of_discussion?
|
|
|
|
|
2018-12-11 12:33:27 +00:00
|
|
|
headers[:subject] = "Re: #{headers[:subject]}" if headers[:subject]
|
2017-09-15 06:58:21 +00:00
|
|
|
|
|
|
|
mail_thread(model, headers)
|
|
|
|
end
|
|
|
|
|
2015-08-18 22:46:36 +00:00
|
|
|
def reply_key
|
2015-09-21 07:46:47 +00:00
|
|
|
@reply_key ||= SentNotification.reply_key
|
2015-08-18 22:46:36 +00:00
|
|
|
end
|
2015-12-19 19:04:40 +00:00
|
|
|
|
2019-08-21 19:23:27 +00:00
|
|
|
# This method applies threading headers to the email to identify
|
|
|
|
# the instance we are discussing.
|
|
|
|
#
|
|
|
|
# All model instances must have `#id`, and may implement `#iid`.
|
|
|
|
def add_model_headers(object)
|
|
|
|
# Use replacement so we don't strip the module.
|
|
|
|
prefix = "X-GitLab-#{object.class.name.gsub(/::/, '-')}"
|
|
|
|
|
|
|
|
headers["#{prefix}-ID"] = object.id
|
|
|
|
headers["#{prefix}-IID"] = object.iid if object.respond_to?(:iid)
|
|
|
|
end
|
|
|
|
|
2015-12-19 19:04:40 +00:00
|
|
|
def add_project_headers
|
|
|
|
return unless @project
|
|
|
|
|
|
|
|
headers['X-GitLab-Project'] = @project.name
|
|
|
|
headers['X-GitLab-Project-Id'] = @project.id
|
2017-07-20 09:34:09 +00:00
|
|
|
headers['X-GitLab-Project-Path'] = @project.full_path
|
2018-12-13 11:15:48 +00:00
|
|
|
headers['List-Id'] = "#{@project.full_path} <#{create_list_id_string(@project)}>"
|
2015-12-19 19:04:40 +00:00
|
|
|
end
|
2016-10-12 17:07:36 +00:00
|
|
|
|
|
|
|
def add_unsubscription_headers_and_links
|
|
|
|
return unless !@labels_url && @sent_notification && @sent_notification.unsubscribable?
|
|
|
|
|
|
|
|
list_unsubscribe_methods = [unsubscribe_sent_notification_url(@sent_notification, force: true)]
|
|
|
|
if Gitlab::IncomingEmail.enabled? && Gitlab::IncomingEmail.supports_wildcard?
|
|
|
|
list_unsubscribe_methods << "mailto:#{Gitlab::IncomingEmail.unsubscribe_address(reply_key)}"
|
|
|
|
end
|
|
|
|
|
|
|
|
headers['List-Unsubscribe'] = list_unsubscribe_methods.map { |e| "<#{e}>" }.join(',')
|
2017-03-21 15:28:47 +00:00
|
|
|
@unsubscribe_url = unsubscribe_sent_notification_url(@sent_notification)
|
2016-10-12 17:07:36 +00:00
|
|
|
end
|
2011-10-08 21:36:38 +00:00
|
|
|
end
|
2019-09-13 13:26:31 +00:00
|
|
|
|
|
|
|
Notify.prepend_if_ee('EE::Notify')
|