EXT: Formhandler Extbase¶

What does it do?¶

The formhandler_extbase extension gives you the possibility to run Extbase controllers in your preprocessors, interceptors or finishers. Additionally it allows you to use Extbase validators for validating the submitted form values.

Screenshots¶

This is the simple demo form that is included in the extension:

Users manual ------------

The first step, to get this extension up and running is importing it in the extension manager. Since it is based on the formhandler extension you will need to import and install it as a requirement.

Now you are already good to go. Here is an example how to use an Extbase interceptor in your form:

initInterceptors.1 {

        class = Tx_FormhandlerExtbase_Formhandler_ExtbaseInterceptor
        config {
                extensionName = FormhandlerExtbase
                pluginName = DemoInterceptorInit
        }
}

You need to set at least the extensionNameand the pluginNamein the configuration.

At the moment is is not possible to influence the called controller or the called action. The first controller action that is configured for the given plugin will be executed.

This is an example plugin configuration in your ext_localconf.phpfile:

Tx_Extbase_Utility_Extension::configurePlugin(
        $_EXTKEY,
        'DemoInterceptorInit',
        array('Demo' => 'interceptorInit'),
        array('Demo' => 'interceptorInit')
);

When you now use the DemoInterceptorInitplugin the interceptorInitaction will be called in the DemoController.

Using the demo forms¶

The extension comes with some demo forms. When you want to have a look at them you need to add the static TypoScript configuration for the demo forms:

Additionally you need to enable the demo plugin configuration in the extension settings:

Now you can use the demo forms in the formhandler plugin settings:

You can find the files for the demo forms in the extension folder in these directories:

Resources/Private/Forms/Demo

Configuration/TypoScriptDemo

ext_localconf.php

Edit configuration¶

All available classes are configured via TypoScript. The configuration options that are available can be found on the Formhandler homepage and in the Configuration section of this document.

Available classes¶

You can uses these classes in your form configurations. The sections columns tells you, in which section of the formhandler configuration you can use them.

Required settings¶

These settings are required in all classes (except the validator):

Validator settings¶

The settings for extensionNames and pluginName are set to “FormhandlerExtbase” and “Validator” by default. This will run the validateAction in the ValidationController. This action will use Extbase validators to validate the user input.

You can of course use your own controller for validation, but it might be easier to simply write your own Validator.

To setup validation you can use these settings:

validatorOptions {
        minimum = 10
        maximum = 20
}

Writing a controller for formhandler_extbase¶

A controller for formhandler_extbase is not very different from any other controller you develop for Extbase. But there are some things to consider.