README

Email+ for Kirby

Kirby has a built-in email engine with support for mail and smtp transports. However, sometimes you may need more support for other email services like Mailgun or Resend. Kirby Email+ extends Kirby's email capabilities by adding support for multiple email services using the same Kirby email API.

Overview

• 1. Installation
• 2. Usage
• 3. Options
• 4. License
• 5. Credits

Installation

Right now, Email+ supports two additional email transports: mailgun and resend.

Mailgun installation

To use Mailgun as your email transport, you need to run the following command to install the required packages:

composer require beebmx/kirby-email-plus mailgun/mailgun-php symfony/http-client nyholm/psr7

Resend installation

To use Resend as your email transport, you need to run the following command to install the required packages:

composer require beebmx/kirby-email-plus resend/resend-php

Usage

With Kirby Email+ you can choose between the built-in Kirby email transports (mail and smtp) and the new ones added by this plugin (mailgun and resend).

First you need to configure the email transport you want to use in your config.php file:

return [
    'beebmx.email-plus' => [
        'type' => 'resend',
        'resend.key' => 're_XXXXXXXXXXXXXXXX',
    ],
];

Then, you can send emails using the Kirby email API as usual:

$kirby->email([
    'from'    => 'welcome@supercompany.com',
    'replyTo' => 'no-reply@supercompany.com',
    'to'      => 'someone@gmail.com',
    'cc'      => 'anotherone@gmail.com',
    'bcc'     => 'secret@gmail.com',
    'subject' => 'Welcome!',
    'body'    => 'It\'s great to have you with us',
  ]);

For convinience, you can also set the type directly in the transport configuration:

return [
    'email' => [
        'transport' => [
            'type' => 'resend',
        ],
    ],
    'beebmx.email-plus.resend.key' => 're_XXXXXXXXXXXXXXXX',
];

Options

Here's an example of a full use of the options from the config.php file:

return [
  'beebmx.email-plus' => [
      'type' => 'resend', // mailgun or resend
      'mailgun' => [
          'domain' => 'example.com',
          'endpoint' => 'https://api.mailgun.net',
          'key' => 'key-XXXXXXXXXXXXXXXX',
      ],
      'resend' => [
          'key' => 're_XXXXXXXXXXXXXXXX',
      ],
  ],
];

License

Licensed under the MIT.

Credits

• Fernando Gutierrez @beebmx
• All Contributors