Wie man E-Mails in TYPO3 10 versendet

Der E-Mailversand ist ein altes aber immer noch zentrales Thema in der Webentwicklung. TYPO3 bietet mit dem Swift Mailer ein einfaches Framework mit.

Copy & Paste Vorlagen

Einfaches Beispiel

$mail = \TYPO3\CMS\Core\Utility\GeneralUtility::makeInstance(\TYPO3\CMS\Core\Mail\MailMessage::class);
$mail->setFrom(array($email => $name))
     ->setTo(array($email => $name))
     ->setSubject($subject)
     ->setBody($body)
     ->send();

Mit Dateianhängen

$mail = \TYPO3\CMS\Core\Utility\GeneralUtility::makeInstance(\TYPO3\CMS\Core\Mail\MailMessage::class);
$mail->setFrom(array($email => $name))
     ->setTo(array($email => $name))
     ->setSubject($subject)
     ->setBody($body);

foreach($attachments as $attachment)
{
    $attachment = \Swift_Attachment::fromPath('/path/to/image.jpg', 'image/jpeg');
    $attachment->setFilename('example.jpg');
    $mail->attach($attachment);
}

$mail->send();

E-Mail als HTML Template

use Symfony\Component\Mime\Address;
use TYPO3\CMS\Core\Mail\FluidEmail;
use TYPO3\CMS\Core\Mail\Mailer;
use TYPO3\CMS\Core\Utility\GeneralUtility;

$mail = GeneralUtility::makeInstance(FluidEmail::class);
$mail->to('max@mustermann.de')
     ->from(new Address('campus@slavlee.de', 'Slavlee'))
     ->subject($subject)
     ->format('both') // send HTML and plaintext mail
     ->setTemplate('Example')
     ->assign('exampleVar1', 'Example value');
GeneralUtility::makeInstance(Mailer::class)->send($email);

Registrierung der Templateordner

$GLOBALS['TYPO3_CONF_VARS']['MAIL']['templateRootPaths'][] = 'EXT:example/Resources/Private/Templates/Email';
$GLOBALS['TYPO3_CONF_VARS']['MAIL']['layoutRootPaths'][] = 'EXT:example/Resources/Private/Layouts';

Erläuterungen

Ich denke das meiste ist relativ einfach und straight forward. Das letzte Beispiel bedarf es vielleicht ein paar Erläuterungen. 

Sobald man eine HTML E-Mail verschicken möchte, ist es sinnvoll das in Fluid umzusetzen. In TYPO3 10 wurde dieser Teil umgearbeitet und es ist nicht mehr notwendig die StandaloneView zu nutzen. Man registriert nun am besten mittels AdditonalConfiguration.php innerhalb des typo3conf - Ordners die Templateordner für seine E-Mail Templates. Die neue Klasse: FluidEmail findet diese dann anhand des Namens. Wichtig hier, das man einen eindeutigen Namen wählt, da ansonsten es möglich ist, andere Templatedateien von anderen Extensions mit dem gleichen Namen zu erwischen.