CAM::EmailTemplate - Template-based email message sender
LICENSE
Copyright 2005 Clotho Advanced Media, Inc., <cpan@clotho.com>
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 info@clotho.com.
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
DESCRIPTION
This module extends the CAM::Template search-and-replace API to with a
send() method to enable simplified delivery of automated but
customized emails. This module is NOT intended for spam delivery (and
it's definitely not very efficient for that purpose).
See the documentation for templating examples.
This module most closely resembles Mail::Send with the sendmail
option. It has the following advantages:
* Integration of templating
* More readable code (IMHO)
and the following disadvantages:
* Only supports sendmail delivery (but see also
CAM::EmailTemplate::SMTP)
* Doesn't offer an easy-to-understand API for building the header
* Fewer mail delivery options
If you wish to take advantage of CAM::Template's ability to use a
custom template syntax, then you should create a new subclass that
inherits from both your custom template and from this module. A
simple example:
package MyTemplate;
use CAM::Template;
our @ISA = qw(CAM::Template);
sub patterns {
my $pkg = shift;
return {
$pkg->SUPER::patterns(),
# include syntax: <? include("subfile.tmpl") ?>
include => qr/<? *include\(\"([^\"]+)\"\) *?>/,
};
}
package MyEmailTemplate;
use MyTemplate;
use CAM::EmailTemplate;
our @ISA = qw(MyTemplate CAM::EmailTemplate);