Deprecation: #99519 - Deprecated BackendUtility::getFuncMenu()¶
See forge#99519
Description¶
Method \TYPO3\
has
been marked deprecated and should no longer be used.
Impact¶
Calling the method will raise a deprecation level log error and will stop working with TYPO3 v13.
Affected installations¶
The method may be used in extensions that add backend modules. The extension scanner finds usages with a strong match.
Migration¶
Backend
is a helper method that renders a
select drop down and is typically used to trigger a GET
request when
the user selects an option.
In general, such HTML should not be generated by PHP, but by Fluid templating. The method is thus typically used by old school backend modules that have not or only partially been transferred to Fluid, improving the controller-view separation.
The most simple and ugly migration is to copy the method to an own controller
that consumes the method. The better solution is to add the arguments as variables
to the Fluid template and render the dropdown in Fluid. This should be a pretty
straight transition as well and typically avoids another <f:
ViewHelper usage.
Note that requests send by these dropdowns should switch from GET to POST in
case they change server state (for example, changing records) along the way: State changing
requests should be restricted to POST
as an additional security measure, and to
not violate the HTTP protocol. The TYPO3 Core comes with more and more examples
on how to handle this properly. For instance all dropdowns and checkbox toggles
of the tstemplate
extension (Site Management > TypoScript backend module)
have been changed to do this and can be studied on how to trigger immediate
POST
actions when clicking such elements.