ModifyProfileImageMetadataEvent 

When it is dispatched 

It is dispatched for each of the two records that carry image metadata, and getTargetTable() says which one:

The upload of the frontend editing of fgtclb/academic-persons-edit dispatches the event for the file first and then for the reference. A profile without an image gets no event, and the upload for a profile without a name gets none for the file. The default values are the composed name of the profile record: title, first, middle and last name.

What a listener reads and changes 

Both records are handed over, whichever of them is written. getFile() is the file, whose own metadata record is $event->getFile()->getMetaData() , and getFileReference() is the image relation of the profile, null only for a profile that has none. getProfileUid() is the profile record the image belongs to, a translation for an image of its own, and getRequest() the request the write happens in: the frontend request for an upload or a frontend edit, the backend request for a save, and null on the command line or where the caller has no request to pass on.

Fields the target table does not declare are dropped before the write, so a listener may set a column unconditionally: where the installation does not have it, the value goes nowhere. copyright is one such column. It belongs to sys_file_metadata and typo3/cms-filemetadata , and the relation row has no equivalent.

Example 

An installation that requires a note on the right of use for every image, with fgtclb/file-required-attributes , fills it when a profile image is uploaded:

<?php

declare(strict_types=1);

namespace MyVendor\MyExtension\EventListener;

use FGTCLB\AcademicPersons\Event\ModifyProfileImageMetadataEvent;
use TYPO3\CMS\Core\Attribute\AsEventListener;

final class AddImageRightOfUse
{
    #[AsEventListener(identifier: 'my-extension/add-image-right-of-use')]
    public function __invoke(ModifyProfileImageMetadataEvent $event): void
    {
        if ($event->getTargetTable() !== 'sys_file_metadata') {
            return;
        }
        $metadata = $event->getMetadata();
        $metadata['right_of_use'] = 'Portrait, own use only';
        $event->setMetadata($metadata);
    }
}

Rules and pitfalls 

The two dispatches are not interchangeable. The metadata record of the file is written once, which makes it the place for a value that has to survive, the required attributes of typo3/cms-filemetadata or fgtclb/file-required-attributes , for instance. The reference row is rewritten on every save of the profile, so a listener that wants to own a field there has to set it on every dispatch. One request may write the reference more than once, an upload in the default language does, so a listener sets the same value each time it is called.

When the file or the relation cannot be loaded, the metadata is written without the event, and a warning is logged.

Introduced in 

• Feature: Decide what a profile image's metadata will be introduced the event.
• Important: Backend saves announce profile updates describes why a backend save writes the reference through the DataHandler hook only.