Source code aplikasi, template web, dan ebook. Unduh dari akun setelah bayar. Lihat produk

Blog / Tutorial / Cara Membuat Admin Dashboard L...
Tutorial

Cara Membuat Admin Dashboard Laravel dengan Bootstrap 5 dan DataTables AJAX

AD

Admin HijrahKreativa

Penulis

19 Oct 2026
11 min read
39 views

Membangun layout admin responsif dengan Bootstrap 5, serta tabel data berpaginasi, pencarian, dan hapus data lewat AJAX (server-side processing).

Pendahuluan

Hampir setiap aplikasi Laravel butuh panel admin: daftar produk, pesanan, pengguna, dan sebagainya. Dua alat yang saling melengkapi untuk kebutuhan ini adalah Bootstrap 5 untuk tata letak dan DataTables untuk tabel interaktif.

Untuk data yang besar, jangan memuat semua baris ke browser. Pakai server-side processing: browser meminta data per halaman lewat AJAX, dan server hanya mengirim baris yang dibutuhkan. Di Laravel, paket yajra/laravel-datatables memudahkan hal ini.

Yang akan kita bangun:

  1. Layout admin dengan sidebar dan navbar.
  2. Halaman daftar produk dengan DataTables AJAX (cari, urut, paginasi).
  3. Tombol aksi edit dan hapus (hapus lewat AJAX dengan konfirmasi).
  4. Beberapa praktik keamanan dan performa.

1. Persiapan Proyek

composer create-project laravel/laravel admin-dashboard
cd admin-dashboard
composer require yajra/laravel-datatables-oracle

Pastikan memilih versi paket yang kompatibel dengan versi Laravel Anda (composer akan memilihkannya secara otomatis). Atur koneksi database di .env, lalu buat model beserta migrasi dan factory.

php artisan make:model Product -mf
// database/migrations/xxxx_create_products_table.php
Schema::create('products', function (Blueprint $table) {
    $table->id();
    $table->string('name');
    $table->string('sku')->unique();
    $table->unsignedBigInteger('price');          // simpan rupiah sebagai integer
    $table->unsignedInteger('stock')->default(0);
    $table->boolean('is_active')->default(true);
    $table->timestamps();
});
// app/Models/Product.php
protected $fillable = ['name', 'sku', 'price', 'stock', 'is_active'];
// database/factories/ProductFactory.php
public function definition(): array
{
    return [
        'name'      => fake()->words(3, true),
        'sku'       => strtoupper(fake()->unique()->bothify('SKU-####??')),
        'price'     => fake()->numberBetween(25, 900) * 1000,
        'stock'     => fake()->numberBetween(0, 200),
        'is_active' => fake()->boolean(85),
    ];
}

Isi 500 data contoh untuk menguji performa:

php artisan migrate
php artisan tinker --execute="App\Models\Product::factory()->count(500)->create();"

2. Layout Admin dengan Bootstrap 5

Untuk kesederhanaan, Bootstrap, jQuery, dan DataTables dimuat dari CDN. Pada proyek produksi, lebih baik dibundel lewat Vite agar tidak bergantung pada pihak ketiga.

{{-- resources/views/layouts/admin.blade.php --}}
<!DOCTYPE html>
<html lang="id">
<head>
    <meta charset="utf-8">
    <meta name="viewport" content="width=device-width, initial-scale=1">
    <meta name="csrf-token" content="{{ csrf_token() }}">
    <title>@yield('title', 'Dashboard') - Admin</title>

    <link href="https://cdn.jsdelivr.net/npm/bootstrap@5.3.3/dist/css/bootstrap.min.css" rel="stylesheet">
    <link href="https://cdn.jsdelivr.net/npm/bootstrap-icons@1.11.3/font/bootstrap-icons.css" rel="stylesheet">
    <link href="https://cdn.datatables.net/2.1.8/css/dataTables.bootstrap5.min.css" rel="stylesheet">

    <style>
        .sidebar { width: 250px; min-height: 100vh; }
        @media (max-width: 991.98px) { .sidebar { width: 100%; min-height: auto; } }
    </style>
    @stack('styles')
