BEE Script:   mailto emailAddress [subject=string]

            [from=emailAddress] [fromname=string]

            [cc=emailAddress] [bcc=emailAddress]

            [ignore=string] [header=string] [body=string];

BEE Tag:     <beemailto emailAddress [subject=string]

            [from=emailAddress] [fromname=string]

            [cc=emailAddress] [bcc=emailAddress]

            [ignore=string] [header=string] [body=string]>

Note: If the message is sent to multiple addresses, please separate them but commas.

The "mailto" command differs from other form-mail scripts in several ways:

Firstly, "mailto" command does not show up in the <form ...> tag.  You simply set the action="..." to the confirmation (or thank-you) page, where the "mailto" command is included.

Secondly, "mailto" command can send an e-mail without a form submission.  You can use this to get alert messages directly from the web site.

Thirdly, "mailto" command does not disclose any parameters to the users including the recipient's e-mail address, not even from the page source view.  All the users can see is the confirmation page, and by then the mail has already been sent.

This is to protect the privacy of the recipient and prevent the e-mail address from being scanned on the web site by online marketers.

Parameters

subject of the e-mail.  Default is "Online Submission".

from is the e-mail address appearing at the "From" line of the e-mail.

fromname is the name of the sender appearing at the "From" line of the e-mail.

cc is the CC recipient of the e-mail.  If there are multiple addresses, please separate them but commas.

bcc is the BCC recipient of the e-mail. If there are multiple addresses, please separate them but commas.

header is a string specifying any extra header lines you want to append to the original header.  For example, header="{const%mail:HTML_HEADER}" will turn the message from plain text into HTML format.

Please be careful not to repeat the header lines.  For example, if you specify the "From" line in the header string, do not specify the "from" parameters.  Otherwise, there will be two "From" lines in the header, which may result in unpredictable result.

body is the message body to send. If "body" is blank, the elements in the sys%form variable (the form entries) will be listed to form the message body.  You can use body="..." to send an arbitary message, whether a form is submitted or not.  This is useful to keep track of access to pages of importance.  You can send the administrator an e-mail notification whenever the page is accessed and/or a condition is met.

ignore is a list of names (separated by commas) specifying the sys%form elements to be ignored in the e-mail.  Example: ignore="MyEmail, Submit" would cause "mailto" tag not to include MyEmail and Submit into the message body.  The parameter "ignore" will be ignored if the parameter "body" is specified, in which case all sys%form elements will be ignored anyway.

After calling the function, the following BEE Variables are made available: