ModifyLinkHandlersEvent
New in version 12.0
This event has been introduced together with
ModifyAllowedItemsEvent to
serve as a direct replacement for the following removed hook
$GLOBALS.
It replaces the method modify in this hook.
The PSR-14 event
\TYPO3\
is triggered before link handlers are executed, allowing listeners
to modify the set of handlers that will be used.
Example
Registration of the event listener in the extension's Services.:
services:
# Place here the default dependency injection configuration
MyVendor\MyExtension\Backend\EventListener\MyEventListener:
tags:
- name: event.listener
identifier: 'my-extension/backend/link-handlers'
Read how to configure dependency injection in extensions.
The corresponding event listener class:
<?php
declare(strict_types=1);
namespace MyVendor\MyExtension\Backend\EventListener;
use TYPO3\CMS\Backend\Controller\Event\ModifyLinkHandlersEvent;
final class MyEventListener
{
public function __invoke(ModifyLinkHandlersEvent $event): void
{
$handler = $event->getLinkHandler('url.');
$handler['label'] = 'My custom label';
$event->setLinkHandler('url.', $handler);
}
}
API
- class ModifyLinkHandlersEvent
-
- Fully qualified name
-
\TYPO3\
CMS\ Backend\ Controller\ Event\ Modify Link Handlers Event
This event allows extensions to modify the list of link handlers and their configuration before they are invoked.
- getLinkHandler ( string $name)
-
Gets an individual handler by name.
- param $name
-
The handler name, including trailing period.
- Return description
-
The handler definition, or null if not defined.
- Returns
-
array<string,mixed>|null