mailto

Attribute Name	Type	Required	Default	Description
address	string	Yes	n/a	the e-mail address
text	string	No	n/a	the text to display, default is the e-mail address
encode	string	No	none	How to encode the e-mail. Can be one of none, hex or javascript.
cc	string	No	n/a	e-mail addresses to carbon copy. Separate entries by a comma.
bcc	string	No	n/a	e-mail addresses to blind carbon copy. Separate entries by a comma.
subject	string	No	n/a	e-mail subject.
newsgroups	string	No	n/a	newsgroups to post to. Separate entries by a comma.
followupto	string	No	n/a	addresses to follow up to. Separate entries by a comma.
extra	string	No	n/a	any extra information you want passed to the link, such as style sheet classes

mailto automates the creation of mailto links and optionally encodes them. Encoding e-mails makes it more difficult for web spiders to pick up e-mail addresses off of your site.

Technical Note: javascript is probably the most thorough form of encoding, although you can use hex encoding too.

Example 8-15. mailto

{mailto address="me@domain.com"}
{mailto address="me@domain.com" text="send me some mail"}
{mailto address="me@domain.com" encode="javascript"}
{mailto address="me@domain.com" encode="hex"}
{mailto address="me@domain.com" subject="Hello to you!"}
{mailto address="me@domain.com" cc="you@domain.com,they@domain.com"}
{mailto address="me@domain.com" extra='class="email"'}

OUTPUT:

<a href="mailto:me@domain.com" >me@domain.com</a>
<a href="mailto:me@domain.com" >send me some mail</a>
<SCRIPT language="javascript">eval(unescape('%64%6f%63%75%6d%65%6e%74%2e%77%72%6
9%74%65%28%27%3c%61%20%68%72%65%66%3d%22%6d%61%69%6c%74%6f%3a%6d%65%40%64%6f%6d%
61%69%6e%2e%63%6f%6d%22%20%3e%6d%65%40%64%6f%6d%61%69%6e%2e%63%6f%6d%3c%2f%61%3e
%27%29%3b'))</SCRIPT>
<a href="mailto:%6d%65@%64%6f%6d%61%69%6e.%63%6f%6d" >&#x6d;&#x65;&#x40;&#x64;&
#x6f;&#x6d;&#x61;&#x69;&#x6e;&#x2e;&#x63;&#x6f;&#x6d;</a>
<a href="mailto:me@domain.com?subject=Hello%20to%20you%21" >me@domain.com</a>
<a href="mailto:me@domain.com?cc=you@domain.com%2Cthey@domain.com" >me@domain.com</a>
<a href="mailto:me@domain.com" class="email">me@domain.com</a>