Deprecation: #92062 - Migrate RecordListController hooks to PSR-14 event¶
See forge#92062
Description¶
The following hooks have been marked as deprecated:
$GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['recordlist/Modules/Recordlist/index.php']['drawHeaderHook']
$GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['recordlist/Modules/Recordlist/index.php']['drawFooterHook']
Both hooks were used to add content before or after the main content of the list module.
Impact¶
Using the hooks still works as before, but trigger a PHP E_USER_DEPRECATED
error.
The hooks will be removed and stop working in TYPO3 v12.
Please migrate to the PSR-14 event: TYPO3\CMS\Recordlist\Event\RenderAdditionalContentToRecordListEvent
.
Affected Installations¶
TYPO3 installations with extensions that hook into the RecordListController.
Migration¶
The functionality of both hooks has been migrated to the following PSR-14 event:
TYPO3\CMS\Recordlist\Event\RenderAdditionalContentToRecordListEvent
.
The event class contains the following relevant public methods:
getRequest
Returns the request object from the list module request.addContentAbove
Add additional content as string as it is to be shown above the main content.addContentBelow
Add additional content as string as it is to be shown below the main content.
The event object is used as parameter for the event listener method (default is __invoke
).
The listener needs to be registered in the extension: EXT:myext/Configuration/Services.yaml
.
Example:
My\Extension\Provider\MyAdditionalContentProvider:
tags:
- name: event.listener
identifier: 'my-additional-content'
event: TYPO3\CMS\Recordlist\Event\RenderAdditionalContentToRecordListEvent
Please have a look at TYPO3\CMS\SysNote\Provider\RecordListProvider
as an example for the
listener implementation.