e544ed6d9a
Comparing changes: https://github.com/smarty-php/smarty/compare/v4.3.1...v4.4.1 It is noticeable that Smarty 4.3.1 does not officially support PHP 8.3. Is only supported with 4.4.0. Remark: During tests with Smarty 4.5.1, it was noticed that the following warning occurs: Deprecated: Using the unregistered function "function_exists" in a template is deprecated and will be removed in a future version. Use Smarty::registerPlugin to explicitly register a custom modifier. As of Smarty 5.X.X, templates must be revised again. The Smarty release 5.0.2 is already officially available. However, integration into FlatPress is not entirely trivial.
62 lines
3.0 KiB
Markdown
62 lines
3.0 KiB
Markdown
# {mailto}
|
|
|
|
`{mailto}` automates the creation of a `mailto:` anchor links and
|
|
optionally encodes them. Encoding emails makes it more difficult for web
|
|
spiders to lift email addresses off of a site.
|
|
|
|
## Attributes
|
|
|
|
| Attribute Name | Required | Description |
|
|
|----------------|----------|-----------------------------------------------------------------------------------------------|
|
|
| address | Yes | The e-mail address |
|
|
| text | No | The text to display, default is the e-mail address |
|
|
| encode | No | How to encode the e-mail. Can be one of `none`, `hex`, `javascript` or `javascript_charcode`. |
|
|
| cc | No | Email addresses to carbon copy, separate entries by a comma. |
|
|
| bcc | No | Email addresses to blind carbon copy, separate entries by a comma |
|
|
| subject | No | Email subject |
|
|
| newsgroups | No | Newsgroups to post to, separate entries by a comma. |
|
|
| followupto | No | Addresses to follow up to, separate entries by a comma. |
|
|
| extra | No | Any extra information you want passed to the link, such as style sheet classes |
|
|
|
|
> **Note**
|
|
>
|
|
> Javascript is probably the most thorough form of encoding, although
|
|
> you can use hex encoding too.
|
|
|
|
|
|
## Examples
|
|
|
|
```smarty
|
|
{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">m&..snipped...#x6f;m</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,they@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`](../language-modifiers/language-modifier-escape.md),
|
|
[`{textformat}`](../language-custom-functions/language-function-textformat.md) and [obfuscating email
|
|
addresses](../../appendixes/tips.md#obfuscating-e-mail-addresses).
|