57 lines
1.8 KiB
ReStructuredText
57 lines
1.8 KiB
ReStructuredText
.. include:: /Includes.rst.txt
|
|
|
|
.. _breaking-97926-1657726187:
|
|
|
|
========================================================
|
|
Breaking: #97926 - Extbase QuerySettings methods removed
|
|
========================================================
|
|
|
|
See :issue:`97926`
|
|
|
|
Description
|
|
===========
|
|
|
|
Extbase's Persistence functionality is basing ORM queries on certain settings
|
|
usually fetched from :php:`QuerySettingsInterface`, with a default
|
|
implementation :php:`Typo3QuerySettings`.
|
|
|
|
The interface itself has changed so that it now requires two new methods:
|
|
|
|
:php:`QuerySettingsInterface::getLanguageAspect(): LanguageAspect`
|
|
:php:`QuerySettingsInterface::setLanguageAspect(LanguageAspect $aspect)`
|
|
|
|
The LanguageAspect covers both the overlay functionality and setting the
|
|
language ID.
|
|
|
|
For this reason, the following methods are removed from
|
|
:php:`QuerySettingsInterface`:
|
|
|
|
- :php:`QuerySettingsInterface::getLanguageOverlayMode()`
|
|
- :php:`QuerySettingsInterface::setLanguageOverlayMode($languageOverlayMode)`
|
|
- :php:`QuerySettingsInterface::getLanguageUid()`
|
|
- :php:`QuerySettingsInterface::setLanguageUid($languageUid)`
|
|
|
|
All adaptions have been made to the default implementation in
|
|
:php:`Typo3QuerySettings`, however the removed methods from the interface are kept
|
|
within the implementation to avoid fatal PHP errors.
|
|
|
|
Impact
|
|
======
|
|
|
|
Any custom implementation of :php:`QuerySettingsInterface` needs to implement
|
|
the newly defined methods of the interface.
|
|
|
|
Affected installations
|
|
======================
|
|
|
|
TYPO3 installations with custom Extbase extensions dealing with QuerySettings
|
|
that are adjusted with the methods used above.
|
|
|
|
Migration
|
|
=========
|
|
|
|
Switch the affected extensions via PHP to calling the newly added methods, as this is
|
|
how TYPO3 Core behaves the most reliable.
|
|
|
|
.. index:: PHP-API, FullyScanned, ext:extbase
|