CustomFileSelectorsEvent 

New in version 14.2

The PSR-14 event \TYPO3\CMS\Backend\Form\Event\CustomFileSelectorsEvent is dispatched in \TYPO3\CMS\Backend\Form\Container\FilesControlContainer during rendering of the selectors of relations to sys_file_reference.

The event was introduced to add additional file controls and make it easier for extension developers to integrate DAM systems.

Example: Add the file selector of a DAM system 

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

declare(strict_types=1);

namespace MyVendor\MyExtension\Backend\EventListener;

use TYPO3\CMS\Backend\Form\Event\CustomFileSelectorsEvent;
use TYPO3\CMS\Core\Attribute\AsEventListener;

#[AsEventListener(
  identifier: 'my-extension/backend/custom-file-selector',
)]
final readonly class MyEventListener
{
  public function __construct(
    private CustomDamFileSelector $damFileSelector,
  ) {}

  public function __invoke(CustomFileSelectorsEvent $event): void
  {
    $result = $this->damFileSelector->renderFileSelector(
      $event->getFormFieldIdentifier(),
    );
    $event->setSelectors(array_merge(
      $event->getSelectors(),
      $result['control'],
    ));
    $event->setJavascriptModules(array_merge(
      $event->getJavascriptModules(),
      $result['javaScriptModule'],
    ));
  }
}
Copied!

API 

final class CustomFileSelectorsEvent
Fully qualified name
\TYPO3\CMS\Backend\Form\Event\CustomFileSelectorsEvent

Listeners to this Event will be able to add custom file selectors to a TCA type="file" field in FormEngine

getSelectors()
Returns
array
setSelectors(array $selectors)
param $selectors

the selectors

getJavascriptModules()
Returns
array
setJavascriptModules(array $javascriptModules)
param $javascriptModules

the javascriptModules

getTableName()
Returns
string
getFieldName()
Returns
string
getDatabaseRow()
Returns
array
getFieldConfig()
Returns
array
getFileExtensionFilter()
Returns
\TYPO3\CMS\Core\Resource\Filter\FileExtensionFilter
getFormFieldIdentifier()
Returns
string