TYPO3 v15 dev-main snapshot ()

2026-08-10 22:31:09 +02:00
commit af8cc155b5
6818 changed files with 642608 additions and 0 deletions
@@ -0,0 +1,33 @@
+.. include:: /Includes.rst.txt
+
+.. _feature-96904:
+
+=========================================================
+Feature: #96904 - Backend toolbar items are request aware
+=========================================================
+
+See :issue:`96904`
+
+Description
+===========
+
+When registering own toolbar items to the TYPO3 backend top bar, classes can
+now retrieve the current PSR-7 request by implementing
+:php:`TYPO3\CMS\Backend\Toolbar\RequestAwareToolbarItemInterface`. This
+is especially useful when rendering views using
+:php:`TYPO3\CMS\Backend\View\BackendViewFactory` which depends on
+current request.
+
+Impact
+======
+
+The TYPO3 Core encourages to use :php:`BackendViewFactory` instead of
+:php:`StandaloneView` when toolbar items of extensions use Fluid templates.
+:php:`BackendViewFactory` has a dependency to current request, so
+:php:`RequestAwareToolbarItemInterface` should be implemented
+to receive the current request from TYPO3 EXT:backend.
+
+Doing so enables the :doc:`template overrides by TSconfig
+feature <../12.0/Feature-96812-OverrideBackendTemplatesWithTSconfig>`.
+
+.. index:: Backend, PHP-API, ext:backend