---
title: "ModifyProfileDemandEvent"
manual: "Academic Profiles"
version: "main"
permalink: "https://docs.typo3.org/permalink/fgtclb/academic-persons:developers-event-modify-profile-demand-event@main"
source: "Developers/Events/ModifyProfileDemandEvent.rst"
rendered: "2026-10-15T10:24:29+00:00"
---

# ModifyProfileDemandEvent {#developers-event-modify-profile-demand-event}

`\FGTCLB\AcademicPersons\Event\ModifyProfileDemandEvent` hands a listener
the demand a profile list is about to be queried with, before the query is
built from it. A listener replaces the demand, and the query, the letters of
the letter navigation and the page cache lifetime follow the replacement.

## When it is dispatched {#when-it-is-dispatched}

`ProfileRepository` dispatches the event before it builds a query from a
demand:

-   **List and list-and-detail plugins**, list action: once for the profiles
    of the list, with the demand of the request after the settings of the
    content element and the filters of the visitor were adopted.
    [ModifyProfileQueryEvent](https://docs.typo3.org/permalink/fgtclb/academic-persons:developers-event-modify-profile-query-event@main) follows.
-   Once more, on a copy of that demand, while the content element shows only
    contracts valid today, for the next day on which the list changes. That
    day caps the page cache lifetime. A demand with profiles selected by hand
    is not asked.
-   Once more, on a copy of that demand without the letter, while the content
    element shows the letter navigation and no profiles are selected by hand,
    for the letters that lead to a list that is not empty, see
    [Which letters lead somewhere](https://docs.typo3.org/permalink/fgtclb/academic-persons:developers-letter-availability@main).
-   **Card plugin**: once for the profiles of the card, with a demand of its
    own that carries the selection of the card, the language fallback and
    the hidden records setting, and nothing else.

The detail, selected-profiles and selected-contracts plugins do not dispatch
it. Neither does the filter form of the list, which only redirects to the list
it asks for.

## What a listener reads and changes {#what-a-listener-reads-and-changes}

| Method | What it does |
| --- | --- |
| `getDemand()` | The demand, typed `DemandInterface`. The plugins pass a `\FGTCLB\AcademicPersons\Domain\Model\Dto\ProfileDemand`. |
| `setDemand()` | Replaces the demand the query is built from. |

What the query reads from the demand: the storage folders, the profiles
selected by hand, the grouping, the sort field and its direction, the letter,
the function types and organisational units of the content element, the two
filters of the visitor, the language fallback, the hidden records setting and
whether only contracts valid today count. A sort field or a grouping that is
not one of the allowed values of the extension configuration is ignored.

The event carries no plugin context. A listener that has to tell the plugins
apart reads the demand, a selection by hand for example, or uses
[ModifyProfileQueryEvent](https://docs.typo3.org/permalink/fgtclb/academic-persons:developers-event-modify-profile-query-event@main), which carries the context.

## Example {#example}

A site wants every list for which an editor chose **No sorting** to
come out by last name rather than in the order the profiles were created:

**EXT:my_extension/Classes/EventListener/SortUnsortedListsByLastName.php**

```php
<?php

declare(strict_types=1);

namespace MyVendor\MyExtension\EventListener;

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

final class SortUnsortedListsByLastName
{
    #[AsEventListener(identifier: 'my-extension/sort-unsorted-lists-by-last-name')]
    public function __invoke(ModifyProfileDemandEvent $event): void
    {
        $demand = $event->getDemand();
        // A selection by hand keeps the order of the selection anyway.
        if ($demand->getSortBy() !== '' || $demand->getProfileList() !== '') {
            return;
        }
        $replacement = clone $demand;
        $replacement->setSortBy('lastName');
        $replacement->setSortByDirection('asc');
        $event->setDemand($replacement);
    }
}
```

## Rules and pitfalls {#rules-and-pitfalls}

-   **Hand back a copy through** `setDemand()`. For the list query the
    event carries the list's own demand object, and the list action keeps
    using it after the query: the demand the template receives, and the
    order of a selection by hand, are read from it. A listener that changes
    that object in place changes them as well. The copies of the two further
    calls are not affected.
-   A replaced demand reaches the repository only. It decides which profiles
    are queried, which letters are offered and how long the page is cached.
    The active letter, the pagination, the page, the view mode, the links of
    the navigation and the demand the template receives keep following the
    demand of the request, see [What the navigation links carry](https://docs.typo3.org/permalink/fgtclb/academic-persons:developers-navigation-links@main).
-   Answer all calls for one list alike. A listener that narrows the list but
    not the letters makes the navigation offer letters that lead to an empty
    list.
-   The visitor filters arrive checked: a function type or organisational
    unit the content element does not offer is `0` by then. A value the
    listener sets itself is applied as it is.

## Introduced in {#introduced-in}

The event is part of the extension since its first release. Later changes:

-   [Important: Sort direction is normalised](https://docs.typo3.org/permalink/fgtclb/academic-persons:important-ace-439-academic-persons@main) (2.4) normalises the sort
    direction a listener sets.
-   [Breaking: The list, detail and selection events of the plugins are gone](https://docs.typo3.org/permalink/fgtclb/academic-persons:breaking-removed-profile-view-events@main) made it the place to change
    which profiles a list queries, instead of the removed list event.
-   [Feature: The letter navigation knows which letters lead somewhere](https://docs.typo3.org/permalink/fgtclb/academic-persons:feature-letter-navigation-availability@main) dispatches it for the
    letters as well.
-   [Feature: Visitors filter the list by function type and by unit](https://docs.typo3.org/permalink/fgtclb/academic-persons:feature-1790802602@main) added the two visitor filters to the demand.
-   [Important: The profile queries see a letter switching off the pagination](https://docs.typo3.org/permalink/fgtclb/academic-persons:important-1790607226@main) describes when a letter switches the
    pagination off.