I've had the need to create "draft" emails pre-filled with content/attachments. User's can then download these as a.eml, open with their email client, manipulate, then send. Thought I'd share my solution to see if this is something that would be acceptable in core.

Only needed a few minor adjustments toEmail that I wrapped up into anDraftEmail object:

AddX-Unsent: 1 header (this marks the email as "draft" for clients that support this)
Allow no From/To (user can add with their client)
Remove Message-ID/Date headers (these will be added by the client)

Usage:

$content = (newDraftEmail()    ->html($twig->render(...))    ->attach(...)    ->toString();$response =newResponse($message->toString());$contentDisposition =$response->headers->makeDisposition(    ResponseHeaderBag::DISPOSITION_ATTACHMENT,'download.eml');$response->headers->set('Content-Type','message/rfc822');$response->headers->set('Content-Disposition',$contentDisposition);

carsonbot added Status: Needs Review Feature Mime labels

Nov 27, 2021

carsonbot added this to the6.0 milestone

Nov 27, 2021

kbond commented

Nov 27, 2021

View reviewed changes

src/Symfony/Component/Mime/Email.phpShow resolvedHide resolved

kbond commented

Nov 27, 2021

View reviewed changes

src/Symfony/Component/Mime/UnsentEmail.php OutdatedShow resolvedHide resolved

kbond force-pushed theunsent-email branch 2 times, most recently fromdfff60d to9da47c6Compare

November 27, 2021 20:01

kbond changed the title~~[Mime] add UnsentEmail~~[Mime] add DraftEmail

Nov 27, 2021

kbond force-pushed theunsent-email branch from9da47c6 tocb167d7Compare

November 27, 2021 20:03

Copy link

MemberAuthor

kbond commentedNov 27, 2021•
edited
Loading

Some details onX-Unsent header client support:

Virtually all versions of Outlook (desktop clients at least) support
Appears some versions of Apple Mail support with theX-Uniform-Type-Identifier: com.apple.mail-draft header (maybe worth adding). For versions that don't, it looks like there isan option to switch viewing a .eml to draft
Looks like Thunderbird 91+ supports natively and there is an addon forprevious versions

kbond force-pushed theunsent-email branch fromcb167d7 todca9234Compare

November 27, 2021 20:13

kbond modified the milestones:6.0,6.1

Nov 27, 2021

Copy link

Member

fabpot commentedDec 20, 2021

@kbond Can you rebase on 6.1? Is it ready?

Copy link

Member

stof commentedDec 20, 2021

the point brought by@kbond in#44311 (comment) is not resolved yet: how should the mailer component behave if being asked to send a DraftEmail object ?

kbond force-pushed theunsent-email branch fromdca9234 to35e4788Compare

December 20, 2021 16:30

kbond requested review fromOskarStark,chalasr,dunglas,jderusse,lyrixx,wouterj,xabbuh andyceruto ascode owners

December 20, 2021 16:30

kbond changed the base branch from6.0 to6.1

December 20, 2021 16:30

Copy link

MemberAuthor

kbond commentedDec 20, 2021•
edited
Loading

Rebased. Two remaining things:

[Mime] add DraftEmail #44311 (comment)
[Mime] add DraftEmail #44311 (comment) (addingX-Uniform-Type-Identifier: com.apple.mail-draft for Apple Mail)

kbond commented

Dec 20, 2021

View reviewed changes

src/Symfony/Component/Mailer/Mailer.php OutdatedShow resolvedHide resolved

Copy link

MemberAuthor

kbond commentedDec 20, 2021•
edited
Loading

To@GromNaN's original question. Mypersonal use-case for settingX-Unsent in an email is removed onceDraftEmail exists. Should I remove the check for this header inEmail andMailer? Then inMailer, we'd throw an exception if$message instanceof DraftEmail.

Otherwise having code in the parent class for the behavior of a child class sounds a bad design.

I agree completely if we were calling a method on the child from the parent. This is a "generic" header that can be added to anyMessage. (I don't feel strongly one way or the other)