Mail::Sender::Easy 0.0.5

Mail::Sender is a great module. I have great respect for Jenda as you can tell from the list archives :)<br /><br />Mail::Sender's one problem is its a bit cumbersome to use, with so many options and things to open, close, the whole thing, parts, multiparts etc etc., and several ways to check for successs. Its hard to remember what needs done at what point with what data to do what you want and then which way you check what data based on what was done to see if it worked or not.<br /><br />This module's aim is to make all of that ``Easy'', Simple, User Friendly, etc etc (see "DISCUSSION OF THE NAMESPACE" below)<br /><br />It does so by providing a single function (and method) to send mail based on an (IMHO) easier to work with hashref and returns true or false on success or failer and sets $@ to any errors.<br /><br />The EXAMPLE section shows an ``email or die'' that will send an email using SMTP Auth on port 26 with text and html parts, the html part has a smiley gif embedded inline and a PDF attached and a high priority flag and read and delivery receipt requests. It will take you seconds to customize it to send that to yourself (and its ``Easy'' to understand what its going on without having to understand the intracacies of SMTP and MIME messages. Now try it with plain the Mail::Sender manpage. See? Much much ``Easy''ier to do, understand, troubelshoot, maintain, etc etc :)<br /><br />Also adds more detailed info to the X-Mailer header to track usage.<br />Function: email()<br /><br /> email(%email) or die "Email error: $@";<br /><br /> if(email(%email)) {<br /> log_sent_emails(%email);<br /> print "Your email has been sent!n";<br /> }<br /> else {<br /> log_failed_email($@, %email);<br /> print "Sorry, I could not send your email!n";<br /> }<br /><br />Method: $sender->easy()<br /><br />Same hashref as email() but called with a Mail::Sender object you created previously:<br /><br />my $sender = Mail::Sender->new();<br /><br />$sender->easy(%email) or die "Email error: $@";<br />%email<br /><br />The keys to this hash are the keys described in Mail::Sender's docs in the "Parameters" Section with the addition of 3 new ones:<br />_text<br /><br />The value is the text/plain part of the message, its the only required one.<br />_html<br /><br />The value is the text/html part of the message, it is not required.<br />_text_info<br /><br />Value is a hashref of additonal args to Mail::Sender->Part() for text in text and html emails, Mail::Sender->Body() in text with attachement. ctype, disposition, msg are ignored since they are set by other means.<br /><br />The perfect place to set 'encoding' and 'charset'<br />_html_info<br /><br />Value is a hashref of additonal args to Mail::Sender->Part() for html. ctype, disposition, msg are ignored since they are set by other means.<br /><br />The perfect place to set 'encoding' and 'charset'<br />_attachments<br /><br />Encoding of attachments is always Base64. The value of this key is a hash reference.<br /><br />In that hashref each key is a filename, not the entire path, just the filename, to be attached. The value is another hashref described below. (Don't panic, its not as complex as it sounds at this point, see the EXAMPLE to see what I mean.)<br />_attachments => { 'file.name' => { this hash is described here }, }<br /><br />You *must* specify the "file" key or the "msg" key, the "msg" key takes precedence.<br /><br />The keys are:<br /><br />file<br /><br /> Path to the file to attach.<br /><br /> 'file' => '/home/foo/docs/fiddle.txt',<br /><br /> Makes the attachment via Mail::Sender::Attach()<br />msg<br /><br /> Contents of the file (instead of using a path)<br /><br /> 'msg' => $fiddle_txt_content,<br /><br /> Makes the attachment via Mail::Sender::Part()<br />ctype<br /><br /> Content type of the attachement<br /><br /> 'ctype' => 'image/png',<br /><br /> Mail::Sender will guess if not specified but its a good idea to specify it.<br /><br /> Defaults to text/plain<br />description<br /><br /> Short textual description or title of this file:<br /><br /> 'description' => 'Fiddle Info',<br /><br /> Defaults to the filename you used for this hashref's key (IE "file.name" from the "this hash described here" header).<br />_disptype<br /><br /> Short textual description of the type of file:<br /><br /> '_disptype' => 'Text Document',<br /><br /> Defaults to the filename you used for this hashref's key (IE "file.name" from the "this hash described here" header).<br />_inline<br /><br /> The value is used as its "cid" and makes it attached inline<br /><br /> '_inline' => 'fiddlepic1',<br /><br /> in the html section:<br /><br /> <img src="cid:fiddlepic1" /><br /><br /> If not specified its not "inline", its just attached :)<br /><br />The _disptype and _inline are used to build the actual "dispositon" part which is described in Mial::Sender's docs if you want to know the nitty gritty.

Requirements:	No special requirements
Platforms:	*nix, Linux
Keyword:	Attached,  Attachment,  Defaults,  Description,  Email,  Filename,  Hashref,  Mailsender,  Makes,  Quotemail,  Quotfilenamequot,  Quotthis,  Section,  Short,  Textual,  Understand
Users rating:	0/10