[!!!][BUGFIX] Respect rootLevel -1 for extbase queries
[Packages/TYPO3.CMS.git] / typo3 / sysext / core / Documentation / Changelog / master / Breaking-63406-RespectRootlevelConfigurationinExtbaseQueries.rst
1 =====================================================================
2 Breaking: #63406 - Respect rootLevel configuration in extbase queries
3 =====================================================================
4
5 Description
6 ===========
7
8 The rootLevel of a table can be configured to 0, 1 or -1 in TCA, to define where records of a table can be found in the system:
9
10 * 0: In the page tree only
11 * 1: Only on the root page (pid 0)
12 * -1: Both, on the root page and in the page tree
13
14 Currently only 0 and 1 are respected by the ``Typo3DbQueryParser`` when building the pageId statement. This means that a rootLevel of -1
15 does not get any pageId statement at all and therefore ignores any ``storagePid`` configuration for extbase plugins.
16
17
18 Impact
19 ======
20
21 Custom records that have a configuration like this ``$GLOBALS['TCA']['tx_myext_domain_model_record']['ctrl']['rootLevel'] = -1`` and
22 are used in extbase plugins might have trouble finding the records if ``plugin.tx_myext.persistence.storagePid`` is not configured properly.
23
24
25 Affected Installations
26 ======================
27
28 Third party code using ``$GLOBALS['TCA']['tx_myext_domain_model_record']['ctrl']['rootLevel'] = -1`` with records within the
29 page tree and without a proper ``storagePid`` configuration.
30
31
32 Migration
33 =========
34
35 Set ``plugin.tx_myext.persistence.storagePid`` to the page ids you want to find records from. 0 does not need to be included as
36 it is added to the statement automatically.