Deprecation: #95041 - <f:uri.email> view-helper

See forge#95041

Description

Fluid view-helper <f:uri.email email="{email}"> was used in combination with config.spamProtectEmailAddresses settings during frontend rendering and returned corresponding javascript:linkTo_UnCryptMailto(...) inline JavaScript URI. In case spam-protections is not configured, this view-helper just passed through the given email address.

In favor of allowing more content security policy scenarios, URI is not used anymore per default. As a result, <f:uri.email> view-helper became obsolete. The view-helper will be removed with TYPO3 v12.0.

Impact

Using <f:uri.email> view-helper will trigger a PHP E_USER_DEPRECATED error.

Affected Installations

All projects using <f:uri.email email="{email}"> or {email -> f:uri.email(email:email)} view-helper invocations in their Fluid templates.

Migration

In case config.spamProtectEmailAddresses is used, make use of <f.link.email email="{email}"> view-helper which returns the complete <a> tag like this:

<a href="#" data-mailto-token="ocknvq,hqqBdct0vnf"
    data-mailto-vector="1">user(at)my.example(dot)com</a>

In case spam-protected is not used or not useful (for example in backend user interface), view-helper invocation can be omitted completely.