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,85 @@
+.. include:: /Includes.rst.txt
+
+.. _deprecation-82426:
+
+==============================================================
+Deprecation: #82426 - typo3-pagetree navigation component name
+==============================================================
+
+See :issue:`82426`
+
+Description
+===========
+
+When registering an extensions's BE module with :php:`ExtensionUtility::registerModule()` it is possible to define 'navigationComponentId'.
+
+The name the navigation component name :php:`typo3-pagetree` has been marked as deprecated.
+:php:`TYPO3/CMS/Backend/PageTree/PageTreeElement` should be used instead.
+
+Impact
+======
+
+Calling :php:`ExtensionUtility::registerModule()` with the old navigation component name will trigger a deprecation log entry.
+
+Affected Installations
+======================
+
+All installations having custom BE modules passing the old navigation component name to :php:`ExtensionUtility::registerModule()`.
+
+
+Migration
+=========
+
+Use :php:`TYPO3/CMS/Backend/PageTree/PageTreeElement` instead of `typo3-pagetree`.
+
+
+
+Old configuration:
+------------------
+
+.. code-block:: php
+
+      \TYPO3\CMS\Extbase\Utility\ExtensionUtility::registerModule(
+          'TYPO3.CMS.Workspaces',
+          'web',
+          'workspaces',
+          'before:info',
+          [
+              // An array holding the controller-action-combinations that are accessible
+              'Review' => 'index,fullIndex,singleIndex',
+              'Preview' => 'index,newPage'
+          ],
+          [
+              'access' => 'user,group',
+              'icon' => 'EXT:workspaces/Resources/Public/Icons/module-workspaces.svg',
+              'labels' => 'LLL:EXT:workspaces/Resources/Private/Language/locallang_mod.xlf',
+              'navigationComponentId' => 'typo3-pagetree'
+          ]
+      );
+
+
+Should be changed to new configuration:
+---------------------------------------
+
+.. code-block:: php
+
+      \TYPO3\CMS\Extbase\Utility\ExtensionUtility::registerModule(
+          'TYPO3.CMS.Workspaces',
+          'web',
+          'workspaces',
+          'before:info',
+          [
+              // An array holding the controller-action-combinations that are accessible
+              'Review' => 'index,fullIndex,singleIndex',
+              'Preview' => 'index,newPage'
+          ],
+          [
+              'access' => 'user,group',
+              'icon' => 'EXT:workspaces/Resources/Public/Icons/module-workspaces.svg',
+              'labels' => 'LLL:EXT:workspaces/Resources/Private/Language/locallang_mod.xlf',
+              'navigationComponentId' => 'TYPO3/CMS/Backend/PageTree/PageTreeElement'
+          ]
+      );
+
+
+.. index:: Backend, PHP-API, PartiallyScanned