Step to migrate from "phorax/formhandler" to "jakota/formhandler" in TYPO3 V11 and PHP 8

[Oktopuce]

I try to replace the old form handler with the new one you you wrote but I can't find documentation, the documentation is not available on TER.

Are there a document explaining how to migrate from old extension "phorax/formhandler" to this one.

For example, it seems that this TypoScript configuration :

plugin.Tx_Formhandler.settings.predef {

have to be changed like this :

plugin.tx_formhandler_pi1.settings.predef {

Are there other migration to do ?

[tlueder]

Hi @Oktopuce, Thanks for raising this issue.

As of now there is now no guide on how to migrate.
The version 8.x.x should be a plug in replacement. But older versions allowed non standard config and this is not the case with our version anymore. Maybe we should add an example from to show the best practice. And add a small guide on what to look out for.

Please have a look at this example form.
#108 (comment)

And yes, changing the TS path is a must, as this is one of the things that was broken before.
I also would recommend to use full class path like

class = \Typoheads\Formhandler\Validator\DefaultValidator

But this is not enforced for now.

If you find more things you have to change to make old forms work, please add them here and I'll prepare a migration guide.

Thanks

[Oktopuce]

The langFile syntax should be moved from:

plugin.tx_formhandler_pi1.settings.predef.privatisation {
    langFile {
        1 = EXT:my_ext/Resources/Private/Templates/Formhandler/masterlocallang.xlf
        2 = EXT:my_extResources/Private/Templates/Formhandler/privatisation/locallang.xlf
    }
}

to

plugin.tx_formhandler_pi1.settings.predef.privatisation {
   langFile {
    1 = TEXT
    1.value = EXT:my_ext/Resources/Private/Templates/Formhandler/masterlocallang.xlf
    2 = TEXT
    2.value = EXT:my_extResources/Private/Templates/Formhandler/privatisation/locallang.xlf
  }