Breaking: #96154 - Deprecated Shortcut API functionality removed

See forge#96154

Description

In TYPO3 v11 the Shortcut API was reworked to clean up the codebase and to align with the new Backend routing. Therefore, previously deprecated functionality has now been removed.

The following methods have been removed:

  • \TYPO3\CMS\Backend\Template\ModuleTemplate->makeShortcutIcon()
  • \TYPO3\CMS\Backend\Template\ModuleTemplate->makeShortcutUrl()
  • \TYPO3\CMS\Backend\Template\Components\Buttons\Action\ShortcutButton->getGetVariables()
  • \TYPO3\CMS\Backend\Template\Components\Buttons\Action\ShortcutButton->getModuleName()
  • \TYPO3\CMS\Backend\Template\Components\Buttons\Action\ShortcutButton->getSetVariables()
  • \TYPO3\CMS\Backend\Template\Components\Buttons\Action\ShortcutButton->setGetVariables()
  • \TYPO3\CMS\Backend\Template\Components\Buttons\Action\ShortcutButton->setModuleName()
  • \TYPO3\CMS\Backend\Template\Components\Buttons\Action\ShortcutButton->setSetVariables()

The following ViewHelper has been removed:

  • <f:be.buttons.shortcut>

The following functionality has been removed:

  • The automatic fallback, calculating a title for a new shortcut, based on the module
  • The automatic fallback, calculating a description for existing shortcuts, based on the module
  • The automatic fallback, determining the route identifier, based on the route path
  • The automatic fallback, determining the route identifier, based on the module name
  • The automatic fallback, determining the route identifier, based on the route parameter

Impact

Calling one of the removed methods or using the ViewHelper will most likely raise a PHP fatal level error.

When using an existing shortcut without a title, the fallback "Shortcut" will be displayed.

When adding a ShortcutButton, without providing a valid route identifier or a display name, an exception will be triggered.

Affected Installations

All installations using one of the mentioned methods or the ViewHelper.

All installations relying on one or multiple of the mentioned fallbacks.

Migration

Remove any usage to the mentioned methods or the ViewHelper.

Properly add the ShortcutButton with the required information.