2017-07-23 15:17:16 +00:00
|
|
|
# frozen_string_literal: true
|
|
|
|
|
2016-08-06 17:01:31 +00:00
|
|
|
require "tmpdir"
|
2010-01-24 17:11:57 +00:00
|
|
|
|
2013-05-19 15:36:06 +00:00
|
|
|
module ActionMailer
|
2012-09-18 00:18:56 +00:00
|
|
|
# This module handles everything related to mail delivery, from registering
|
|
|
|
# new delivery methods to configuring the mail object to be sent.
|
2010-01-19 14:34:58 +00:00
|
|
|
module DeliveryMethods
|
2010-01-24 17:11:57 +00:00
|
|
|
extend ActiveSupport::Concern
|
2010-01-19 14:34:58 +00:00
|
|
|
|
2010-01-24 17:11:57 +00:00
|
|
|
included do
|
2010-01-24 18:36:42 +00:00
|
|
|
# Do not make this inheritable, because we always want it to propagate
|
2017-05-31 09:16:20 +00:00
|
|
|
cattr_accessor :raise_delivery_errors, default: true
|
|
|
|
cattr_accessor :perform_deliveries, default: true
|
|
|
|
cattr_accessor :deliver_later_queue_name, default: :mailers
|
2015-01-18 22:34:01 +00:00
|
|
|
|
2017-05-29 16:01:50 +00:00
|
|
|
class_attribute :delivery_methods, default: {}.freeze
|
|
|
|
class_attribute :delivery_method, default: :smtp
|
2010-01-19 14:34:58 +00:00
|
|
|
|
2010-01-24 17:11:57 +00:00
|
|
|
add_delivery_method :smtp, Mail::SMTP,
|
2012-10-07 17:54:14 +00:00
|
|
|
address: "localhost",
|
|
|
|
port: 25,
|
2016-08-06 17:01:31 +00:00
|
|
|
domain: "localhost.localdomain",
|
2012-10-07 17:54:14 +00:00
|
|
|
user_name: nil,
|
|
|
|
password: nil,
|
|
|
|
authentication: nil,
|
|
|
|
enable_starttls_auto: true
|
2010-01-19 14:34:58 +00:00
|
|
|
|
2010-01-24 17:11:57 +00:00
|
|
|
add_delivery_method :file, Mail::FileDelivery,
|
2012-10-07 17:54:14 +00:00
|
|
|
location: defined?(Rails.root) ? "#{Rails.root}/tmp/mails" : "#{Dir.tmpdir}/mails"
|
2010-01-19 14:34:58 +00:00
|
|
|
|
2010-01-24 17:11:57 +00:00
|
|
|
add_delivery_method :sendmail, Mail::Sendmail,
|
2016-08-06 17:01:31 +00:00
|
|
|
location: "/usr/sbin/sendmail",
|
|
|
|
arguments: "-i"
|
2010-01-19 14:34:58 +00:00
|
|
|
|
2010-01-24 17:11:57 +00:00
|
|
|
add_delivery_method :test, Mail::TestMailer
|
2010-01-24 15:37:28 +00:00
|
|
|
end
|
2010-01-19 14:34:58 +00:00
|
|
|
|
2013-05-15 04:19:38 +00:00
|
|
|
# Helpers for creating and wrapping delivery behavior, used by DeliveryMethods.
|
2010-01-24 17:11:57 +00:00
|
|
|
module ClassMethods
|
2010-01-25 10:47:03 +00:00
|
|
|
# Provides a list of emails that have been delivered by Mail::TestMailer
|
2012-10-07 17:54:14 +00:00
|
|
|
delegate :deliveries, :deliveries=, to: Mail::TestMailer
|
2010-01-24 18:36:42 +00:00
|
|
|
|
2012-09-18 00:18:56 +00:00
|
|
|
# Adds a new delivery method through the given class using the given
|
|
|
|
# symbol as alias and the default options supplied.
|
2010-08-14 05:13:00 +00:00
|
|
|
#
|
2010-01-24 17:11:57 +00:00
|
|
|
# add_delivery_method :sendmail, Mail::Sendmail,
|
2012-09-18 00:18:56 +00:00
|
|
|
# location: '/usr/sbin/sendmail',
|
2016-07-06 09:53:40 +00:00
|
|
|
# arguments: '-i'
|
2016-10-29 03:05:58 +00:00
|
|
|
def add_delivery_method(symbol, klass, default_options = {})
|
2010-02-01 02:32:28 +00:00
|
|
|
class_attribute(:"#{symbol}_settings") unless respond_to?(:"#{symbol}_settings")
|
2020-10-26 16:17:15 +00:00
|
|
|
public_send(:"#{symbol}_settings=", default_options)
|
2010-02-01 02:32:28 +00:00
|
|
|
self.delivery_methods = delivery_methods.merge(symbol.to_sym => klass).freeze
|
2010-01-24 17:11:57 +00:00
|
|
|
end
|
2010-01-19 14:34:58 +00:00
|
|
|
|
2016-10-29 03:05:58 +00:00
|
|
|
def wrap_delivery_behavior(mail, method = nil, options = nil) # :nodoc:
|
2017-01-05 08:20:57 +00:00
|
|
|
method ||= delivery_method
|
2010-01-25 02:39:48 +00:00
|
|
|
mail.delivery_handler = self
|
2010-01-24 15:37:28 +00:00
|
|
|
|
2010-01-26 10:46:42 +00:00
|
|
|
case method
|
|
|
|
when NilClass
|
|
|
|
raise "Delivery method cannot be nil"
|
|
|
|
when Symbol
|
2012-05-03 12:11:31 +00:00
|
|
|
if klass = delivery_methods[method]
|
2013-07-25 19:00:56 +00:00
|
|
|
mail.delivery_method(klass, (send(:"#{method}_settings") || {}).merge(options || {}))
|
2010-01-24 17:11:57 +00:00
|
|
|
else
|
|
|
|
raise "Invalid delivery method #{method.inspect}"
|
|
|
|
end
|
2010-01-19 14:34:58 +00:00
|
|
|
else
|
2010-01-24 17:11:57 +00:00
|
|
|
mail.delivery_method(method)
|
2010-01-19 14:34:58 +00:00
|
|
|
end
|
2010-01-24 17:11:57 +00:00
|
|
|
|
2012-08-07 16:59:31 +00:00
|
|
|
mail.perform_deliveries = perform_deliveries
|
2010-01-24 17:11:57 +00:00
|
|
|
mail.raise_delivery_errors = raise_delivery_errors
|
2010-01-19 14:34:58 +00:00
|
|
|
end
|
2010-01-24 15:37:28 +00:00
|
|
|
end
|
2010-01-19 14:34:58 +00:00
|
|
|
|
2012-09-18 00:18:56 +00:00
|
|
|
def wrap_delivery_behavior!(*args) # :nodoc:
|
2010-01-24 17:11:57 +00:00
|
|
|
self.class.wrap_delivery_behavior(message, *args)
|
2010-01-19 14:34:58 +00:00
|
|
|
end
|
|
|
|
end
|
2010-02-01 02:32:28 +00:00
|
|
|
end
|