Basic configuration looks like this:
plugin.tx_formhandler {
view {
partialRootPaths.5 = EXT:theme/Resources/Private/Forms/Partials/
}
forms {
myform {
name = My Formhandler Form
view {
templateRootPaths.10 = EXT:theme/Resources/Private/Forms/MyForm/
partialRootPaths.10 = EXT:theme/Resources/Private/Forms/MyForm/Partials/
}
settings {
templateFile = Step1
formValuesPrefix = myform
languageFile = EXT:theme/Resources/Private/Language/myform.xlf
preProcessors {
}
interceptors {
}
validators {
}
finishers {
}
}
}
}
All configured forms are available in the plugin settings in a dropdown field. The setting name is used as a label.
view and settings of each form are merged with the "global" TypoScript in plugin.tx_formhandler. This way you can define global settings like partialRootPaths and merge them with form specific settings.
The HTML-Template may look like this:
<html
data-namespace-typo3-fluid="true"
xmlns:f="http://typo3.org/ns/fluid/ViewHelpers"
xmlns:fh="http://typo3.org/ns/Rfuehricht/Formhandler/ViewHelpers">
<div class="form">
<f:form action="form">
<f:form.hidden name="{formValuesPrefix}[randomId]" value="{randomId}" />
<div>
<f:for each="{validations.{name}}" as="check">
<f:if condition="{check.check} == 'required'">
<f:variable name="isRequired" value="*" />
</f:if>
</f:for>
<label for="{formValuesPrefix}-name">{fh:translate(key: 'label.name')} {isRequired}</label>
<f:form.textfield id="{formValuesPrefix}-name"
name="{formValuesPrefix}[name]"
value="{values.name}"
/>
<f:if condition="{errors.name}">
<ul>
<f:for as="error" each="{fh:errorMessages(field: 'name')}">
<li>{error}</li>
</f:for>
</ul>
</f:if>
</div>
<f:form.submit name="{formValuesPrefix}[{submit.nextStep}]"
value="{fh:translate(key: 'label.submit')}"
/>
</f:form>
</div>That is all for a very simple and basic form.
Have a look at the documentation for more details about available
and much more.