Formello: Paket Laravel untuk Membuat Form Cepat & Mudah

Formello: Solusi Praktis Bikin Form di Laravel 🚀

Kalau kamu sering ngoding di Laravel, pasti pernah ngerasain ribetnya bikin form berulang-ulang. Mulai dari bikin field input, validasi, error handling, sampai rendering di Blade. Nah, sekarang ada Formello, sebuah paket Laravel yang dirancang khusus untuk mempermudah hidup developer dalam membuat form.

Formello hadir sebagai solusi tepat:

• Lebih simpel dibanding library form yang kompleks.
• Lebih ringan dibanding admin panel full-featured seperti Nova atau Filament.

Jadi, kalau kamu butuh bikin form dengan cepat tapi tetap fleksibel dan gampang diatur, Formello ini bisa jadi sahabat baru kamu.

✨ Fitur Unggulan Formello

• Definisi form gampang pakai kelas Laravel.
• Rendering otomatis langsung ke Blade.
• Support berbagai field: text, textarea, select, select2, radio, checkbox, toggle, date, datetime, upload, hidden, hingga custom widget.
• Error handling otomatis (nggak perlu bikin manual).
• Validasi form langsung terintegrasi.
• Dukungan styling: Bootstrap 5 (Tailwind CSS coming soon).

Dengan fitur ini, kamu bisa fokus ke logika aplikasi tanpa kebanyakan copy-paste boilerplate form.

🛠️ Instalasi Formello

Instalasinya gampang banget, Instal paket melalui composer:

composer require metalogico/laravel-formello

Publikasikan asset nya:

php artisan vendor:publish --tag=formello-assets

Supaya asset otomatis update tiap kali composer update, tinggal tambahin ini di composer.json:

"scripts": {
    "post-update-cmd": [
        "@php artisan vendor:publish --tag=formello-assets --force"
    ]
}

😎 Cara Pakai Formello di Laravel

Oke, sekarang kita masuk ke bagian paling seru: cara pakai Formello.

1. Membuat Form Class

Pertama, bikin form baru yang extends Metalogico\Formello\Formello.
Contoh bikin form untuk product:

<?php

namespace App\Forms;

use Metalogico\Formello\Formello;
use Metalogico\Formello\Widgets\SelectWidget;

class ProductForm extends Formello
{
    protected function create(): array
    {
        return [
            'method' => 'POST',
            'action' => route('products.store'),
        ];
    }

    protected function edit(): array
    {
        return [
            'method' => 'POST',
            'action' => route('products.update', $this->model->id),
        ];
    }    

    protected function fields(): array
    {
        return [
            'name' => [
                'label' => __('Product Name'),
                'help' => 'Enter the name of the product',
            ],
            'description' => [
                'label' => __('Description'),
            ],
            'category_id' => [
                'label' => __('Category'),
                'widget' => 'select',
                'choices' => Category::pluck('name', 'id')->toArray(),
            ],
            'in_stock' => [
              'label' => __('In Stock'),
            ],
        ];
    }
}

⚠️ Jangan lupa: field yang kamu bikin harus ditambahkan ke $fillable di model, kalau nggak Formello nggak bakal render field tersebut.

class Product extends Model
{
    protected $fillable = [
        'name',
        'category_id',
        'description',
        'in_stock',
    ];
}

2. Generate Form Otomatis dengan Artisan

Mager bikin manual? Bisa banget generate otomatis dari model dengan command ini:

php artisan make:formello --model=Product

Command ini bakal bikin skeleton form berdasarkan fillable yang ada di model. Hemat waktu banget, kan?

3. Render Form di Controller & Blade

Controller – Create Form (Tambah Data)

public function create()
{
    $formello = new ProductForm(Product::class);
    return view('products.create', [
      'formello' => $formello
    ]);
}

Controller – Edit Form (Ubah Data)

public function edit(Product $product)
{
    $formello = new ProductForm($product);
    return view('products.edit', [
        'formello' => $formello
    ]);
}

Blade Template – Render Form

{!! $formello->render() !!}

Kalau cuma mau render fields tanpa <form> tag:

@foreach ($formello->getFields() as $name => $field)
    {!! $formello->renderField($name) !!}
@endforeach

4. Conditional Logic (Beda Saat Create & Edit)

Formello kasih metode isCreating() & isEditing() biar kamu bisa bedain logika form.

protected function fields(): array
{
    return [
        'name' => [
            'label' => __('User Name'),
            'help' => 'Enter the name of the user',
        ],
        'password' => [
            'label' => __('Password'),
            'type' => 'password',
            'required' => $this->isCreating(),
            'help' => $this->isEditing() ? 'Leave empty to keep current password' : '',
        ],
    ];
}

Jadi, field password wajib diisi pas create, tapi opsional pas edit.

🎉 Done! Dengan langkah ini, kamu bisa bikin form Laravel lebih cepat, rapi, dan fleksibel pakai Formello.

Saat ini sudah support Bootstrap 5, dan untuk pecinta Tailwind CSS tunggu aja, sebentar lagi hadir!

👉 Untuk informasi lebih lengkap, lihat kode sumber di Github.