</head>
<body class="bg-body-tertiary">
<div class="d-lg-flex">

    <aside class="sidebar bg-dark text-white p-3">
        <a href="{{ route('admin.dashboard') }}" class="d-block mb-4 fs-5 fw-semibold text-white text-decoration-none">
            <i class="bi bi-speedometer2 me-2"></i>Admin Panel
        </a>
        <ul class="nav nav-pills flex-column gap-1">
            <li class="nav-item">
                <a href="{{ route('admin.dashboard') }}"
                   class="nav-link text-white {{ request()->routeIs('admin.dashboard') ? 'active' : '' }}">
                    <i class="bi bi-house me-2"></i>Dashboard
                </a>
            </li>
            <li class="nav-item">
                <a href="{{ route('admin.products.index') }}"
                   class="nav-link text-white {{ request()->routeIs('admin.products.*') ? 'active' : '' }}">
                    <i class="bi bi-box-seam me-2"></i>Produk
                </a>
            </li>
        </ul>
    </aside>

    <div class="flex-grow-1">
        <nav class="navbar bg-white border-bottom px-4">
            <span class="navbar-brand mb-0 h1 fs-6">@yield('title', 'Dashboard')</span>
            <span class="text-muted small">{{ auth()->user()->name ?? 'Administrator' }}</span>
        </nav>

        <main class="p-4">
            @yield('content')
        </main>
    </div>
</div>

<script src="https://code.jquery.com/jquery-3.7.1.min.js"></script>
<script src="https://cdn.jsdelivr.net/npm/bootstrap@5.3.3/dist/js/bootstrap.bundle.min.js"></script>
<script src="https://cdn.datatables.net/2.1.8/js/dataTables.min.js"></script>
<script src="https://cdn.datatables.net/2.1.8/js/dataTables.bootstrap5.min.js"></script>
<script>
    // semua request AJAX jQuery otomatis menyertakan CSRF token
    $.ajaxSetup({ headers: { 'X-CSRF-TOKEN': $('meta[name="csrf-token"]').attr('content') } });
</script>
@stack('scripts')
</body>
</html>

3. Route dan Controller

// routes/web.php
use App\Http\Controllers\Admin\{DashboardController, ProductController};

Route::middleware(['auth'])->prefix('admin')->name('admin.')->group(function () {
    Route::get('/', [DashboardController::class, 'index'])->name('dashboard');
    Route::resource('products', ProductController::class)->except(['show']);
});

Untuk contoh ini, endpoint data DataTables kita buat sebagai method index yang merespons AJAX. Dengan begitu satu URL melayani halaman HTML dan data JSON.

php artisan make:controller Admin/DashboardController
php artisan make:controller Admin/ProductController --resource
// app/Http/Controllers/Admin/ProductController.php
namespace App\Http\Controllers\Admin;

use App\Http\Controllers\Controller;
use App\Models\Product;
use Illuminate\Http\Request;
use Yajra\DataTables\Facades\DataTables;

class ProductController extends Controller
{
    public function index(Request $request)
    {
        if ($request->ajax()) {
            $query = Product::query()->select(['id', 'name', 'sku', 'price', 'stock', 'is_active', 'created_at']);

            return DataTables::of($query)
                ->addIndexColumn()
                ->editColumn('price', fn ($p) => 'Rp '.number_format($p->price, 0, ',', '.'))
                ->editColumn('is_active', fn ($p) => $p->is_active
                    ? '<span class="badge text-bg-success">Aktif</span>'
                    : '<span class="badge text-bg-secondary">Nonaktif</span>')
                ->editColumn('created_at', fn ($p) => $p->created_at->format('d M Y'))
                ->addColumn('action', fn ($p) => view('admin.products._actions', ['product' => $p])->render())
                ->rawColumns(['is_active', 'action'])
                ->make(true);
        }

        return view('admin.products.index');
    }

