« previous module | next module »

Extensions » Modules » Submission Pre-Parser

Documentation Translations Download

Submission Pre-Parser

The Submission Pre-Parser module provides you with a simple UI to add your own PHP to examine and change the incoming POST data, before it gets added to the database. The module is actually just a visual wrapper for three Form Tools hooks: the ones that get executed in the ft_process_form, ft_api_process_form and ft_update_submission functions. These are the three main submission insert and update functions.

There's no reason why you can't utilize these hooks in your own modules, but we found that modifying the data prior to submission is such a useful feature, it warranted its own module.

Modifying and accessing the form data prior to submission has a number of uses, for example:

  • If you need to group multiple form fields into one for simpler presentation in the Form Tools UI (e.g. if your form has a telephone number field split into 3 smaller fields).
  • The opposite: you need to split a single form field into multiple fields.
  • You want to ignore submissions that contain certain values in certain fields (e.g. this can be really handy for spam detection)
  • You want to execute custom code submissions with particular field values (e.g. adding to another database)

The following sections explain the basic usage of the module and include some simple examples.

No comments have been made on this page.

You need to be logged in to post a comment. Log in here or click here to get an account!