---
title: "Breaking: Renamed itemsProcFunc handler classes to FormEngine namespace"
manual: "Academic Profiles"
version: "3.0"
permalink: "https://docs.typo3.org/permalink/fgtclb/academic-persons:breaking-1783613367@3.0"
source: "Changelog/2.4/Breaking-RenamedItemsProcFuncClassesToFormEngineNamespace.rst"
rendered: "2026-10-26T17:55:22+00:00"
---

# Breaking: Renamed `itemsProcFunc` handler classes to `FormEngine` namespace {#breaking-1783613367}

## Description {#description}

While introducing the shared PSR-14 event
`\FGTCLB\AcademicBase\Event\ModifyTcaSelectFieldItemsEvent` to allow
modifying the select items of fields populated by an `itemsProcFunc`, the two
`itemsProcFunc` handler classes shipped by `EXT:academic_persons` received a
proper namespace and class names suitable for classes providing
`itemsProcFunc` implementations.

The following classes have been renamed and moved:

-   `\FGTCLB\AcademicPersons\Backend\Form\ContractItemsProcFunc` is now
    `\FGTCLB\AcademicPersons\Backend\FormEngine\ContractItems`.
-   `\FGTCLB\AcademicPersons\Backend\Form\ProfileShowFieldsItemProcFunc`
    is now `\FGTCLB\AcademicPersons\Backend\FormEngine\ProfileShowFieldsItems`.

Additionally the entry method of the profile show fields handler has been
streamlined from `showFields()` to `itemsProcFunc()` to match the
other handlers.

The references to these classes in the shipped plugin FlexForms have been
adjusted accordingly.

## Impact {#impact}

A reference to one of the old class names or to the old `showFields()`
method fails with an error as soon as the backend form that uses it is
rendered. This affects TCA and FlexForm `itemsProcFunc` configurations,
projects extending or replacing these classes and any code instantiating them
directly.

## Affected Installations {#affected-installations}

Installations that reference the old classes in own TCA/FlexForm
configuration, extend or replace them, or call them directly.

## Migration {#migration}

Replace all usages of the old class names with the new ones and use the
`itemsProcFunc()` method for both handlers:

```text
FGTCLB\AcademicPersons\Backend\Form\ContractItemsProcFunc->itemsProcFunc
=> FGTCLB\AcademicPersons\Backend\FormEngine\ContractItems->itemsProcFunc

FGTCLB\AcademicPersons\Backend\Form\ProfileShowFieldsItemProcFunc->showFields
=> FGTCLB\AcademicPersons\Backend\FormEngine\ProfileShowFieldsItems->itemsProcFunc
```

Projects that only replaced the shipped items should consider using the new
`\FGTCLB\AcademicBase\Event\ModifyTcaSelectFieldItemsEvent` event listener
instead of a custom `itemsProcFunc`.