    public function destroy(Product $product)
    {
        $product->delete();

        return response()->json(['message' => 'Produk berhasil dihapus.']);
    }

    // create, store, edit, update: isi sesuai kebutuhan (Form Request + validasi)
}

Perhatikan rawColumns: hanya kolom yang sengaja berisi HTML (badge dan tombol) yang dikecualikan dari escaping. Kolom lain, seperti name, tetap di-escape otomatis sehingga aman dari XSS.

4. Tampilan Tabel dengan DataTables AJAX

Partial untuk tombol aksi:

{{-- resources/views/admin/products/_actions.blade.php --}}
<div class="btn-group btn-group-sm">
    <a href="{{ route('admin.products.edit', $product) }}" class="btn btn-outline-primary">
        <i class="bi bi-pencil"></i>
    </a>
    <button type="button" class="btn btn-outline-danger btn-delete"
            data-url="{{ route('admin.products.destroy', $product) }}"
            data-name="{{ $product->name }}">
        <i class="bi bi-trash"></i>
    </button>
</div>

Halaman daftar:

{{-- resources/views/admin/products/index.blade.php --}}
@extends('layouts.admin')
@section('title', 'Produk')

@section('content')
<div class="card shadow-sm">
    <div class="card-header d-flex justify-content-between align-items-center">
        <span class="fw-semibold">Daftar Produk</span>
        <a href="{{ route('admin.products.create') }}" class="btn btn-primary btn-sm">
            <i class="bi bi-plus-lg"></i> Tambah
        </a>
    </div>
    <div class="card-body">
        <table id="products-table" class="table table-striped table-hover w-100">
            <thead>
                <tr>
                    <th>#</th>
                    <th>Nama</th>
                    <th>SKU</th>
                    <th>Harga</th>
                    <th>Stok</th>
                    <th>Status</th>
                    <th>Dibuat</th>
                    <th style="width:90px">Aksi</th>
                </tr>
            </thead>
        </table>
    </div>
</div>

{{-- modal konfirmasi hapus --}}
<div class="modal fade" id="deleteModal" tabindex="-1">
    <div class="modal-dialog modal-dialog-centered">
        <div class="modal-content">
            <div class="modal-header"><h5 class="modal-title">Hapus produk?</h5></div>
            <div class="modal-body">Produk <strong id="delete-name"></strong> akan dihapus.</div>
            <div class="modal-footer">
                <button class="btn btn-secondary" data-bs-dismiss="modal">Batal</button>
                <button class="btn btn-danger" id="confirm-delete">Hapus</button>
            </div>
        </div>
    </div>
</div>
@endsection

@push('scripts')
<script>
$(function () {
    const table = new DataTable('#products-table', {
        processing: true,
        serverSide: true,
        ajax: "{{ route('admin.products.index') }}",
        columns: [
            { data: 'DT_RowIndex', name: 'DT_RowIndex', orderable: false, searchable: false },
            { data: 'name',       name: 'name' },
            { data: 'sku',        name: 'sku' },
            { data: 'price',      name: 'price' },
            { data: 'stock',      name: 'stock' },
            { data: 'is_active',  name: 'is_active', orderable: false },
            { data: 'created_at', name: 'created_at' },
            { data: 'action',     name: 'action', orderable: false, searchable: false },
        ],
        order: [[6, 'desc']],
        pageLength: 10,
        language: { url: 'https://cdn.datatables.net/plug-ins/2.1.8/i18n/id.json' },
    });

    // hapus lewat AJAX
    let deleteUrl = null;
    const modal = new bootstrap.Modal('#deleteModal');

    $('#products-table').on('click', '.btn-delete', function () {
        deleteUrl = $(this).data('url');
        $('#delete-name').text($(this).data('name'));   // .text() mencegah XSS
        modal.show();
    });

    $('#confirm-delete').on('click', function () {
        $.ajax({ url: deleteUrl, type: 'DELETE' })
            .done(() => { modal.hide(); table.ajax.reload(null, false); })
            .fail(() => alert('Gagal menghapus data.'));
    });
});
</script>
@endpush

