Emails
Kirby has a built-in email engine, which can be used to send notifications to your users, replies to filled in contact forms and more.
Simple
try {
$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',
]);
} catch (Exception $error) {
echo $error;
}
// errors will be thrown as Exceptions. If you want to notice/output
// errors, always use try-catchSince 3.3.2
With custom name
$from = new \Kirby\Cms\User([
'email' => 'e@mail.com',
'name' => 'Vorname Nachname',
]);
try {
$kirby->email([
'from' => $from,
'to' => 'someone@example.com',
'subject' => 'Welcome!',
'body'=> 'It\'s great to have you with us',
]);
} catch (Exception $error) {
echo $error;
}With multiple recipients:
$kirby->email([
'from' => 'welcome@supercompany.com',
'to' => [
'someone@gmail.com',
'numbertwo@gmail.com'
],
'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' => 'peter@lustig.de',
'template' => 'my-email',
'data' => [
'num' => '2'
]
]);Welcome to Newsletter No. <?= $num ?>!HTML & Plain Text
<h1>Hi <?= $name ?></h1>
<p><?= $text ?></p>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;
}
}Welcome, <?= $user->name() ?>!
Great to have you with us since <?= $user->yearJoinedCompany() ?>.Sending Email with attachments
$kirby->email([
'from' => 'welcome@supercompany.com',
'to' => 'someone@gmail.com',
'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' => 'welcome@supercompany.com',
'to' => 'someone@gmail.com',
'subject' => 'Welcome!',
'body' => 'We will never reply',
])->isSent();Setting plain text and html body
kirby()->email([
'from' => 'welcome@supercompany.com',
'to' => 'someone@gmail.com',
'subject' => 'Welcome!',
'body' => [
'html' => Html::a('https://getkirby.com'),
'text' => 'https://getkirby.com',
],
]);Email presets
return [
'email' => [
'presets' => [
'contact' => [
'from' => 'no-reply@supercompany.com',
'subject' => 'Thank you for your contact request',
'cc' => 'marketing@supercompany.com',
'body' => 'We will never reply'
]
]
]
];$kirby->email('contact', [
'to' => 'peter@lustig.de'
]);Transport configuration
return [
'email' => [
'transport' => [
'type' => 'smtp',
'host' => 'smtp.company.com',
'port' => 465,
'security' => true
]
]
];Since 3.5.1
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
return [
'email' => [
'transport' => [
'type' => 'smtp',
'host' => 'smtp.server.com',
'port' => 465,
'security' => true,
'auth' => true,
'username' => '...',
'password' => '...',
]
]
];Access PHPMailer instance
Since 3.4.1
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;
}
]);