# Shield.Notifier

Shield Notifier is an external package for Shield package notifications. Currently, it only supports email with text based confirmation and password recovery email templates using Bamboo.

## Installation

If [available in Hex](https://hex.pm/docs/publish), the package can be installed as:

  1. Add `shield_notifier` to your list of dependencies in `mix.exs`:

    ```elixir
    def deps do
      [{:shield_notifier, "~> 0.1.0"}]
    end
    ```

  2. Ensure `shield_notifier` is started before your application:

    ```elixir
    def application do
      [applications: [:shield_notifier]]
    end
    ```

  3. Add the following lines to your config:

    ```elixir
    config :shield_notifier,
      channels: %{
        email: %{
          from: {
            System.get_env("APP_NAME") || "Shield Notifier",
            System.get_env("APP_FROM_EMAIL") || "no-reply@localhost"}
        }
      }
    ```
  4. Add your favorite Bamboo adapter config for prod env as below

    ```elixir
    config :shield_notifier, Shield.Notifier.Mailer,
      adapter: Bamboo.SendgridAdapter,
      api_key: SYSTEM.get_env("SENDGRID_API_KEY")
    ```

## Usage

### Email Channel

To send confirmation email:

    ```elixir
    Shield.Notifier.Channel.Email.deliver(
      ["recipient@example.com"],
      :confirmation,
      %{identity: "Recipient", confirmation_url: "https://xyz.com/con?t=1234"}
    )
    ```

To send password recovery email:

    ```elixir
    Shield.Notifier.Channel.Email.deliver(
      ["recipient@example.com"],
      :recover_password,
      %{identity: "Recipient", recover_password_url: "https://xyz.com/rec?t=1op2"}
    )
    ```

### Channel Implementation

You may create your own channels using Shield.Notifier.Channel behaviour. All you need to implement a deliver function.

## Contributing

### Issues, Bugs, Documentation, Enhancements

  1. Fork the project

  2. Make your improvements and write your tests.

  3. Document what you did/change.

  4. Make a pull request.


## Todo

  - [ ] HTML email templates.