Link.email ViewHelper <f:link.email>
ViewHelper to generate an email link (mailto:), respecting TYPO3s spam TypoScript setting.
Go to the source code of this ViewHelper: Link\EmailViewHelper.php (GitHub).
Table of contents
Examples
Basic email link
packages/my_extension/Resources/Private/Templates/Blog/Show.fluid.html
<f:link.email email="foo@bar.tld" />
Copied!
Output
<a href="#" data-mailto-token="ocknvq,hqqBdct0vnf" data-mailto-vector="1">foo(at)bar.tld</a>
Copied!
Depending on t3tsref:confval-config-spamprotectemailaddresses setting.
Email link with custom linktext
packages/my_extension/Resources/Private/Templates/Blog/Show.fluid.html
<f:link.email email="foo@bar.tld">some custom content</f:link.email>
Copied!
Email link with custom subject and prefilled cc
packages/my_extension/Resources/Private/Templates/Blog/Show.fluid.html
<f:link.email email="foo@bar.tld" subject="Check out this website" cc="foo@example.com">some custom content</f:link.email>
Copied!
Output
<a href="mailto:foo@bar.tld?subject=Check%20out%20this%20website&cc=foo%40example.com">some custom content</a>
Copied!
Depending on t3tsref:confval-config-spamprotectemailaddresses setting.
Arguments of the <f:link.email> ViewHelper
Allows arbitrary arguments
This ViewHelper allows you to pass arbitrary arguments not defined below
directly to the HTML tag created. This includes custom data- arguments.
additionalAttributes
-
- Type
- array
Additional tag attributes. They will be added directly to the resulting HTML tag.
aria
-
- Type
- array
Additional aria-* attributes. They will each be added with a "aria-" prefix.
bcc
-
- Type
- string
The email address(es) for BCC of the email link
body
-
- Type
- string
A prefilled body for the email link
cc
-
- Type
- string
The email address(es) for CC of the email link
data
-
- Type
- array
Additional data-* attributes. They will each be added with a "data-" prefix.
-
- Type
- string
- Required
- 1
The email address to be turned into a link
subject
-
- Type
- string
A prefilled subject for the email link