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);