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:
absolute
-
- Type
- bool
If set, the URI of the rendered link is absolute
action
-
- Type
- string
Target action
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.
additionalAttributes
-
- Type
- array
Additional tag attributes. They will be added directly to the resulting HTML tag.
additionalParams
-
- Type
- array
Additional query parameters that won't be prefixed like $arguments (overrule $arguments)
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)
argumentsToBeExcludedFromQueryString
-
- Type
- array
Arguments to be removed from the URI. Only active if $addQueryString = true
aria
-
- Type
- array
Additional aria-* attributes. They will each be added with a "aria-" prefix.
controller
-
- Type
- string
Target controller. If NULL current controllerName is used
data
-
- Type
- array
Additional data-* attributes. They will each be added with a "data-" prefix.
extensionName
-
- Type
- string
Target Extension Name (without `tx_` prefix and no underscores). If NULL the current extension name is used
format
-
- Type
- string
The requested format, e.g. ".html
language
-
- Type
- string
link to a specific language - defaults to the current language, use a language ID or "current" to enforce a specific language
linkAccessRestrictedPages
-
- Type
- bool
If set, links pointing to access restricted pages will still link to the page even though the page cannot be accessed.
noCache
-
- Type
- bool
Set this to disable caching for the target page. You should not need this.
pageType
-
- Type
- int
Type of the target page. See typolink.parameter
pageUid
-
- Type
- int
Target page. See TypoLink destination
pluginName
-
- Type
- string
Target plugin. If empty, the current plugin name is used
section
-
- Type
- string
The anchor to be added to the URI