<markdown>
=======================
Add Validation Messages
=======================

The [[Solar_Form::addInvalid()]] method lets you add "validation failed"
messages to an element. These will be in addition to the invalidation messages
automatically generated when you call [[Solar_Form::validate()]].

Note that this method works with messages on **elements**; if you wish
to add messages about the form as a whole, use the [[Solar_Form::$feedback]]
public property.

-------
Example
-------

{{code: php
    require_once 'Solar.php';
    Solar::start('/path/to/config/Solar.config.php');

    $form = Solar::factory('Solar_Form');

    $elements = array(
        'name' => array (
            'type' => 'text',
            'label' => 'Your name:',
        ),
        'email' => array (
            'type' => 'text',
            'label' => 'Email address:',
        ),
    );    

    $form->setElements($elements);

    // for some reason, we want one message on the 'name' ...
    $form->addInvalid('name', 'You really should type in your name.');
    
    // ... and two messages on the 'email'.
    $form->addInvalid('email', array(
            'Be sure to type in your email.',
            'And make it a real one, no fakes!'
    ));

}}

Of course, you can skip all this if you like and add the messages
directly as part of the element to begin with:

{{code: php
    $elements = array(
        'name' => array (
            'type'    => 'text',
            'label'   => 'Your name:',
            'invalid' => array(
                'You really should type in your name.',
            ),
        ),
        'email' => array (
            'type'    => 'text',
            'label'   => 'Email address:',
            'invalid' => array(
                'Be sure to type in your email.',
                'And make it a real one, no fakes!',
            ),
        ),
    );    
}}
</markdown>