Breaking: #78581 - Hook getFlexFormDSClass no longer called¶
See forge#78581
Description¶
With the deprecation of BackendUtility::getFlexFormDS()
the hook getFlexFormDSClass
is
no longer called and there is no substitution available.
Impact¶
The hook is no longer called and flex form field manipulation by extensions does not happen anymore.
Affected Installations¶
Extensions that extension flex form data structure definitions and use the hook getFlexFormDSClass
for that purpose.
Migration¶
Method BackendUtility::getFlexFormDS()
has been split into the methods
FlexFormTools->getDataStructureIdentifier()
and FlexFormTools->parseDataStructureByIdentifier()
.
Those two new methods now provide four hooks to allow manipulation of the flex form data structure location and parsing. The methods and hooks are documented well, read their description for a deeper insight on which combination is the correct one for a specific extension need.
The new hooks are very powerful and must be used with special care to be as future proof as possible.
Since the old hook is used by some widespread extensions, the core team prepared a transition for some of them beforehand:
EXT:news: The extension used the old hook to only remove a couple of fields from the flex form definition. This has been moved over to a "FormEngine" data provider: news
EXT:flux: Flux implements a completely own way of locating and pointing to the flex form data structure that is needed in a specific context. The default core resolving does not work here. Flux now implements the hooks
getDataStructureIdentifierPreProcess
andparseDataStructureByIdentifierPreProcess
to specify an own "identifier" syntax and to resolve that syntax to a data structure later: fluxEXT:gridelements: Similar to flux, gridelements has a own logic to choose which specific data structure should be used. However, the data structures are located in database row fields, so the "record" syntax of the core can be re-used to refer to those. gridelements uses the hook
getDataStructureIdentifierPreProcess
together with a small implementation inparseDataStructureByIdentifierPreProcess
for a fallback scenario: gridelementsEXT:powermail: Powermail allows extending and changing existing flex form data structure definition depending on page TS. To do that, it now implements hook
getDataStructureIdentifierPostProcess
to add the needed pid to the existing identifier, and then implements hookparseDataStructureByIdentifierPostProcess
to manipulate the resolved data structure: powermail