Link.action ViewHelper <f:link.action>
¶
A ViewHelper for creating links to extbase actions. Tailored for extbase plugins, uses extbase Request and extbase UriBuilder.
Examples¶
link to the show-action of the current controller:
<f:link.action action="show">action link</f:link.action>
Copied!
Output:
<a href="index.php?id=123&tx_myextension_plugin[action]=show&tx_myextension_plugin[controller]=Standard&cHash=xyz">action link</a>
Copied!
Depending on the current page and your TypoScript configuration.
Source code
Go to the source code of this ViewHelper: Link\ActionViewHelper.php (GitHub).
Arguments
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.
The following arguments are available for the link.action ViewHelper:
-
additionalAttributes
¶ -
- Type
- array
Additional tag attributes. They will be added directly to the resulting HTML tag.
-
data
¶ -
- Type
- array
Additional data-* attributes. They will each be added with a "data-" prefix.
-
aria
¶ -
- Type
- array
Additional aria-* attributes. They will each be added with a "aria-" prefix.
-
action
¶ -
- Type
- string
Target action
-
controller
¶ -
- Type
- string
Target controller. If NULL current controllerName is used
-
extensionName
¶ -
- Type
- string
Target Extension Name (without `tx_` prefix and no underscores). If NULL the current extension name is used
-
pluginName
¶ -
- Type
- string
Target plugin. If empty, the current plugin name is used
-
pageUid
¶ -
- Type
- int
Target page. See TypoLink destination
-
pageType
¶ -
- Type
- int
Type of the target page. See typolink.parameter
-
noCache
¶ -
- Type
- bool
Set this to disable caching for the target page. You should not need this.
-
language
¶ -
- Type
- string
link to a specific language - defaults to the current language, use a language ID or "current" to enforce a specific language
-
section
¶ -
- Type
- string
The anchor to be added to the URI
-
format
¶ -
- Type
- string
The requested format, e.g. ".html
-
linkAccessRestrictedPages
¶ -
- Type
- bool
If set, links pointing to access restricted pages will still link to the page even though the page cannot be accessed.
-
additionalParams
¶ -
- Type
- array
Additional query parameters that won't be prefixed like $arguments (overrule $arguments)
-
absolute
¶ -
- Type
- bool
If set, the URI of the rendered link is absolute
-
addQueryString
¶ -
- Type
- string
- Default
- false
If set, the current query parameters will be kept in the URL. If set to "untrusted", then ALL query parameters will be added. Be aware, that this might lead to problems when the generated link is cached.
-
argumentsToBeExcludedFromQueryString
¶ -
- Type
- array
Arguments to be removed from the URI. Only active if $addQueryString = true
-
arguments
¶ -
- Type
- array
Arguments for the controller action, associative array (do not use reserved keywords "action", "controller" or "format" if not referring to these internal variables specifically)