Breaking: Renamed itemsProcFunc handler classes to FormEngine namespace 

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 

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 

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

Migration 

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

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

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

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