Formhandler (TYPO3 v11) --> Formhandler (TYPO3 v12)

[iamwebrocker]

Hi,

is there a documentation of the changes needed for a setup thats working fine in TYPO3 v11 (with the 8.x branch of Formhandler) to TYPO3 v12.4.x (with Formhandler 9.x (? is that the right version? or does v8.x work in v12 - maybe I borked it and prematurely assumed I need v9)

I assume from looking through the typoscript of v9.0 that

• plugin.tx_formhandler_pi1. has changed to plugin.tx_formhandler_form.
• the Classes and settings for the validators, finishers etc have changed (?)

from, for example:

… settings.loggers {
  10 {
    class =  \Typoheads\Formhandler\Logger\DB
    config {
      disableIPlog = 1
    }
  }
}

to

… settings.loggers {
  Database {
    model =  Database
    config {
      disableIPlog = 1
    }
  }
}

and the form rendering is now in fluid and no more marker based template?
currently I'm stuck. I don't get any errors, but I don't get a form in the frontend, so any hints are greatly appreciated :)

thanks so much for keeping Formhandler alive,
Best,
Tom

[tlueder]

Hi @iamwebrocker ,

the migration guide is still on our todo list.
Indicated by 9.0.0-Alphaxx, but we are using v9 in production projects for both use cases Headless and Serverside rendering. And adding new features as needed.

I also have documented most of the setup here https://formhandler.jakota.dev/.
The docs for mail setup is still missing.

You will also find my dev examples here https://github.com/JAK0TA/formhandler/tree/main/Configuration/TypoScript/Example

Here the logger code:

  loggers {
    Database {
      model = DatabaseLogger
    }
  }

I'm using them to test new stuff but have not updated the code for a while.

And Yes, no more marker based template :)

You can just send me your form TS and i'll have a quick look.

[iamwebrocker]

Hi @tlueder,
thanks for the info and the fast reply :)

And Yes, no more marker based template :)

ok, so I'll try and get something to show up in the FE first and then tweak my TS. Many thanks for the quick look, will come back to that.

[iamwebrocker]

Here is the TS which is working in TYPO3 v11 currently.

There are some special things in there - a dynamically built select based on some tt_news articles which has an option preselected when coming from one of those tt_news articles. Since now the template is fluid and not markerbased, the markers { form_organisation = TEXT … thing needs to be refactored I'm afraid. So maybe best to ignore this for now

# dont log IP addresses
plugin.tx_formhandler_form.settings.loggers {
  10 {
    class =  \Typoheads\Formhandler\Logger\DB
    config {
      disableIPlog = 1
    }
  }
}

plugin.tx_formhandler_form.settings {
	templateFile     = EXT:site_foo/Resources/Private/Extensions/formhandler/form_foo/form.tpl.html
	formValuesPrefix = formhandler

	markers {
		form_organisation = TEXT
		form_organisation.value = {$formOrganisation}

		field_sender_job_select = CONTENT
		field_sender_job_select {
			stdWrap.wrap = <select id="sender_application--offer" name="formhandler[sender_application]">|</select>
			stdWrap.innerWrap = <option value="">Bitte wählen</option>|

			table = tt_news
			select {
				pidInList = {$managePID}
				selectFields = uid,title
				where.data = date:U
				where.noTrimWrap = |hidden=0 AND deleted=0 AND (archivedate>=| OR archivedate=0)|
      		}

			renderObj = COA
			renderObj {				
				5 = LOAD_REGISTER
				5.selected =
				10 = TEXT
				10.dataWrap = <option {REGISTER:selected} value="|">
				10.stdWrap.dataWrap = {field:title} (Ref-Nr: {field:uid})
				10.htmlSpecialChars = 1
				20 = TEXT
				20.field = title
				20.htmlSpecialChars = 1
				20.wrap = |</option>
				999 = RESTORE_REGISTER
			}
		}
	}

	preProcessors {
    	1.class =  \Typoheads\Formhandler\PreProcessor\LoadDefaultValues
		1.config {
			1 {
				sender_organisation.defaultValue = {$formOrganisation}
			}
		}
	}
	saveInterceptors {
		1.class =  \Typoheads\Formhandler\Interceptor\CombineFields
		1.config {
			combineFields {
				sender_fullname {
					fields {
						1 = sender_firstname
						2 = sender_lastname
					}
					separator.noTrimWrap = | | |
					hideEmptyValues = 1
				}
			}
		}
	}
	finishers {
		1 {
			class =  \Typoheads\Formhandler\Finisher\Mail
			config {
				admin {
					to_email = {$formRecipient}
					subject = {$formSubject}
					sender_email = {$formSender}
					replyto_email = sender_email
					replyto_name =  sender_fullname
				}
				user {
					to_email = sender_email
					subject = Vielen Dank für Ihre Bewerbung
					sender_email = {$formSender}
					replyto_email = {$formSender}
					replyto_name = {$formOrganisation}
				}
			}
		}
		2 {
			class =  \Typoheads\Formhandler\Finisher\SubmittedOK
			config.returns = 1
		}
	}
	validators.1.class =  \Typoheads\Formhandler\Validator\Default
	validators.1.disabled = 0
	validators.1.config.fieldConf {
		sender_tel.errorCheck.1 = required
		sender_email.errorCheck.1 = required
		sender_lastname.errorCheck.1 = required
		sender_available.errorCheck.1 = required
		consent.errorCheck.1 = required
	}
	addErrorAnchors = 1
	singleErrorTemplate {
		totalWrap = |
		singleWrap = <span class="error">|</span>
	}
	errorListTemplate {
		totalWrap = <div class="form-errors">Es sind folgende Fehler aufgetreten: <ul class="form-error__list">|</ul></div>
		singleWrap = <li class="list__item">|</li>
	}
}

# test - form wird via angebot (tt_news = 123) aufgerufen,
# dann soll eintrag im select ausgewaehlt sein
## [globalVar = _GET|tx_ttnews|tt_news > 0]

[request.getQueryParams()['tx_news_pi1'] && request.getQueryParams()['tx_news_pi1']['news'] > 0]
	plugin.tx_formhandler_form.settings {
		markers {
			field_sender_job_select {
				renderObj {
					5 {
						selected {
							override = selected
							override {
								if {
									equals.data = gp:tx_ttnews|tt_news
									value.field = uid
								}
							}
						}
					}
				}
			}
		}
	}
[GLOBAL]

[tlueder]

Hi @NMantek, Would you be so kind and take a look what needs to be changed here?

Starting by the namespaces class to model and where to put the template file...

I would add this to the migration guide as an example afterwards.

Thanks