Belajar Laravel #29: Filament Lanjutan — Custom Page, Relation Manager, Plugin, dan Tema

Di episode sebelumnya (#28) saya sudah mencoba Filament dasar: resource, form builder, table, dan action. Minggu ini saya lanjut ke bagian yang sering saya butuhkan saat aplikasi mulai terasa nyata — halaman kustom di panel admin, mengelola relasi satu-ke-banyak dari layar yang sama, memasang plugin, dan mengganti tema terang/gelap. Catatan ini saya tulis sambil benar-benar mencoba di proyek Laravel dengan Filament v5 (versi stabil terbaru saat saya menulis, rilis Januari 2026), jadi sebagian besar adalah pengalaman langsung, bukan sekadar ringkasan dokumentasi.

Custom page: ketika resource tidak cukup

Resource Filament cocok untuk tabel standar (list, create, edit, delete). Tapi begitu saya butuh halaman “Dashboard Penjualan” dengan angka ringkasan dan daftar widget, resource jadi terasa dipaksa. Solusinya adalah custom page: satu halaman yang dibuat lewat Artisan, lengkap dengan view Blade-nya sendiri.

Saya jalankan perintah php artisan make:filament-page SalesDashboard. Itu membuat dua file: class halaman di folder Pages dan satu view Blade. Yang menarik bagi saya: dokumentasi Filament v5 menyebut page class adalah full-page Livewire component. Artinya saya bisa menulis method mount(), property publik, dan method pembantu persis seperti komponen Livewire biasa. Semua yang saya pelajari soal Livewire di episode #26 langsung kepakai di sini — Filament bukan bahasa baru, hanya lapisan di atas Livewire.

Satu fitur yang saya sukai: menampilkan widget di halaman kustom. Caranya cukup override method getHeaderWidgets() atau getFooterWidgets() di class halaman, lalu kembalikan array widget — widget statistik yang sama seperti di dashboard bawaan Filament akan muncul di atas atau di bawah isi halaman. Saya juga bisa membatasi siapa yang boleh membuka halaman lewat canAccess(), sehingga halaman kustom tadi tidak muncul di menu untuk pengguna yang tidak berwenang. Ini pola yang sama dengan gate dan policy yang saya bahas di episode #12.

Relationship manager: kelola relasi tanpa pindah halaman

Dulu, kalau saya mau menambah “buku” ke satu “penulis”, saya harus membuat halaman CRUD terpisah atau mengutak-atik form induknya. Filament menyediakan relation manager: tabel interaktif mini di halaman edit resource yang bisa menambah, mengubah, dan menghapus data relasi di tempat, tanpa meninggalkan halaman.

Saya jalankan php artisan make:filament-relation-manager AuthorResource books title — tiga argumennya: nama resource induk, nama relasi, dan atribut pengenal. Hasilnya class dengan dua method utama: form() untuk modal tambah/ubah dan table() untuk daftarnya:

public function form(Schema $schema): Schema
{
    return $schema
        ->components([
            TextInput::make('title')->required()->maxLength(255),
            TextInput::make('published_at')->date(),
        ]);
}

public function table(Table $table): Table
{
    return $table
        ->columns([
            TextColumn::make('title')->searchable(),
            TextColumn::make('published_at')->date(),
        ])
        ->headerActions([CreateAction::make()])
        ->recordActions([EditAction::make(), DeleteAction::make()]);
}

Relation manager belum aktif sampai saya daftarkan di resource induk lewat method statis getRelations(). Bagian ini yang paling sering saya lupa — tabelnya tidak muncul dan tidak ada error, hanya halaman edit yang kosong di bagian bawah. Pola “error sunyi” ini yang juga saya alami waktu belajar Eloquent relationship di episode #8: penyebabnya selalu nama relasi di model yang tidak cocok. Setelah saya cocokkan nama books() di model Author, semuanya langsung jalan. Relation manager juga kompatibel dengan hasMany, belongsToMany, dan morphMany, jadi satu pola ini cukup untuk sebagian besar kebutuhan saya.

Plugin: pakai yang sudah ada, jangan tulis ulang

Filament punya ekosistem plugin resmi di filamentphp.com. Instalnya konvensional lewat Composer, lalu didaftarkan di panel provider:

public function panel(Panel $panel): Panel
{
    return $panel
        ->plugins([
            // daftar class plugin di sini
        ]);
}

Prinsip yang saya ambil dari episode #23 (paket populer) berlaku lagi: sebelum menulis fitur sendiri, cek dulu apakah plugin resmi sudah menyediakannya. Untuk login, reset password, dan pendaftaran pengguna, Filament sudah menyediakan plugin Auth bawaan — saya tidak perlu memasang Breeze khusus untuk panel admin. Perbedaan penting dengan musim 1: dulu saya memasang Breeze untuk aplikasi utama; di panel admin, Filament sudah menanganinya sendiri.

Tema terang & gelap

Fitur kecil yang paling sering saya pakai sehari-hari: sakelar tema. Filament v5 punya tema terang dan gelap bawaan, dengan pemilih tema (light / dark / system) di header panel. Yang perlu saya siapkan hanyalah satu sakelar — Filament menyimpan preferensinya sendiri. Kalau mau mengatur perilakunya, jalannya lewat panel provider:

use Filament\Enums\ThemeMode;

public function panel(Panel $panel): Panel
{
    return $panel
        // sembunyikan sakelar tema
        ->themeSwitcher(false)
        // paksa mode bawaan terang
        ->defaultThemeMode(ThemeMode::Light);
}

Saya catat satu hal: untuk kustomisasi warna brand, jalannya lewat php artisan make:filament-theme yang menghasilkan source Tailwind, lalu di-build jadi CSS yang didaftarkan ke panel. Untuk kebutuhan sederhana, saya lebih memilih menimpa variabel warna daripada fork seluruh tema — jauh lebih ringan saat upgrade versi Filament nanti.

Apa yang saya pelajari minggu ini

Tiga kesimpulan yang saya bawa. Pertama, Filament bukan “admin generator sekali pakai” — custom page dan relation manager membuatnya cukup fleksibel untuk aplikasi produksi. Kedua, memahami Livewire (episode #26) membuat seluruh API Filament terbaca sendiri, tanpa harus menghafal. Ketiga, separuh masalah saya selama ini bukan karena Filament kurang fitur, tapi karena relasi Eloquent saya belum benar — dan error-nya sunyi, jadi saya harus jeli mengecek nama relasi dulu sebelum menduga ada bug di Filament. Untuk berikutnya, saya ingin menyelami action dan filter lebih dalam sebelum masuk ke topik broadcasting di episode berikutnya.

Sumber

Tinggalkan Balasan

Alamat email Anda tidak akan dipublikasikan. Ruas yang wajib ditandai *

Situs ini menggunakan Akismet untuk mengurangi spam. Pelajari bagaimana data komentar Anda diproses