PHP Manual

PEAR Manual

Smarty Manual

PostgreSQL

MySQL Manual

Perl Manual

{mailto}

{mailto} automates the creation of mailto: links and optionally encodes them. encoding e-mails makes it more difficult for web spiders to lift e-mail addresses off of your site.

attribute nametyperequireddefaultdescription
addressstringyesn/athe e-mail address
textstringnon/athe text to display, default is the e-mail address
encodestringnononehow to encode the e-mail. can be one of none, hex, javascript or javascript_charcode.
ccstringnon/ae-mail addresses to carbon copy. separate entries by a comma.
bccstringnon/ae-mail addresses to blind carbon copy. separate entries by a comma.
subjectstringnon/ae-mail subject.
newsgroupsstringnon/anewsgroups to post to. separate entries by a comma.
followuptostringnon/aaddresses to follow up to. separate entries by a comma.
extrastringnon/aany extra information you want passed to the link, such as style sheet classes

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

example 8-19. {mailto}

{mailto address="me@example.com"} <a href="mailto:me@example.com" >me@example.com</a>     {mailto address="me@example.com" text="send me some mail"} <a href="mailto:me@example.com" >send me some mail</a>     {mailto address="me@example.com" encode="javascript"} <script type="text/javascript" language="javascript">  eval(unescape('%64%6f% ... snipped ...%61%3e%27%29%3b')) </script>     {mailto address="me@example.com" encode="hex"} <a href="mailto:%6d%65.. snipped..3%6f%6d">&#x6d;&..snipped...#x6f;&#x6d;</a>     {mailto address="me@example.com" subject="hello to you!"}    <a href="mailto:me@example.com?subject=hello%20to%20you%21" >me@example.com</a>  {mailto address="me@example.com" cc="you@example.com,they@example.com"}    <a href="mailto:me@example.com?cc=you@example.com%2cthey@example.com" >me@example.com</a>  {mailto address="me@example.com" extra='class="email"'}    <a href="mailto:me@example.com" class="email">me@example.com</a>  {mailto address="me@example.com" encode="javascript_charcode"}    <script type="text/javascript" language="javascript">    <!-- {document.write(string.fromcharcode(60,97, ... snipped ....60,47,97,62))}    //-->    </script>

see also escape, obfuscating e-mail addresses and {textformat}