Sets up mailers that make it easy to configure and swap adapters.

Adds deliver_now/1 and deliver_later/1 functions to the mailer module it is used by.

Bamboo ships with the following adapters

• Bamboo.MandrillAdapter
• Bamboo.LocalAdapter
• Bamboo.TestAdapter
• or create your own with Bamboo.Adapter

Example

# In your config/config.exs file
config :my_app, MyApp.Mailer,
  adapter: Bamboo.MandrillAdapter,
  api_key: "my_api_key"

# Somewhere in your application. Maybe lib/my_app/mailer.ex
defmodule MyApp.Mailer do
  # Adds deliver_now/1 and deliver_later/1
  use Bamboo.Mailer, otp_app: :my_app
end

# Set up your emails
defmodule MyApp.Email do
  import Bamboo.Email

  def welcome_email do
    new_mail(
      to: "foo@example.com",
      from: "me@example.com",
      subject: "Welcome!!!",
      html_body: "<strong>WELCOME</strong>",
      text_body: "WELCOME"
    )
  end
end

# In a Phoenix controller or some other module
defmodule MyApp.Foo do
  alias MyApp.Email
  alias MyApp.Mailer

  def register_user do
    # Create a user and whatever else is needed
    # Could also have called Mailer.deliver_later
    Email.welcome_email |> Mailer.deliver_now
  end
end