This project is no longer maintained and no further public releases are planned.

No further support will be given.

Feel free to fork the git repository.

Version 1.1.0

The complete changelog is available on Forge.

AJAX Stuff

Disable submit button if form is not valid

If you use AJAX validation, you can now disable the submit button until all error checks are valid.

In order to achieve this, you have to set autoDisableSubmitButton in the ajax config. To be able to style the submit button or other stuff based on the validation status, you can add the marker ###validation-status### to your form.

Take a look at the examples page to find a working example.

AJAX submit

If you set the new TS option ajaxSubmit in the ajax config, the form is submitted using an AJAX post request. After the user clicks submit, a loading animation is shown.

You can customize this animation using the setting ajaxSubmitLoader. The marker ###loading_ajax-submit### is replaced with the loading animation or text configured in ajaxSubmitLoader.

Take a look at the examples page to find a working example.

Backend Module

CSV export can use special keywords

Logger_DB stores special values in the database along with the submitted form values. Now you can use these values in both PDF and CSV export in the backend module.

tx_formhandler_mod1.config {
  csv = ip,submission_date,pid,name,email,message
  pdf = ip,submission_date,pid,name,email,message
Usage of the special keywords "ip", "submission_date" and "pid"

Use your own Generator in the backend module

The backend module of Formhandler can export PDF and CSV files of the submitted form values. If you are not satisfied with the output or need additional data, you can now easily add your own generators.

If you want to know how your custom generators must look like, just copy the built-in ones and start customizing.

You can now set additionalIncludePaths in the backend module too and there is a new setting generators for PDF and CSV to set your custom classes.

tx_formhandler_mod1.config {
  additionalIncludePaths {
    1 = fileadmin/templates/scripts/
  generators {
    csv = Tx_Formhandler_Generator_MyCSV
    pdf = Generator_MyPDF

Frontend View

New TS option to disable the default wrap

There is a new TS option called disableWrapInBaseClass that lets you disable the default wrap of the form with

Error Checks

Check if an email address exists

In version 1.1.0 there is a new error check emailExists. If the user enters an email address like "user@example.tld", Formhandler checks if a valid MX record exists for the domain "example.tld".