Deprecation: #110148 - Experimental backend ViewHelpers 

See forge#110148

Description 

The following experimental backend-related Fluid ViewHelpers have been marked as deprecated:

  • \TYPO3\CMS\Fluid\ViewHelpers\Be\PagePathViewHelper ( <f:be.pagePath>)
  • \TYPO3\CMS\Fluid\ViewHelpers\Be\AbstractBackendViewHelper

The PagePathViewHelper rendered the current page path as displayed in TYPO3 backend modules. This information is nowadays part of the module doc header, which is rendered by \TYPO3\CMS\Backend\Template\ModuleTemplate within the corresponding controller.

The abstract AbstractBackendViewHelper provided the helper methods getModuleTemplate() and getPageRenderer(). Both are obsolete with the current ModuleTemplate view strategy and dependency injection, and the class is no longer used as a base class within TYPO3 Core.

Impact 

Using the <f:be.pagePath> ViewHelper in a Fluid template will trigger a PHP E_USER_DEPRECATED error.

Extending AbstractBackendViewHelper or calling its methods getModuleTemplate() or getPageRenderer() will trigger a PHP E_USER_DEPRECATED error.

Both classes will be removed in TYPO3 v16.0.

Affected installations 

All installations using the <f:be.pagePath> ViewHelper in backend Fluid templates, or custom backend ViewHelpers extending AbstractBackendViewHelper.

The extension scanner reports any usage of the affected classes as strong match.

Migration 

For the page path, use the doc header provided by \TYPO3\CMS\Backend\Template\ModuleTemplate in your backend controller, which already displays the current page path.

Custom backend ViewHelpers should extend \TYPO3Fluid\Fluid\Core\ViewHelper\AbstractViewHelper directly and retrieve \TYPO3\CMS\Backend\Template\ModuleTemplate or \TYPO3\CMS\Core\Page\PageRenderer via dependency injection instead of the removed helper methods.