---
title: "How to use (Extbase forms <f:form>)"
manual: "mosparo integration for EXT:form and Extbase-based forms"
version: "1.1"
permalink: "https://docs.typo3.org/permalink/denkwerk/mosparo-form:how-to-use-form-extbase@1.1"
source: "HowToUse/Extbase.rst"
rendered: "2026-11-11T13:09:55+00:00"
---

# How to use (Extbase forms \<f:form>) {#how-to-use-form-extbase}

This section explains how to integrate the mosparo form element into an [Extbase form \<f:form>](https://docs.typo3.org/other/typo3/view-helper-reference/14.3/en-us/Global/Form/Index.html#typo3-fluid-form).

1.  Add the validator to your controller

    **EXT:my_extension/Classes/Controller/SearchController.php**

    ```php
    use TYPO3\CMS\Extbase\Annotation\Validate;
    use Denkwerk\MosparoForm\Validation\Validator\MosparoCaptchaValidator;

    ...

    #[Validate(['param' => 'form', 'validator' => MosparoCaptchaValidator::class, 'options' => [
        'selectedProject' => 'example',
        'requiredFields' => 'tx_exampleform_exampleform[form][name],tx_exampleform_exampleform[form][email],'
    ]])]
    public function searchAction(array $search = []): ResponseInterface
    ```

    -   You can specify the mosparo project to be used by setting the `selectedProject` option.
    -   To ensure that all relevant form fields are checked by mosparo, use the `requiredFields` and optionally `verifiableFields` options.

    > [!NOTE]
    > **See also**
    >
    > See the mosparo documentation:\
    > [Ignored fields](https://documentation.mosparo.io/docs/integration/ignored_fields)\
    > [Bypass protection](https://documentation.mosparo.io/docs/integration/bypass_protection)
1.  Include the mosparo Extbase partials in your TypoScript configuration\
    We include the partials because mosparo provides a custom Fluid partial `/Resources/Private/Frontend/Partials/ExtbaseForms/MosparoCaptcha.html` that renders the required HTML container, loads the JavaScript, and applies the selected configuration automatically.

    **EXT:my_extension/Configuration/TypoScript/setup.typoscript**

    ```typoscript
    plugin.tx_blogexample {
       view {
         templateRootPaths.10 = {$plugin.tx_blogexample.view.templateRootPath}
         partialRootPaths.10 = {$plugin.tx_blogexample.view.partialRootPath}
         partialRootPaths.20 = EXT:mosparo_form/Resources/Private/Frontend/Partials/ExtbaseForms/
         layoutRootPaths.10 = {$plugin.tx_blogexample.view.layoutRootPath}
       }
    }
    ```

    > [!NOTE]
    > For more information, see the TYPO3 documentation: [Overriding Fluid template paths via TypoScript](https://docs.typo3.org/m/typo3/reference-coreapi/14.3/en-us/ExtensionArchitecture/Extbase/View/Index.html#extbase-view-configuration)
1.  Render the mosparo partial in your form template\
    **Minimal**:

    **EXT:my_extension/Resources/Private/Templates/Form/Form.html**

    ```html
    <f:render partial="MosparoCaptcha" />
    ```

    **Full configuration**:

    **EXT:my_extension/Resources/Private/Templates/Form/Form.html**

    ```html
    <f:render partial="MosparoCaptcha" arguments="{
        selectedProject: 'default',
        formId: 'form'
    }" />
    ```

    -   Use the `selectedProject` argument to choose a specific mosparo project.\
        If omitted, the default project will be used.
    -   To enable dynamic enabling/disabling of the submit button based on mosparo validation, pass the form’s HTML id as the `formId` argument.\
        The JavaScript included by the partial will then control the first submit button found in the form.\
        If formId is not set or empty, this functionality will be disabled.
    -   When using Invisible Mode, the submit button will automatically be enabled after mosparo is initialized.
1.  Display validation errors\
    If validation fails and you don't render the error output, users won't see any feedback.

    **EXT:my_extension/Resources/Private/Templates/Form/Form.html**

    ```html
    <f:form.validationResults for="form">
        <f:if condition="{validationResults.errors}">
            <ul>
                <f:for each="{validationResults.errors}" as="error">
                    <li>{error.message}</li>
                </f:for>
            </ul>
        </f:if>
    </f:form.validationResults>
    ```

    > [!NOTE]
    > For more information, see the TYPO3 documentation: [Form.validationResults ViewHelper \<f:form.validationResults>](https://docs.typo3.org/other/typo3/view-helper-reference/14.3/en-us/Global/Form/ValidationResults.html#typo3-fluid-form-validationresults)