Merge pull request #217 from maartenvanvliet/issues/bamboo_mailer

Add bamboo mailer guide

Author: danschultzer

README.md

@@ -239,7 +239,7 @@ config :my_app, :pow,
   mailer_backend: MyAppWeb.PowMailer
 ```
 
-This mailer module will only output the mail to your log, so you can e.g. try out the reset password and email confirmation links. You should integrate the Pow mailer with your actual mailer system. For Swoosh integration, check out the [Swoosh mailer guide](guides/swoosh_mailer.md).
+This mailer module will only output the mail to your log, so you can e.g. try out the reset password and email confirmation links. You should integrate the Pow mailer with your actual mailer system. For Swoosh or Bamboo integration, check out the [Configuring mailer guide](guides/configuring_mailer.md).
 
 #### Modify mailer templates
 

guides/configuring_mailer.md

@@ -0,0 +1,80 @@
+# Configuring mailer
+
+You are able to configure a mailer for Pow and set it up with the library of 
+your choice.
+
+This guide shows how to setup Pow with
+
+ * [Swoosh](https://github.com/swoosh/swoosh)
+ * [Bamboo](https://github.com/thoughtbot/bamboo)
+
+You must first setup and configure either of these libraries before you can
+integrate them with Pow.
+
+## Swoosh mailer
+
+Set up your `WEB_PATH/pow_mailer.ex` file like so:
+
+```elixir
+defmodule MyAppWeb.PowMailer do
+  use Pow.Phoenix.Mailer
+  use Swoosh.Mailer, otp_app: :my_app
+
+  import Swoosh.Email
+  
+  require Logger
+
+  def cast(%{user: user, subject: subject, text: text, html: html}) do
+    %Swoosh.Email{}
+    |> to({"", user.email})
+    |> from({"My App", "[email protected]"})
+    |> subject(subject)
+    |> html_body(html)
+    |> text_body(text)
+  end
+
+  def process(email) do
+    email
+    |> deliver()
+    |> log_warnings()
+  end
+
+  defp log_warnings({:error, reason}) do
+    Logger.warn("Mailer backend failed with: #{inspect(reason)}")
+  end
+
+  defp log_warnings({:ok, response}), do: {:ok, response}
+end
+```
+
+Remember to add `mailer_backend: MyAppWeb.PowMailer` to the Pow configuration.
+
+## Bamboo mailer
+
+Set up your `WEB_PATH/pow_mailer.ex` file like so:
+
+```elixir
+defmodule MyAppWeb.PowMailer do
+  use Pow.Phoenix.Mailer
+  use Bamboo.Mailer, otp_app: :my_app
+
+  import Bamboo.Email
+  
+  require Logger
+
+  def cast(%{user: user, subject: subject, text: text, html: html}) do
+    new_email
+    |> to(user.email)
+    |> from("[email protected]")
+    |> subject(subject)
+    |> html_body(html)
+    |> text_body(text)
+  end
+
+  def process(email) do
+    deliver_now(email)
+  end
+end
+```
+
+Remember to add `mailer_backend: MyAppWeb.PowMailer` to the Pow configuration.

guides/swoosh_mailer.md

@@ -76,7 +76,7 @@ defmodule Pow.MixProject do
         "CONTRIBUTING.md": [filename: "CONTRIBUTING"],
         "CHANGELOG.md": [filename: "CHANGELOG"],
         "guides/coherence_migration.md": [],
-        "guides/swoosh_mailer.md": [],
+        "guides/configuring_mailer.md": [],
         "guides/why_pow.md": [],
         "guides/user_roles.md": [],
         "guides/lock_users.md": [],