Opsi ajax.reload(null, false) memuat ulang data tanpa kembali ke halaman pertama.

5. Cara Kerja Server-Side Processing

Setiap kali pengguna mengetik di kolom pencarian, mengganti halaman, atau mengurutkan kolom, DataTables mengirim request seperti ini:

GET /admin/products?draw=3&start=10&length=10
    &search[value]=gamis
    &order[0][column]=6&order[0][dir]=desc

Yajra membaca parameter tersebut, menjalankan query dengan WHERE, ORDER BY, dan LIMIT, lalu mengembalikan JSON:

{
  "draw": 3,
  "recordsTotal": 500,
  "recordsFiltered": 12,
  "data": [ { "DT_RowIndex": 11, "name": "...", "price": "Rp 125.000" } ]
}

Dengan 500 atau 500.000 baris, browser tetap hanya menerima 10 baris per request.

6. Menambah Fitur Filter

Kirim parameter tambahan ke server dan tangani di controller.

<select id="filter-status" class="form-select form-select-sm w-auto mb-3">
    <option value="">Semua status</option>
    <option value="1">Aktif</option>
    <option value="0">Nonaktif</option>
</select>
ajax: {
    url: "{{ route('admin.products.index') }}",
    data: d => { d.status = $('#filter-status').val(); }
},
// ...
$('#filter-status').on('change', () => table.ajax.reload());
$query = Product::query()
    ->select(['id', 'name', 'sku', 'price', 'stock', 'is_active', 'created_at'])
    ->when($request->filled('status'), fn ($q) => $q->where('is_active', $request->boolean('status')));

7. Keamanan dan Performa

Keamanan

  • Lindungi route admin dengan auth dan pembatasan role (misalnya Spatie Permission, lihat artikel terkait).
  • Gunakan Form Request untuk validasi store dan update.
  • Hapus data dengan method DELETE dan CSRF token, bukan link GET.
  • Jangan masukkan input pengguna ke kolom yang ditandai rawColumns tanpa e().

Performa

  • Pilih kolom dengan select() seperti pada contoh, jangan select *.
  • Tambahkan index pada kolom yang sering dicari atau diurutkan (name, sku, created_at).
  • Hindari N+1 di kolom relasi: gunakan with() pada query yang diberikan ke DataTables::of().
  • Pencarian LIKE '%kata%' tidak memakai index biasa. Untuk jutaan baris, pertimbangkan FULLTEXT index.
Schema::table('products', function (Blueprint $table) {
    $table->index('created_at');
});

Checklist

  • ☐ Layout admin responsif di desktop dan mobile.
  • ☐ serverSide: true aktif, dan controller mengembalikan JSON dari query (bukan ->get()).
  • ☐ CSRF token terpasang pada semua request AJAX.
  • ☐ Kolom HTML dibatasi lewat rawColumns.
  • ☐ Route admin dilindungi middleware autentikasi dan otorisasi.
  • ☐ Index database untuk kolom pencarian dan pengurutan.

Penutup

Kombinasi Bootstrap 5, DataTables, dan Yajra memberi dasar yang cepat dibangun dan mudah dikembangkan. Dari sini, Anda bisa menambahkan modul lain dengan pola yang sama: satu controller, satu partial aksi, dan satu konfigurasi DataTables per halaman. Fitur lanjutan seperti ekspor Excel, tombol bulk action, atau filter rentang tanggal dapat ditambahkan tanpa mengubah arsitektur dasarnya.

Bagikan artikel:

Artikel lainnya