ModifyButtonBarEvent 

The PSR-14 event \TYPO3\CMS\Backend\Template\Components\ModifyButtonBarEvent can be used to modify the button bar in the TYPO3 backend module docheader.

The Reload and Bookmark buttons that TYPO3 adds to every module are already in the button bar when the event is dispatched, so a listener can change or remove them as well.

Example 

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

declare(strict_types=1);

namespace MyVendor\MyExtension\Backend\EventListener;

use TYPO3\CMS\Backend\Template\Components\ModifyButtonBarEvent;
use TYPO3\CMS\Core\Attribute\AsEventListener;

#[AsEventListener(
  identifier: 'my-extension/backend/modify-button-bar',
)]
final readonly class MyEventListener
{
  public function __invoke(ModifyButtonBarEvent $event): void
  {
    // Do your magic here
  }
}
Copied!

API 

final class ModifyButtonBarEvent
Fully qualified name
\TYPO3\CMS\Backend\Template\Components\ModifyButtonBarEvent

PSR-14 event that allows listeners to modify the buttons in the backend module document header button bar. This event is dispatched after all buttons have been added to the button bar, but before they are rendered.

Use cases: - Add custom buttons to existing modules - Remove or hide buttons based on conditions - Modify button properties (labels, icons, etc.) - Reorder buttons

Example event listener:

use TYPO3\CMS\Backend\Template\Components\ModifyButtonBarEvent;
use TYPO3\CMS\Backend\Template\Components\ButtonBar;
use TYPO3\CMS\Backend\Template\Components\ComponentFactory;
use TYPO3\CMS\Core\Attribute\AsEventListener;

final class MyButtonBarListener
{
    public function __construct(
        protected readonly ComponentFactory $componentFactory,
    ) }

    #[AsEventListener]
    public function __invoke(ModifyButtonBarEvent $event): void
    {
        $buttons = $event->getButtons();
        $buttonBar = $event->getButtonBar();

        $myButton = $this->componentFactory->createLinkButton()
            ->setHref('/my-action')
            ->setTitle('My Action')
            ->setIcon($iconFactory->getIcon('actions-heart'));

        $buttons[ButtonBar::BUTTON_POSITION_RIGHT][1][] = clone $myButton;

        $event->setButtons($buttons);
    }
}
Copied!
getButtons()
Returns
\TYPO3\CMS\Backend\Template\Components\Buttons
setButtons(\TYPO3\CMS\Backend\Template\Components\Buttons $buttons)
param $buttons

the buttons

getButtonBar()
Returns
\TYPO3\CMS\Backend\Template\Components\ButtonBar
getRequest()
Returns
\Psr\Http\Message\ServerRequestInterface