NAME

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

VERSION

version 0.001

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, potentially 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.

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.