Files
cms-core/Documentation/Changelog/11.4/Deprecation-95037-RootUidRelatedSettingOfTrees.rst
T

54 lines
1.5 KiB
ReStructuredText

.. include:: /Includes.rst.txt
.. _deprecation-95037:
======================================================
Deprecation: #95037 - rootUid related setting of trees
======================================================
See :issue:`95037`
Description
===========
The setting :php:`rootUid` used in FormEngine's :php:`treeConfig` is superseded by
:php:`startingPoints` and has been marked as deprecated.
In :php:`TYPO3\CMS\Core\Tree\TableConfiguration\DatabaseTreeDataProvider` the
following methods have been marked as deprecated:
* :php:`setRootUid()`
* :php:`getRootUid()`
Impact
======
Using `treeConfig/rootUid` in TCA will trigger a TCA migration to
`treeConfig/startingPoints` and raise a PHP :php:`E_USER_DEPRECATED` error.
The same applies to the according page TSconfig option.
The extension scanner detects any call to :php:`setRootUid()`
or :php:`getRootUid()` as weak match.
Affected Installations
======================
All extensions defining `rootUid` in their `TCA` or `TSconfig` are affected.
Furthermore all extensions directly calling one of the mentioned methods in
:php:`TYPO3\CMS\Core\Tree\TableConfiguration\DatabaseTreeDataProvider`.
Migration
=========
The setting `treeConfig/rootUid` can be migrated to `treeConfig/startingPoints`
passing the value as string, since `treeConfig/startingPoints` takes a
comma-separated value. The methods :php:`setRootUid()` and :php:`getRootUid()`
can be replaced by their successors :php:`setStartingPoints()` and
:php:`getStartingPoints()`.
.. index:: Backend, PartiallyScanned, ext:backend