Attention

TYPO3 v10 has reached end-of-life as of April 30th 2023 and is no longer being maintained. Use the version switcher on the top left of this page to select documentation for a supported version of TYPO3.

Need more time before upgrading? You can purchase Extended Long Term Support (ELTS) for TYPO3 v10 here: TYPO3 ELTS.

link.typolink¶

A ViewHelper to create links from fields supported by the link wizard

Example¶

{link} contains: t3://page?uid=2&arg1=val1#9 _blank some-css-class "Title containing Whitespace".

Or a legacy version from older TYPO3 versions: {link} contains: 9 _blank - "testtitle with whitespace" &X=y.

Minimal usage¶

<f:link.typolink parameter="{link}">
   Linktext
</f:link.typolink>

Output:

<a href="/page/path/name.html?X=y" title="testtitle with whitespace" target="_blank">
   Linktext
</a>

Depending on current page, routing and page path configuration.

Full parameter usage¶

<f:link.typolink parameter="{link}" additionalParams="&u=b"
    target="_blank"
    class="ico-class" title="some title"
    additionalAttributes="{type:'button'}"
>
   Linktext
</f:link.typolink>

Output:

<a href="/page/path/name.html?X=y&u=b" title="some title" target="_blank" class="ico-class" type="button">
    Linktext
</a>

Depending on routing and page path configuration.

Arguments¶

parameter¶

DataType: string
Required: true
Description: StdWrap.typolink style parameter string

target¶

DataType: string
Required: false
Description: Define where to display the linked URL

class¶

DataType: string
Required: false
Description: Define classes for the link element

title¶

DataType: string
Required: false
Description: Define the title for the link element

language¶

DataType: string
Required: false
Description: Link to a specific language - defaults to the current language, use a language ID or "current" to enforce a specific language

additionalParams¶

DataType: string
Required: false
Description: Additional query parameters to be attached to the resulting URL

additionalAttributes¶

DataType: mixed
Default: array ()
Required: false
Description: Additional tag attributes to be added directly to the resulting HTML tag

useCacheHash¶

DataType: mixed
Required: false
Description: Deprecated: You should not need this.

addQueryString¶

DataType: mixed
Required: false
Description: If set, the current query parameters will be kept in the URL

addQueryStringMethod¶

DataType: string
Default: 'GET'
Required: false
Description: Method to use when keeping query parameters (only active if addQueryString is set)

addQueryStringExclude¶

DataType: string
Required: false
Description: Define parameters to be excluded from the query string (only active if addQueryString is set)

absolute¶

DataType: mixed
Required: false
Description: Ensure the resulting URL is an absolute URL

parts-as¶

DataType: string
Default: 'typoLinkParts'
Required: false
Description: Variable name containing typoLink parts (if any)