Redmine

      deliver_security_notification(

        recipients: [address_before_last_save],

        recipients: [address],

    deliver_security_notification(options)

    deliver_security_notification(

      recipients: [address],

  def deliver_security_notification(options={})

    Mailer.security_notification(user,

  # This class wraps multiple generated `Mail::Message` objects and allows to

  # deliver them all at once. It is usually used to handle multiple mails for

  # different receivers created by a single mail event. The wrapped mails can

  # then be delivered in one go.

  #

  # The public interface of the class resembles a single mail message. You can

  # directly use any of the deliver_* methods to send the contained messages

  # now or later.

  class MultiMessage

    attr_reader :mails

    # @param mails [Array<Mail, Proc>] an Array of mails or Procs which create

    #   mail objects and allow to call a method on it.

    def initialize(action, *args)

      @action = action

      @args = args

      @mails = []

    end

    def for(users)

      Array.wrap(users).each do |user|

        @mails << ActionMailer::MessageDelivery.new(Mailer, @action, user, *@args)

      end

      self

    end

    def deliver_later(options = {})

      enqueue_delivery :deliver_now, options

    end

    def deliver_later!(options = {})

      enqueue_delivery :deliver_now!, options

    end

    def processed?

      @mails.any?(&:processed?)

    end

    # @return [Object] the delivery method of the first mail.

    #   Usually, this is the very same value for all mails and matches the

    #   default value of the Mailer class

    def delivery_method

      (@mails.first || ActionMailer::Base::NullMail.new).delivery_method

    end

    # @return [ActionMailer::Base] the delivery handler of the first mail. This

    #   is always the `Mailer` class.

    def delivery_handler

      (@mails.first || ActionMailer::Base::NullMail.new).delivery_handler

    end

    private

    def method_missing(method, *args, &block)

      if method =~ /\Adeliver([_!?]|\z)/

        @mails.each do |mail|

          mail.public_send(method, *args, &block)

        end

      else

        super

      end

    end

    def respond_to_missing(method, *args)

      method =~ /\Adeliver([_!?]|\z)/ || method == 'processed?' || super

    end

    # This method is slightly adapted from ActionMailer::MessageDelivery

    def enqueue_delivery(delivery_method, options = {})

      if processed?

        ::Kernel.raise "You've accessed the message before asking to " \

          "deliver it later, so you may have made local changes that would " \

          "be silently lost if we enqueued a job to deliver it. Why? Only " \

          "the mailer method *arguments* are passed with the delivery job! " \

          "Do not access the message in any way if you mean to deliver it " \

          "later. Workarounds: 1. don't touch the message before calling " \

          "#deliver_later, 2. only touch the message *within your mailer " \

          "method*, or 3. use a custom Active Job instead of #deliver_later."

      else

        args = 'Mailer', @action.to_s, delivery_method.to_s, *@args

        ::ActionMailer::DeliveryJob.set(options).perform_later(*args)

      end

    end

  end

  def process(action, *args)

    user = args.shift

    raise ArgumentError, "First argument has to be a user, was #{user.inspect}" unless user.is_a?(User)

    initial_user = User.current

    initial_language = ::I18n.locale

    begin

      User.current = user

      lang = find_language(user.language) if user.logged?

      lang ||= Setting.default_language

      set_language_if_valid(lang)

      super(action, *args)

    ensure

      User.current = initial_user

      ::I18n.locale = initial_language

    end

  end

  # Builds a mail for notifying the current user about a new issue

  #

  # Example:

  #   issue_add(issue) => Mail::Message object

  def issue_add(issue)

    @users = [User.current]

    mail :to => User.current,

  #

  # Example:

  #   Mailer.issue_add(journal).deliver => sends emails to the project's recipients

  def self.issue_add(issue)

    users = issue.notified_users | issue.notified_watchers

    MultiMessage.new(:issue_add, issue).for(users)

  end

  # Notifies users about a new issue

  #

  # Example:

  #   Mailer.deliver_issue_add(issue) => sends emails to the project's recipients

    issue_add(issue).deliver

  # Builds a mail for notifying the current user about an issue update

  #

  # Example:

  #   issue_edit(journal) => Mail::Message object

  def issue_edit(journal)

    @users = [User.current]

    @journal_details = journal.visible_details

    mail :to => User.current,

  # Build a MultiMessage to notify users about an issue update

  #

  # Example:

  #   Mailer.issue_edit(journal).deliver => sends emails to the project's recipients

  def self.issue_edit(journal)

    users  = journal.notified_users

    users |= journal.notified_watchers

    users.select! do |user|

      journal.notes? || journal.visible_details(user).any?

    end

    MultiMessage.new(:issue_edit, journal).for(users)

  end

  #

  # Example:

  #   Mailer.deliver_issue_edit(journal) => sends emails to the project's recipients

    issue_edit(journal).deliver

  # Builds a Mail::Message object used to send en email reminder to the current

  # user about their due issues.

  #

  # Example:

  #   reminder(issues, days) => Mail::Message object

  def reminder(issues, days)

                                :set_filter => 1, :assigned_to_id => User.current.id,

    mail :to => User.current,

  # Builds a Mail::Message object used to email the given user about their due

  # issues

  #   Mailer.reminder(user, issues, days, author).deliver => sends an email to the user

  def self.reminder(user, issues, days)

    MultiMessage.new(:reminder, issues, days).for(user)

  end

  # Builds a Mail::Message object used to email the current user that a document

  # was added.

  #

  # Example:

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

  def document_added(document, author)

    @author = author

    mail :to => User.current,

  # Build a MultiMessage to notify users about an added document.

  #

  # Example:

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

  def self.document_added(document)

    users = document.notified_users

    MultiMessage.new(:document_added, document, User.current).for(users)

  end

  # Builds a Mail::Message object used to email the current user when

  # attachements are added.

    mail :to => User.current,

  # Build a MultiMessage to notify users about an added attachment

  #

  # Example:

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

  def self.attachments_added(attachments)

    container = attachments.first.container

    case container.class.name

    when 'Project', 'Version'

      users = container.project.notified_users.select {|user| user.allowed_to?(:view_files, container.project)}

    when 'Document'

      users = container.notified_users

    end

    MultiMessage.new(:attachments_added, attachments).for(users)

  end

  # Builds a Mail::Message object used to email the current user when a news

  # item is added.

    mail :to => User.current,

  # Build a MultiMessage to notify users about a new news item

  #

  # Example:

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

  def self.news_added(news)

    users = news.notified_users | news.notified_watchers_for_added_news

    MultiMessage.new(:news_added, news).for(users)

  end

  # Builds a Mail::Message object used to email the current user when a news

  # comment is added.

    mail :to => User.current,

  # Build a MultiMessage to notify users about a new news comment

  #

  # Example:

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

  def self.news_comment_added(comment)

    news = comment.commented

    users = news.notified_users | news.notified_watchers

    MultiMessage.new(:news_comment_added, comment).for(users)

  end

  # Builds a Mail::Message object used to email the current user that the

  # specified message was posted.

    mail :to => User.current,

  # Build a MultiMessage to notify users about a new forum message

  #

  # Example:

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

  def self.message_posted(message)

    users  = message.notified_users

    users |= message.root.notified_watchers

    users |= message.board.notified_watchers

    MultiMessage.new(:message_posted, message).for(users)

  end

  # Builds a Mail::Message object used to email the current user that the

  # specified wiki content was added.

    mail :to => User.current,

  # Build a MultiMessage to notify users about added wiki content

  #

  # Example:

  #   Mailer.wiki_content_added(wiki_content).deliver => send emails to the project's recipients

  def self.wiki_content_added(wiki_content)

    users = wiki_content.notified_users | wiki_content.page.wiki.notified_watchers

    MultiMessage.new(:wiki_content_added, wiki_content).for(users)

  end

  # Builds a Mail::Message object used to email the current user about an update

  # of the specified wiki content.

    mail :to => User.current,

  # Build a MultiMessage to notify users about the update of the specified wiki content

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

  def self.wiki_content_updated(wiki_content)

    users  = wiki_content.notified_users

    users |= wiki_content.page.notified_watchers

    users |= wiki_content.page.wiki.notified_watchers

    MultiMessage.new(:wiki_content_updated, wiki_content).for(users)

  end

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

  #

  # Example:

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

  def account_information(password)

    @user = User.current

    mail :to => User.current.mail,

  # Build a MultiMessage to mail a user their account information

  #

  # Example:

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

  def self.account_information(user, password)

    MultiMessage.new(:account_information, password).for(user)

  end

  # Builds a Mail::Message object used to email the current user about an account activation request.

    mail :to => User.current,

  # Build a MultiMessage to email all active administrators of an account activation request.

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

  def self.account_activation_request(user)

    # Send the email to all active administrators

    users = User.active.where(:admin => true)

    MultiMessage.new(:account_activation_request, user).for(users)

  end

  # Builds a Mail::Message object used to email the account of the current user

  # was activated by an administrator.

  #

  # Example:

  #   account_activated => Mail::Message object

  def account_activated

    @user = User.current

    mail :to => User.current.mail,

  # Build a MultiMessage to email the specified user that their account was

  # activated by an administrator.

  #

  # Example:

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

  def self.account_activated(user)

    MultiMessage.new(:account_activated).for(user)

  end

  # Builds a Mail::Message object used to email the lost password token to the

  # token's user (or a different recipient).

  #

  # Example:

  #   lost_password(token) => Mail::Message object

  # Build a MultiMessage to email the token's user (or a different recipient)

  # the lost password token for the token's user.

  #

  # Example:

  #   Mailer.lost_password(token).deliver => sends an email to the user

  def self.lost_password(token, recipient=nil)

    MultiMessage.new(:lost_password, token, recipient).for(token.user)

  end

  # Builds a Mail::Message object used to email the user activation link to the

  # token's user.

  #

  # Example:

  #   register(token) => Mail::Message object

  # Build a MultiMessage to email the user activation link to the token's user.

  #

  # Example:

  #   Mailer.register(token).deliver => sends an email to the token's user

  def self.register(token)

    MultiMessage.new(:register, token).for(token.user)

  end

  # Build a Mail::Message object to email the current user and the additional

  # recipients given in options[:recipients] about a security related event.

  #

  # Example:

  #   security_notification(users,

  #     message: :mail_body_security_notification_add,

  #     field: :field_mail,

  #     value: address

  #   ) => Mail::Message object

  def security_notification(sender, options={})

    @sender = sender

    redmine_headers 'Sender' => sender.login

    @user = User.current

    mail :to => [User.current, *options[:recipients]].uniq,

  # Build a MultiMessage to email the given users about a security related event.

  #

  # You can specify additional recipients in options[:recipients]. These will be

  # added to all generated mails for all given users. Usually, you'll want to

  # give only a single user when setting the additional recipients.

  #

  # Example:

  #   Mailer.security_notification(users,

  #     message: :mail_body_security_notification_add,

  #     field: :field_mail,

  #     value: address

  #   ).deliver => sends a security notification to the given user(s)

  def self.security_notification(users, options={})

    sender = User.current

    MultiMessage.new(:security_notification, sender, options).for(users)

  end

  # Build a Mail::Message object to email the current user about an updated

  # setting.

  #

  # Example:

  #   settings_updated(sender, [:host_name]) => Mail::Message object

  def settings_updated(sender, changes)

    @sender = sender

    redmine_headers 'Sender' => sender.login

    mail :to => User.current,

  # Build a MultiMessage to email the given users about an update of a setting.

  #

  # Example:

  #   Mailer.settings_updated(users, [:host_name]).deliver => sends emails to the given user(s) about the update

  def self.settings_updated(users, changes)

    sender = User.current

    MultiMessage.new(:settings_updated, sender, changes).for(users)

  end

  # Build a Mail::Message object with a test email for the current user

  #

  # Example:

  #   test_email => Mail::Message object

  def test_email

    mail :to => User.current.mail,

  # Build a MultiMessage to send a test email the given user

  #

  # Example:

  #   Mailer.test_email(user).deliver => send an email to the given user

  def self.test_email(user)

    MultiMessage.new(:test_email).for(user)

  end

    if block_given?

    elsif action_methods.include?(method.to_s)

      MultiMessage.new(method, *args).for(User.current)

<p><%= l(:field_user) %>: <strong><%= @sender.login %></strong><br/>

<%= l(:field_remote_ip) %>: <strong><%= @sender.remote_ip %></strong><br/>

<%= l(:label_date) %>: <strong><%= format_time Time.now, true %></strong></p>

<%= l(:field_user) %>: <%= @sender.login %>

<%= l(:field_remote_ip) %>: <%= @sender.remote_ip %>

<%= l(:label_date) %>: <%= format_time Time.now, true %>

<p><%= l(:field_user) %>: <strong><%= @sender.login %></strong><br/>

<%= l(:field_remote_ip) %>: <strong><%= @sender.remote_ip %></strong><br/>

<%= l(:field_user) %>: <%= @sender.login %>

<%= l(:field_remote_ip) %>: <%= @sender.remote_ip %>

    assert_equal 2, ActionMailer::Base.deliveries.size

      assert_equal 2, ActionMailer::Base.deliveries.size

      assert_equal 2, ActionMailer::Base.deliveries.size

          '2' => ''}

  def test_bulk_update_should_send_a_notification

      assert_equal 5, ActionMailer::Base.deliveries.size

    assert_equal users_to_test.keys.size, ActionMailer::Base.deliveries.size

    assert_equal users_to_test.keys.size, ActionMailer::Base.deliveries.size

    mails = ActionMailer::Base.deliveries

    assert_not_empty mails

    mails.each do |mail|

      assert_equal "[#{message.board.project.name} - #{message.board.name} - msg#{message.root.id}] Test created message", mail.subject

      assert_mail_body_match 'Message body', mail

    end

    assert_equal ['jsmith@somenet.foo'], mails[0].bcc

    assert_equal ['dlopper@somenet.foo'], mails[1].bcc

    assert_equal 2, ActionMailer::Base.deliveries.size

    assert_equal 2, ActionMailer::Base.deliveries.size

      assert_difference 'ActionMailer::Base.deliveries.size', 2 do

    assert_equal 2, ActionMailer::Base.deliveries.size

      assert_equal 2, ActionMailer::Base.deliveries.size

      assert_equal 2, ActionMailer::Base.deliveries.size

      assert_equal 2, ActionMailer::Base.deliveries.size

    assert_equal 2, ActionMailer::Base.deliveries.size

    assert_equal 2, ActionMailer::Base.deliveries.size

    assert_equal 2, ActionMailer::Base.deliveries.size

    assert_equal 2, ActionMailer::Base.deliveries.size

    assert_equal 2, ActionMailer::Base.deliveries.size

    assert_equal 2, ActionMailer::Base.deliveries.size

    # only 2 emails for the new issue notification

    assert_equal 2, ActionMailer::Base.deliveries.size

    ActionMailer::Base.deliveries.each do |email|

      assert_include 'Ticket by unknown user', email.subject

    end

    assert_equal 3, ActionMailer::Base.deliveries.size

    assert_difference 'ActionMailer::Base.deliveries.size', 2 do

      Mailer.deliver_issue_edit(journal)

    end

    assert_equal %w(dlopper@somenet.foo jsmith@somenet.foo), ActionMailer::Base.deliveries.last(2).flat_map(&:bcc).sort

    assert_difference 'ActionMailer::Base.deliveries.size', 1 do

      Mailer.deliver_issue_edit(journal)

    end

      assert_difference 'ActionMailer::Base.deliveries.size', 2 do

      assert_difference 'ActionMailer::Base.deliveries.size', 2 do

    assert_equal 2, ActionMailer::Base.deliveries.size

    # 5 email notifications, 2 for #1, 3 for #2

    assert_equal 5, ActionMailer::Base.deliveries.size

    ActionMailer::Base.deliveries.first(2).each do |mail|

      assert_not_nil mail

      assert mail.subject.starts_with?(

          "[#{fixed_issue.project.name} - #{fixed_issue.tracker.name} ##{fixed_issue.id}]")

      assert_mail_body_match(

          "Status changed from #{old_status} to #{fixed_issue.status}", mail)

    end

    assert_equal 2, ActionMailer::Base.deliveries.size

    ActionMailer::Base.deliveries.each do |mail|

      assert_include 'wiki page has been added', mail_body(mail)

    end

    assert_equal 2, ActionMailer::Base.deliveries.size

    ActionMailer::Base.deliveries.each do |mail|

      assert_include 'wiki page has been updated', mail_body(mail)

    end