---
title: "Important: Extended ProjectDemand and demand handling"
manual: "Academic Projects"
version: "3.0"
permalink: "https://docs.typo3.org/permalink/fgtclb/academic-projects:important-ace-250-academic-projects@3.0"
source: "Changelog/2.4/Important-ExtendedProjectDemandSignatures.rst"
rendered: "2026-10-26T17:55:40+00:00"
---

# Important: Extended `ProjectDemand` and demand handling {#important-ace-250-academic-projects}

## Description {#description}

To support the new "Show hidden records" plugin option, the project
demand pipeline gained a new transport flag:

-   `\FGTCLB\AcademicProjects\Domain\Model\Dto\ProjectDemand` has a new
    `bool $showHiddenRecords` property with
    `setShowHiddenRecords(bool): void` and
    `getShowHiddenRecords(): bool` accessors (default `false`).
-   `\FGTCLB\AcademicProjects\Factory\DemandFactory::createDemandObject()`
    now reads `$settings['showHiddenRecords']` and sets the flag on the
    demand object.
-   `\FGTCLB\AcademicProjects\Domain\Repository\ProjectRepository::findByDemand()`
    honours the flag: when it is `true`, the query ignores only the
    `disabled` enable field, the `hidden` column, through the
    Extbase query settings.

The public method signatures of `DemandFactory::createDemandObject()`
and `ProjectRepository::findByDemand()` are unchanged.

## Impact {#impact}

The change is non-breaking: the new flag defaults to `false` and no
existing method signature changed. Projects that build a
`ProjectDemand` themselves can opt in by calling
`setShowHiddenRecords(true)`.

## Affected Installations {#affected-installations}

Only installations that extend or replace the `ProjectDemand` DTO,
the `DemandFactory` or the `ProjectRepository` need to take the
added flag into account. All other installations are unaffected.
