mail_vals.pl

Description

Mail_vals.pl is a HFPM module that e-mails selected field values and environmental variable values to some given e-mail addresses.

Usage

mail_vals.pl {recipients} [-v {fld | $fld | %envvar}] in the pipeline.

Usage Explanation

The fields and environmental variables are given as arguments to the program and the non-null ones are e-mailed to the recipients in a particular format. If none are given as arguments, then a whitespace-separated list of arguments are taken from the "_mail_vals" field.

A '%' prefix indicates the argument is an environmental variable and a '$' prefix means a form field argument, which is the default. In addition, a field or environmental variable pseudo-name of "all" refers to all fields or environmental variables except those that are null or whose name begins with an underscore ("_").

If no recipients are given as arguments, then the field "_mailto" is interpreted as a whitespace-separated list of e-mail recipients. If "no one" is the first (or only) recipient, then no mail is sent.

The subject line of the e-mail message is found in the "_mailsubj" field, with the default being "Form input". The subject is in variable encoded format and symbol encoded format.

Examples

"mail_vals.pl you@there -vcomments %REFERER_URL" on the pipeline: Mails something like this to you@there.
"mail_vals.pl" on the pipeline, "you@there me@here" in the field "_mailto", "%all $all _mail_vals" in the field "_mail_vals", and "New comments from $username ($realname)" in the field "_mailsubj": E-mails something like this to you@there and me@here.

Other Notes

The current version number is 1.0.

This module is not 8-bit character clean; character 255 may be clobbered.

The is module should work on any Unix machine with sendmail.

This module can be used more than once in the pipeline.