CAM::EmailTemplate::SMTP - Net::SMTP based email message sender


LICENSE

Copyright 2005 Clotho Advanced Media, Inc., <[email protected]>

This library is free software; you can redistribute it and/or modify it
under the same terms as Perl itself.


ABOUT CLOTHO

"CAM" stands for Clotho Advanced Media Inc. (www.clotho.com) which
developed this module.  Contact us at [email protected].


INSTALLATION

Install via one of the following:
 perl Makefile.PL
 make
 make test
 make install

or

 perl Build.PL
 perl Build
 perl Build test
 perl Build install

To get the full effect of testing, please specify a recipient email
address and mailhost:
 setenv RECIPIENT [email protected]
 setenv MAILHOST mail.foo.com

To take advantage of Net::SMTP's debugging capabilities, use this:
 setenv SMTPTemplate_Debug 1


DESCRIPTION

This module alters the CAM::EmailTemplate mail delivery mechanism to
use raw SMTP delivery (via Net::SMTP) instead of relying on the
sendmail binary program.  This module is useful for machines which are
not configured to do their own mail delivery.  Instead, the programmer
or user specifies a mail server to use as the delivery agent.

This module most closely resembles Mail::Send with the smtp
option.  It has the following advantages:

 * Integration of templating
 * Ability to manually customize the presentation of the mail headers
   (this is the reason why I use Net::SMTP instead of Mail::Send on
   the back end -- Mail::Mailer::rfc822 hardcodes too much)

and the following disadvantages:

 * Only supports SMTP delivery (but see also CAM::EmailTemplate)
 * Doesn't offer an easy-to-understand API for building the header
 * Fewer mail delivery options

This module can be extended to use alternate templating syntax just
like CAM::EmailTemplate.  See the example in the README for that
module, and just append "::SMTP" to all instances of
"CAM::EmailTemplate".