livecontrol/form

Make form handling in Laravel simpler.

Quick fix for Jeffrey Way's way/form package to make it compatible with LiveControls CMS and Laravel 5.

not compatible with standalone laravel 5

The basic idea is simple: make form creation simpler., _(*1)

View a quick visual demonstration., _(*2)

I'm tired of creating form fields, like this:, _(*3)

<div class="form-group">
    {{  Form::label('username', 'Username:' ) }}
    {{ Form::text('username', null, ['class' => 'control-group']) }}
</div>

Instead, with this FormField class, you can simply do:, _(*4)

{{ FormField::username() }}

That will then produce the necessary (Bootstrap-friendly, by default) HTML. It uses dynamic methods to simplify the process a bit., _(*5)

While it will do its best to figure out what kind of input you want, you can override it., _(*6)

{{ FormField::yourBio(['type' => 'textarea']) }}

This will produce:, _(*7)

<div class='form-group'>
    <label for="yourBio">Your Bio: </label>
    <textarea class="form-control" type="textarea" name="yourBio" cols="50" rows="10" id="yourBio"></textarea>
</div>

So, yeah, it's just a helper class. If your forms require a huge amount of customization, this probably won't work for you. But for simple forms, it'll do the trick nicely!, _(*8)

(It also makes Laracasts demos way easier to setup. :), _(*9)

Usage

To try this out:, _(*10)

Begin by installing the package through Composer., _(*11)

require: {
    "livecontrol/form": "dev-master"
}

Next, add the service provider to app/config/app.php., _(*12)

'providers' => [
    // ..
    'Way\Form\FormServiceProvider'
]

That's it! You're all set to go. Try it out in a view:, _(*13)

{{ FormField::username() }}
{{ FormField::email() }}
{{ FormField::custom(['type' => 'textarea']) }}
{{ FormField::address(['label' => 'Your Address']) }}

That will produce the following. Though it's Twitter Bootstrap friendly by default, you can of course customize the class names as you wish., _(*14)

, _(*15)

If you want to override the defaults, you can publish the config, like so:, _(*16)

php artisan config:publish way/form

Now, access app/config/packages/way/form/config.php to customize. Here's what it lists by default:, _(*17)

return [

    /*
     * What should each form element be
     * wrapped within?
    */
    'wrapper' => 'div',

    /*
     * What class should the wrapper
     * element receive?
    */
    'wrapperClass' => 'form-group',

    /**
     * Should form inputs receive a class name?
     */
    'inputClass' => 'form-control',

    /**
     * Frequent input names can map
     * to their respective input types.
     *
     * This way, you may do FormField::description()
     * and it'll know to automatically set it as a textarea.
     * Otherwise, do FormField::thing(['type' => 'textarea'])
     *
     */
    'commonInputsLookup'  => [
        'email' => 'email',
        'emailAddress' => 'email',

        'description' => 'textarea',
        'bio' => 'textarea',
        'body' => 'textarea',

        'password' => 'password',
        'password_confirmation' => 'password'
    ]
];