andersondanilo/modelform

ModelForm is a PHP Form Abstraction for Laravel based on Django Forms and Formset, but completely integrated with the Laravel FormBuilder.

, _(*1)

What is

ModelForm is a PHP Form Abstraction for Laravel based on Django Forms and Formset, but completely integrated with the Laravel FormBuilder., _(*2)

Instalation

To get the latest version of ModelForm simply require it in your composer.json file, _(*3)

php composer.phar require "andersondanilo/modelform:dev-master"

Examples of usage

Simple example: Without model

// SimpleForm.php
use ModelForm\Form;
use ModelForm\Fields\CharField;
use ModelForm\Fields\IntegerField;

class SimpleForm extends Form
{
    public function makeFields()
    {
        $this->name = new CharField(['label' => 'Name']);
        $this->age = new IntegerField(['label' => 'Age']);
    }
}

Instancializing Form, _(*4)

$simpleForm = new SimpleForm(['data' => Input::old() ?: Input::all()]);

Rendering model in view, _(*5)

    {{ $simpleForm->name->label() }}:
    {{ $simpleForm->name->text(['class' => 'form-control']) }}

Acessing values after, _(*6)

    $name = $simpleForm->name->value;

With Model and Validator

use ModelForm\Form;
use ModelForm\Fields\CharField;
use ModelForm\Fields\IntegerField;

class SimpleForm extends Form
{
    public function makeFields()
    {
        $this->name = new CharField(['label' => 'Name']);
        $this->age = new IntegerField(['label' => 'Age']);
    }

    public function makeModel()
    {
        return new MyModel();
    }

    public function makeValidator($data)
    {
        return Validator::make($data, [
            'name' => 'required'
        ]);
    }
}

You can instancialize without model and then the model is created by form, or start with a already existing model., _(*7)

$model10 = MyModel::find(10);
$form = new SimpleForm(['model' => $model10, 'data' => Input::old() ?: Input::all()]);

Validating, _(*8)

if(!$simpleForm->isValid()) {
    return Redirect::back()->withErrors($simpleForm->errors())->withInput();
}

Saving your model, _(*9)

$simpleForm->save();

Formsets

use ModelForm\FormSet;

class SimpleFormSet extends FormSet
{
    public function makeForm($model=null)
    {
        return new SimpleForm(['model'=>$model]);
    }
}

Create the empty formset instance:, _(*10)

$simpleFormSet = new SimpleFormSet(['data' => Input::old() ?: Input::all());

Or create a formset filled with a model relation:, _(*11)

$addressFormSet = new AddressFormSet(['relation'=>$customer->addresses(), 'data' => Input::old() ?: Input::all());

The validation and saving of formset is the symmetric with form., _(*12)

if(!$addressFormSet->isValid()) {
    return Redirect::back()->withErrors($addressFormSet->errors())->withInput();
}
$addressFormSet->save();