man HTML::Embperl::Mail () - Sends results from Embperl via E-Mail

NAME

HTML::Embperl::Mail - Sends results from Embperl via E-Mail

SYNOPSIS

 use HTML::Embperl::Mail ;

 HTML::Embperl::Mail::Execute ({inputfile => 'template.epl',
                                subject   => 'Test HTML::Embperl::Mail::Execute',
                                to        => 'email@foo.org'}) ;

DESCRIPTION

HTML::Embperl::Mail uses HTML::Embperl to process a page template and send the result out via EMail. Currently only plain text mails are supported. A later version may add support for HTML mails. Because of that fact, normal Embperl HTML processing is disabled per Default (see options below).

Execute

The CWExecute function can handle all the parameter that CWHTML::Embperl::Execute does. Addtionaly the following parameters are recognized:

from
gives the sender e-mail address
to
gives the recipient address(es). Multiply addresses can either be separated by semikolon or given as an array ref.
cc
gives the recipient address(es) which should receive a carbon copy. Multiply addresses can either be separated by semikolon or given as an array ref.
bcc
gives the recipient address(es) which should receive a blind carbon copy. Multiply addresses can either be separated by semikolon or given as an array ref.
subject
gives the subject line
reply-to
the given address is insert as reply address
mailheaders
Array ref of additional mail headers
mailhost
Specifies which host to use as SMTP server. Default is localhost.
mailhelo
Specifies which host/domain to use in the HELO/EHLO command. A reasonable default is normaly choosen by Net::SMTP, but depending on your installation it may neccessary to set it manualy.
maildebug
Set to 1 to enable debugging of mail transfer.
options
If no CWoptions are given the following are used per default: optDisableHtmlScan, optRawInput, optKeepSpaces, optReturnError
escmode
In contrast to normal Embperl escmode defaults to zero (no escape)
errors
As in CWHTML::Embperl::Execute you can specify an array ref, which returns all the error messages from template processing. If you don't specify this parameter CWExecute will die when an error occurs.

Configuration

Some default values could be setup via environement variables

EMBPERL_MAILHOST

Specifies which host to use as SMTP server. Default is localhost.

EMBPERL_MAILHELO

Specifies which host/domain to use in the HELO/EHLO command. A reasonable default is normaly choosen by Net::SMTP, but depending on your installation it may neccessary to set it manualy.

EMBPERL_MAILFROM

Specifies which the email address that is used as sender. Default is www-server@server_name.

EMBPERL_MAILDEBUG

Debug setting for Net::SMTP. Default is 0.

Author

G. Richter (richter@dev.ecos.de)

See Also

perl(1), HTML::Embperl, Net::SMTP