Sender (Email subroutine): Difference between revisions

From m204wiki
Jump to navigation Jump to search
mNo edit summary
Line 41: Line 41:
The actual existence of such an address is not validated; merely its form.
The actual existence of such an address is not validated; merely its form.
A null address value is usually acceptable, however.
A null address value is usually acceptable, however.
<li>For <var>Sender</var> method examples, see [[SMTP Helper#Basic e-mail|"Basic e-mail"]] and
<li>For <var>Sender</var> method examples, see [[Email class#Basic e-mail|"Basic e-mail"]] and
[[SMTP Helper#E-mail with attachment|"E-mail with attachment"]].
[[Email class#E-mail with attachment|"E-mail with attachment"]].
</ul>
</ul>
==See also==
==See also==
{{Template:Email:Sender footer}}
{{Template:Email:Sender footer}}

Revision as of 19:25, 25 July 2011

Mail sender email address (Email class)


The Sender arguments you provide are sent to the SMTP server in a "MAIL FROM" command, and they are also included in the e-mail content as the "From" mail header.

Syntax

email:Sender( name, [nickname])

Syntax terms

%email A previously declared Email object.
name The e-mail address of the sender.
nickname An optional string that contains a familiar name associated

with the mail sender. This nickname appears in the e-mail content as part of the &ldquo;From:&rdquo; mail header.

Usage notes

  • The sender's e-mail address is not a required header according to protocol, It is not an error if you omit the Sender method (or, the equivalent, if you include a Sender call that has a null address) in your request. However, if no Sender value is set, no From: header is included in the e-mail content unless you explicitly do so using the AddHeader method. In practice, SMTP servers typically want a validly formed sender e-mail address, and they reject e-mail if an included sender address value does not contain an at sign (@) and a domain name (a string ending with a period (.) followed by a domain suffix). Note: The actual existence of such an address is not validated; merely its form. A null address value is usually acceptable, however.
  • For Sender method examples, see "Basic e-mail" and "E-mail with attachment".

See also