ModifyAllowedItemsEvent¶

New in version 12.0

This event has been introduced together with ModifyLinkHandlersEvent to serve as a direct replacement for the following removed hook $GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['LinkBrowser']['hooks']. It replaces the method modifyAllowedItems() in this hook.

The PSR-14 event \TYPO3\CMS\Backend\Controller\Event\ModifyAllowedItemsEvent allows extension authors to add or remove from the list of allowed link types.

Example¶

EXT:my_extension/Classes/Backend/EventListener/MyEventListener.php

<?php

declare(strict_types=1);

namespace MyVendor\MyExtension\Backend\EventListener;

use TYPO3\CMS\Backend\Controller\Event\ModifyAllowedItemsEvent;
use TYPO3\CMS\Core\Attribute\AsEventListener;

#[AsEventListener(
    identifier: 'my-extension/backend/allowed-items',
)]
final readonly class MyEventListener
{
    public function __invoke(ModifyAllowedItemsEvent $event): void
    {
        $event->addAllowedItem('someItem');
        $event->removeAllowedItem('anotherItem');
    }
}

New in version 13.0

The PHP attribute \TYPO3\CMS\Core\Attribute\AsEventListener has been introduced to tag a PHP class as an event listener. Alternatively, or if you need to be compatible with older TYPO3 versions, you can also register an event listener via the Configuration/Services.yaml file. Switch to an older version of this page for an example or have a look at the section Implementing an event listener in your extension.

API¶

class \TYPO3\CMS\Backend\Controller\Event\ ModifyAllowedItemsEvent¶

This event allows extensions to add or remove from the list of allowed link types.

getAllowedItems ( ) ¶

returntype: array

Returns:: string[]

addAllowedItem ( string $item) ¶

param string $item: the item
returntype: self

removeAllowedItem ( string $new) ¶

param string $new: the new
returntype: self

getCurrentLinkParts ( ) ¶

returntype: array

Returns:: array<string,mixed>