Emails

Simple

try {
  $kirby->email([
    'from' => '[email protected]',
    'replyTo' => '[email protected]',
    'to' => '[email protected]',
    'cc' => '[email protected]',
    'bcc' => '[email protected]',
    'subject' => 'Welcome!',
    'body'=> 'It\'s great to have you with us',
  ]);
} catch (Exception $error) {
  echo $error;
}

// errors will be thrown as Exceptions. If you want to notice/output
// errors, always use try-catch

With custom name

$from = new \Kirby\Cms\User([
  'email' => '[email protected]',
  'name' => 'Vorname Nachname',
]);

try {
  $kirby->email([
    'from' => $from,
    'to' => '[email protected]',
    'subject' => 'Welcome!',
    'body'=> 'It\'s great to have you with us',
  ]);
} catch (Exception $error) {
  echo $error;
}

With multiple recipients:

$kirby->email([
  'from' => '[email protected]',
  'to' => [
    '[email protected]',
    '[email protected]'
  ],
  'subject' => 'Welcome!',
  'body'=> 'It\'s great to have you with us',
]);

// or with a collection of users
$kirby->email([
  'to' => $kirby->users()->filterBy('role', 'newbies'),
  …
]);

Plain Text

$kirby->email([
  'to' => '[email protected]',
  'template' => 'my-email',
  'data' => [
    'num' => '2'
  ]
]);

/site/templates/emails/my-email.php

Welcome to Newsletter No. <?= $num ?>!

HTML & Plain Text

/site/templates/emails/media.html.php

<h1>Hi <?= $name ?></h1>
<p><?= $text ?></p>

in site/templates/emails/media.text.php

Hi <?= $name ?>,

<?= $text ?>

$kirby->email([
  'template' => 'media',
  'data' => [
    'name' => 'Peter',
    'text' => 'welcome to our wonderful email list'
  ]
]);

Personalized emails to multiple users

foreach ($users as $user) {
  try {
    $kirby->email('management', [
      'to' => $user,
      'template' => 'user-specific',
      'data' => [
        'user' => $user
      ]
    ]);
  } catch (Exception $error) {
    echo $error;
  }
}

/site/templates/emails/user-specific.php

Welcome, <?= $user->name() ?>!
Great to have you with us since <?= $user->yearJoinedCompany() ?>.

Sending Email with attachments

$kirby->email([
  'from' => '[email protected]',
  'to' => '[email protected]',
  'subject' => 'Welcome!',
  'body' => 'Here are some attachments',
  'attachments' => [
    $page->file('somefile.jpg'),
    $page->file('someotherfile.jpg')
  ]
]);

Check if email is sent successfully

$success = kirby()->email([
    'from'    => '[email protected]',
    'to'      => '[email protected]',
    'subject' => 'Welcome!',
    'body'    => 'We will never reply',
])->isSent();

Setting plain text and html body

kirby()->email([
  'from'    => '[email protected]',
  'to'      => '[email protected]',
  'subject' => 'Welcome!',
  'body' => [
      'html' => Html::a('https://getkirby.com'),
      'text' => 'https://getkirby.com',
  ],
]);

Email presets

/site/config/config.php

return [
  'email' => [
    'presets' => [
      'contact' => [
        'from'    => '[email protected]',
        'subject' => 'Thank you for your contact request',
        'cc'      => '[email protected]',
        'body'    => 'We will never reply'
      ]
    ]
  ]
];

$kirby->email('contact', [
  'to' => '[email protected]'
]);

Transport configuration

/site/config/config.php

return [
  'email' => [
    'transport' => [
      'type' => 'smtp',
      'host' => 'smtp.company.com',
      'port' => 465,
      'security' => true
    ]
  ]
];

If security is set to true, Kirby automatically converts it to 'tls' or 'ssl' depending on the configured port. If no port is given and secure transport is enabled, the port is set to 587 (the common port for SMTP over TLS). You can also use 'tls' or 'ssl' explicitly via the security key.

With authentication

/site/config/config.php

return [
  'email' => [
    'transport' => [
      'type' => 'smtp',
      'host' => 'smtp.server.com',
      'port' => 465,
      'security' => true,
      'auth' => true,
      'username' => '...',
      'password' => '...',
    ]
  ]
];

Access PHPMailer instance

You can get access to the underlying PHPMailer instance via the beforeSend callback:

$kirby->email([
    // …
    'beforeSend' => function ($mailer) {
        $mailer->SMTPOptions = [
            'ssl' => [
                'verify_peer' => false,
                'verify_peer_name' => false,
                'allow_self_signed' => true
            ]
        ];

        return $mailer;
    }
]);

The beforeSend callback can also be added as preset.