mail Tag
| Format: <mail to [ subject ] [ from ] [ cc ] [ bcc ] > heitml </mail> |
Purpose: Sends a message to the email address specified in the to parameter.
Anything you type between the opening and closing mail tags is processed in HTML mode where the resulting string output is not sent to the browser, as usual, but to the underlying MTA (Mail Transfer Agent).
The MTA is the sendmail program on UNIX, and SMTP (Simple Mail Transfer Protocol) or MAPI (Microsoft Messaging Application Programming Interface) on Windows.
The mail Tag can also accept the following optional parameters:
| subject | : | A short description that indicates what the message is about. |
| from | : | The email address of the person sending the message. |
| cc | : | List of email addresses that received copies of the message. |
| bcc | : | Hidden list of email addresses that received copies of the message. (i.e. The primary recipient of the email does not see who else may have received the message. |
According to RFC 822, an email address can take either of the following forms:
name@domain
or
Display_name <name@domain>
The to, from, cc, and bcc parameters all accept email addresses in either of the two formats previous illustrated. However, the cc and bcc parameters can accept multiple email addresses separated by commas.
Configuration:
For the mail Tag to function properly with those MTA's,
you have to properly setup the configuration parameters sendmailprog, mailusemapi, mailservice, mailprofile and mailpassword.
Here are a few practical examples:
Example 1:
| Email Address enclosed by Quotes |
|---|
| <mail to="cecile@aol.com"> Message goes here. </mail> |
Example 2:
| In Quotes together with a Name |
|---|
| <mail to="Cecile Provot <cecile@aol.com>"> Message goes here. </mail> |
Example 3:
| Email assigned from an object field |
|---|
| <mail to=r.Email> Message goes here. </mail> |
| Note: The mail Tag is Case Sensitive, which means that heitml will not recognize it if you use capital letters (e.g. <MAIL to>). The parameters (to, from, subject, etc.) are not Case Sensitive. |
© 1996-2023 H.E.I. All Rights Reserved.
