Feature: #96899 - New PSR-14 event: ModifyGenericBackendMessagesEvent¶
See forge#96899
Description¶
A new PSR-14 event \TYPO3\CMS\Backend\Controller\Event\ModifyGenericBackendMessagesEvent
has been introduced. It serves as direct replacement for the now removed hook
$GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['t3lib/class.t3lib_befunc.php']['displayWarningMessages']
.
Example¶
Registration of an event listener in your extension's Services.yaml
:
MyVendor\MyPackage\Backend\MyEventListener:
tags:
- name: event.listener
identifier: 'my-package/backend/add-message'
Copied!
The corresponding event listener class:
use TYPO3\CMS\Backend\Controller\Event\ModifyGenericBackendMessagesEvent;
use TYPO3\CMS\Core\Messaging\FlashMessage;
class MyEventListener {
public function __invoke(ModifyGenericBackendMessagesEvent $event): void
{
// Add a custom message
$event->addMessage(new FlashMessage('My custom message'));
}
}
Copied!
Impact¶
The PSR-14 event allows to add or alter messages that are displayed in the "About" module (default start module of the TYPO3 Backend).
Extensions such as "Reports" already use this event to display custom messages based on the status of the system.