{'!Form' | snippet : [
    'validator'             => [
        // Name field required.
        'name'                  => 'required',
        
        // Phone field required and phone validator.
        'phone'                 => ['phone', 'required'],
        
        // Email field required and email validator.
        'email'                 => ['email', 'required'],
        
        // Content field required.
        'content'               => 'required',
        
        // Age field required and age validator with the minimum age of 18.
        'age'                   => [
            'age'                   => 18,
            'required'              => true
        ],
        
        // License field required and minLength for 8 if the age field has the minimum age of 18.
        'license'               => [
            'validateIf'            => [
                'age'                   => [
                    'age'                   => 18
                ],
                'validator'             => [
                    'minLength'             => 10,
                    'required'              => true
                ]
            ]
        ]
    ],
    'validatorMessages'     => [
        'required'              => 'This field is required'
    ]
]}

{'!Form' | snippet : [
    'plugins'               => [
        'recaptcha'             => [
            'version'               => 'v3' // Can be v2 or v3.
        ]
    ]
]}

{'!Form' | snippet : [
    'plugins'               => [
        'email'                 => [
            'subject'               => 'Title of the email.',
            'emailTo'               => 'The e-mailadress to sent the email to.',
            'emailToField'          => 'The name of the field to get the e-mailadress to sent the email to.',
            'emailFrom'             => 'The e-mailadress to sent from.',
            'tpl'                   => 'The template of the email.'
        ]
    ]
]}

{'!Form' | snippet : [
    'plugins'               => [
        'email'                => [
            'subject'               => 'Title of the email.',
            'emailTo'               => 'The e-mailadress to sent the email to.',
            'emailToField'          => 'The name of the field to get the e-mailadress to sent the email to.',
            'emailFrom'             => 'The e-mailadress to sent from.',
            'tpl'                   => 'The template of the email.'
        ],
        'email2'                => [
            'subject'               => 'Title of the second email.',
            'emailTo'               => 'The e-mailadress to sent the second email to.',
            'emailToField'          => 'The name of the field to get the e-mailadress to sent the second email to.',
            'emailFrom'             => 'The e-mailadress to sent from.',
            'tpl'                   => 'The template of the second email.'
        ],
        'email3'                => [
            'subject'               => 'Title of the third email.',
            'emailTo'               => 'The e-mailadress to sent the third email to.',
            'emailToField'          => 'The name of the field to get the e-mailadress to sent the third email to.',
            'emailFrom'             => 'The e-mailadress to sent from.',
            'tpl'                   => 'The template of the third email.'
        ]
    ]
]}

{'!Form' | snippet : [
    'validator'             => [
        'name'                  => [
            'test'                  => [ // Classname will be called TestFormValidator
                'option_1'              => 'value 1',
                'option_2'              => 'value 2',
                'option_3'              => 'value 3',
            ]
        ]
    ],
    
    'plugins'               => [
        'test'                  => [ // Classname will be called TestFormPlugin
            'option_1'              => 'value 1',
            'option_2'              => 'value 2',
            'option_3'              => 'value 3'
        ]
    ],
]}

<?php

if ($modx->event->name === 'onFormHandle') {
    include_once MODX_CORE_PATH . 'components/site/elements/form/testformplugin.php';
    include_once MODX_CORE_PATH . 'components/site/elements/form/testformvalidator.php';
}

<?php

class TestFormPlugin extends DefaultFormPlugin
{
    /**
     * @access public.
     * @return Boolean.
     */
    public function onValidatePost()
    {
        // This test plugin will fired on the onValidatePost form event.

        return false;
    }
}

<?php

class TestFormValidator extends DefaultFormValidator
{
    /**
     * @access public.
     * @param Mixed $value.
     * @param Mixed $properties.
     * @param Array $values.
     * @return Boolean|String.
     */
    public function validate($value, &$properties = null, array $values = [])
    {
        // This test validator will fired when validating a form.

        return false;
    }
}

{'!Form' | snippet : [
    'plugins'               => [
        'mailchimp'             => [
            'list_id'               => 'The id of the MailChimp list',
            'double_optin;          => true
        ]
    ]
]}

<?php

    /**
     * Custom snippet with the name: MailChimp.
     *
     * Available parameters:
     * @param $event, the name of the event (onBeforePost, onValidatePost or onAfterPost).
     * @param $properties, the properties of the plugin. In this example it contains 'list' and 'double_optin'.
     * @param $form, the form object. $form->getCollection() contains the values object, $form->getValidator() contains the validator object.
     */

    // Gets triggered before the form renders.
    if ($event === FormEvents::BEFORE_POST) {
        $form->getCollection()->setValue('email', '[email protected]');
        
        return true;
    }
    
    // Gets triggered during the form validation (after the validation rules)
    if ($event === FormEvents::VALIDATE_POST) {
        $email = $form->getCollection()->getValue('email');
        
        if (empty($email)) {
            $form->getValidators()->setError('email', 'E-mailaddress is required.');
            
            return false;
        }
        
        return true;
    }
    
    // Gets triggered after a succeed form validation.
    // CURL to the MailChimp API, $properties['list_id'], $properties['double_optin'].
    if ($event === FormEvents::VALIDATE_SUCCESS) {
        $state = curl...
        
        if (!$state) {
            $form->getValidators()->setError('email', 'An error has occurred during the MailChimp api call.');
            
            return false;
        }
        
        return true;
    }
    
    return true;
    
?>

<form novalidate action="{$action}" method="{$method}" class="form {$active ? 'form-active' : ''}">
    {$error_message}
    
    <!-- Name field -->
    <div class="form-group required {$_pls['errors']['name']['error'] ? 'form-group--error' : ''}">
        <label for="name">Name *</label>
        <div class="form-control-wrapper">
            <input type="text" name="name" id="name" class="form-control" value="{$_pls['values']['name']}" /> {$_pls['errors']['name']['error']}
        </div>
    </div>
    
    <!-- Phone field -->
    <div class="form-group required {$_pls['errors']['phone']['error'] ? 'form-group--error' : ''}">
        <label for="phone">Phone *</label>
        <div class="form-control-wrapper">
            <input type="tel" name="phone" id="phone" class="form-control" value="{$_pls['values']['phone']}" /> {$_pls['errors']['phone']['error']}
        </div>
    </div>
    
    <!-- Email field -->
    <div class="form-group required {$_pls['errors']['email']['error'] ? 'form-group--error' : ''}">
        <label for="email">E-mail *</label>
        <div class="form-element-wrapper">
            <input type="email" name="email" id="email" class="form-control" value="{$_pls['values']['email']}" /> {$_pls['errors']['email']['error']}
        </div>
    </div>
    
    <!-- Content field -->
    <div class="form-group required {$_pls['errors']['content']['error'] ? 'form-group--error' : ''}">
        <label for="content">Question *</label>
        <div class="form-control-wrapper">
            <textarea name="content" id="content" class="form-control form-control--textarea">{$_pls['values']['content']}</textarea> {$_pls['errors']['content']['error']}
        </div>
    </div>
    
    <!-- Recaptcha plugin output -->
    <div class="form-group {$_pls['errors']['recaptcha']['error'] ? 'form-group--error' : ''}">
        <div class="form-control-wrapper">
            {$_pls['plugins']['recaptcha']['output']} {$_pls['errors']['recaptcha']['error']}
        </div>
    </div>
    
    <!-- Submit button -->
    <div class="form-group">
        <div class="form-control-wrapper">
            <button type="submit" class="btn" name="{$submit}" title="Submit">Submit</button>
        </div>
    </div>
</form>