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.

See Also

The variable encoded format used to encode the fields and environmental variables and the symbol encoded format used to encode characters that might be mistaken for HTML markings.
[HFPM Home] [Please comment]
Copyright © by James Hoagland
www.hoagland.org | webmaster@hoagland.org
30 January 1996