f:link.page¶
A view helper for creating links to TYPO3 pages.
Properties¶
All the universal tag attributes
Exclusive properties for the HTML-Element¶
target¶
- Variable type
- String
- Description
- Specifies where to open the linked document.
- Default value
- NULL
- Mandatory
- No
rel¶
- Variable type
- String
- Description
- Specifies the relationship between the current document and the linked document.
- Default value
- NULL
- Mandatory
- No
Exclusive properties of this ViewHelper¶
pageUid¶
- Variable type
- Integer|NULL
- Description
- Target page. See TypoLink destination.
- Default value
- NULL
- Mandatory
- No
additionalParams¶
- Variable type
- Array
- Description
- Query parameters to be attached to the resulting URI.
- Default value
- Leeres Array
- Mandatory
- No
pageType¶
- Variable type
- Integer
- Description
- Type of the target page. See typolink.parameter.
- Default value
- 0
- Mandatory
- No
noCache¶
- Variable type
- Boolean
- Description
- Set this to disable caching for the target page. You should not need this.
- Default value
- FALSE
- Mandatory
- No
noCacheHash¶
- Variable type
- Boolean
- Description
- Set this to suppress the
cHash
query parameter created by TypoLink. You should not need this. - Default value
- FALSE
- Mandatory
- No
section¶
- Variable type
- String
- Description
- The anchor to be added to the URI.
- Default value
- Leerer String
- Mandatory
- No
linkAccessRestrictedPages¶
- Variable type
- Boolean
- Description
- If set, links pointing to access restricted pages will still link to the page even though the page cannot be accessed.
- Default value
- FALSE
- Mandatory
- No
absolute¶
- Variable type
- Boolean
- Description
- If set, the URI of the rendered link is absolute.
- Default value
- FALSE
- Mandatory
- No
addQueryString¶
- Variable type
- Boolean
- Description
If set, the current query parameters will be kept in the URI.
Attention
This property should not be used for cached contents without a valid cHash. Otherwise the page is cached for the first set of parameters and subsubsequently taken from the cache no matter what parameters are given. Additionally the security risk of cache poisoning has to be considered.
- Default value
- FALSE
- Mandatory
- No
argumentsToBeExcludedFromQueryString¶
- Variable type
- Array
- Description
- Arguments to be removed from the URI. Only active if $addQueryString = TRUE.
- Default value
- Leeres Array
- Mandatory
- No
addQueryStringMethod¶
- Variable type
- String
- Description
- Set which parameters will be kept. Only active if $addQueryString = TRUE.
- Default value
- NULL
- Mandatory
- No
Examples¶
Link to the current page
<f:link.page>page link</f:link.page>
<a href="index.php?id=123">page link</a>
(depending on the current page and your TS configuration)
Query parameters
<f:link.page pageUid="1" additionalParams="{foo: 'bar'}">page link</f:link.page>
<a href="index.php?id=1&foo=bar">page link</a>
(depending on your TS configuration)
Query parameters for extensions
<f:link.page pageUid="1" additionalParams="{extension_key: {foo: 'bar'}}">page link</f:link.page>
<a href="index.php?id=1&extension_key[foo]=bar">page link</a>
(depending on your TS configuration)