[TASK] Backend toolbar interface documentation
[Packages/TYPO3.CMS.git] / typo3 / sysext / core / Documentation / Changelog / master / Breaking-63431-BackendToolbarRefactored.rst
1 =============================================
2 Breaking: #63431 - Backend toolbar refactored
3 =============================================
4
5 Description
6 ===========
7
8 The upper right backend toolbar was refactored with TYPO3 CMS 7.0. A new PHP interface
9 and a new registration was introduced.
10
11 Impact
12 ======
13
14 Extensions not adapted to the new interface will not show up in the toolbar anymore, but
15 will not throw a fatal PHP error.
16
17 Method BackendController::addToolbarItem() is deprecated.
18
19 Affected installations
20 ======================
21
22 If a TYPO3 CMS instance uses extensions based on the old interface and registration, the
23 according items will vanish from the toolbar.
24
25 Migration
26 =========
27
28 Extensions must implement the new interface \TYPO3\CMS\Backend\Toolbar\ToolbarItemInterface
29 and must register in $GLOBALS['TYPO3_CONF_VARS']['BE']['toolbarItems'].
30
31 Warning: The new interface is not 100% finished, method checkAccess() will probably be
32 substituted by two other methods in later TYPO3 CMS versions.