Smarty Manual
Prev | Chapter 8. Custom Functions | Next

# 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 type="text/javascript" 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" >me@domain.com</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>

Prev | Home | Next
math | Up | popup_init