NAME
    Catalyst::Model::FormFu - Speedier interface to HTML::FormFu for
    Catalyst

VERSION
    version 0.002

SYNOPSIS
        package MyApp
        {

            use parent 'Catalyst';

            __PACKAGE__->config( 'Model::FormFu' => {
                model_stash => { schema => 'MySchema' },
                constructor => { config_file_path => 'myapp/root/forms' },
                forms => {
                    form1 => 'form1.yaml',
                    form2 => 'form2.yaml',
                ]
            } );

        }

        package MyApp::Controller::WithForms
        {
            use parent 'Catalyst::Controller';

            sub edit :Local
            {
                my ($self, $c, @args) = @_;

                my $form1 = $c->model('FormFu')->form('form1');

                if ($form1->submitted_and_valid)
                ...
            }

        }

        package MyApp::Model::FormFu
        {
            use parent 'Catalyst::Model::FormFu';
        }

DESCRIPTION
    "Catalyst::Model::FormFu" is an alternative interface for using
    HTML::FormFu within Catalyst. It differs from
    Catalyst::Controller::HTML::FormFu in the following ways:

    *   It initializes all required form objects when your app is started,
        and returns clones of these objects in your actions. This avoids
        having to call "load_config_file" in HTML::FormFu and "populate" in
        HTML::FormFu every time you display a form, leading to performance
        improvements in persistent applications.

    *   It does not inherit from Catalyst::Controller, and so is safe to use
        with other modules that do so, in particular
        Catalyst::Controller::ActionRole.

    Note that this is a completely different module from the original
    "Catalyst::Model::FormFu" by <Daisuke Maki>, which is now only available
    on the BackPAN
    (<http://backpan.perl.org/authors/id/D/DM/DMAKI/Catalyst-Model-FormFu-0.
    01001.tar.gz>).

CONFIGURATION OPTIONS
    "Catalyst::Model::FormFu" accepts the following configuration options

    forms
        A hashref where keys are the names by which the forms will be
        accessed, and the values are the configuration files that will be
        loaded for the respective forms.

    constructor
        A hashref of options that will be passed to "HTML::FormFu->new(...)"
        for every form that is created.

    model_stash
        A hashref with a "stash" key whose value is the name of a Catalyst
        model class that will be place in the form stash for use by
        HTML::FormFu::Model::DBIC.

USAGE
    Use the "form" method of the model to fetch one or more forms by their
    names. The form is loaded with the current request parameters and
    processed.

SEE ALSO
    *   Catalyst::Controller::HTML::FormFu

    *   HTML::FormFu::Library

AUTHOR
    Peter Shangov <pshangov@yahoo.com>

COPYRIGHT AND LICENSE
    This software is copyright (c) 2011 by Peter Shangov.

    This is free software; you can redistribute it and/or modify it under
    the same terms as the Perl 5 programming language system itself.

