Forem: Muhammad Eko Pujianto

Optimalkan Pencarian dengan Laravel: Retensi Query Parameters Menggunakan withQueryString()

Muhammad Eko Pujianto — Tue, 28 Jan 2025 00:01:35 +0000

Optimalkan Pencarian dengan Laravel: Retensi Query Parameters Menggunakan `withQueryString()`

Masalah

Bayangkan Anda sedang mengembangkan sebuah aplikasi web berbasis Laravel yang memiliki fitur daftar produk lengkap dengan pencarian, filter, dan sorting. Ketika pengguna melakukan pencarian dengan kata kunci tertentu, atau memilih filter dan sorting, semuanya berjalan dengan baik. Namun, ada masalah ketika pengguna berpindah ke halaman berikutnya dalam hasil paginasi.

Saat pengguna mengklik halaman berikutnya, parameter pencarian, filter, atau sorting yang mereka pilih hilang. Alhasil, daftar produk kembali menampilkan data default, dan pengguna harus mengulang proses pencarian atau filter mereka. Masalah ini tentu mengganggu pengalaman pengguna dan dapat menurunkan tingkat kepuasan mereka terhadap aplikasi Anda.

Masalah ini sering muncul karena query parameters seperti ?search=keyword&sort=asc tidak secara otomatis disertakan oleh sistem paginasi Laravel saat berpindah halaman. Lalu, bagaimana cara mengatasinya?

Solusi

Laravel menyediakan metode praktis bernama withQueryString() yang dapat digunakan bersama paginasi untuk memastikan bahwa semua query parameters yang ada di URL akan tetap dipertahankan saat navigasi antar halaman.

Dengan menggunakan withQueryString(), Anda tidak perlu lagi khawatir kehilangan parameter seperti pencarian, filter, atau sorting. Fitur ini sangat membantu untuk meningkatkan pengalaman pengguna dalam aplikasi berbasis data.

Contoh Implementasi

Berikut adalah contoh implementasi dari withQueryString() dalam sebuah controller Laravel:

Langkah 1: Buat Controller dengan Fitur Pencarian dan Paginasi

Misalkan kita sedang membangun sebuah halaman daftar produk dengan pencarian dan sorting.

use App\Models\Product;
use Illuminate\Http\Request;

class ProductController extends Controller
{
    public function index(Request $request)
    {
        // Inisialisasi query untuk produk
        $products = Product::query();

        // Filter berdasarkan pencarian
        if ($request->has('search')) {
            $products->where('name', 'like', '%' . $request->query('search') . '%');
        }

        // Tambahkan sorting jika ada
        if ($request->has('sort')) {
            $products->orderBy('name', $request->query('sort'));
        }

        // Paginate dengan withQueryString()
        $products = $products->paginate(10)->withQueryString();

        return view('products.index', compact('products'));
    }
}

Langkah 2: Buat Tampilan (Blade) untuk Menampilkan Daftar Produk

Selanjutnya, kita membuat tampilan sederhana untuk menampilkan daftar produk beserta fitur pencarian dan paginasi:

<!-- resources/views/products/index.blade.php -->
@extends('layouts.app')

@section('content')
<div class="container">
    <h1>Daftar Produk</h1>

    <!-- Form Pencarian -->
    <form method="GET" action="{{ route('products.index') }}" class="mb-4">
        <input type="text" name="search" placeholder="Cari produk..." value="{{ request('search') }}">
        <select name="sort">
            <option value="asc" {{ request('sort') === 'asc' ? 'selected' : '' }}>A-Z</option>
            <option value="desc" {{ request('sort') === 'desc' ? 'selected' : '' }}>Z-A</option>
        </select>
        <button type="submit">Cari</button>
    </form>

    <!-- Daftar Produk -->
    <ul>
        @foreach ($products as $product)
            <li>{{ $product->name }}</li>
        @endforeach
    </ul>

    <!-- Paginasi -->
    <div class="pagination">
        {{ $products->links() }}
    </div>
</div>
@endsection

Langkah 3: Uji Coba

Jalankan aplikasi Anda dan buka halaman daftar produk.
Lakukan pencarian, pilih filter, dan coba navigasi ke halaman berikutnya.
Perhatikan bahwa query parameters seperti ?search=keyword&sort=asc tetap ada di URL selama navigasi antar halaman.

Kesimpulan

Dengan menggunakan metode withQueryString() dari Laravel, Anda dapat mempertahankan parameter pencarian, filter, dan sorting di URL selama navigasi antar halaman pada hasil paginasi. Hal ini meningkatkan pengalaman pengguna dengan memastikan data yang relevan tetap tersedia tanpa perlu mengulang proses pencarian.

Fitur sederhana ini sangat membantu dalam pengembangan aplikasi berbasis data, seperti marketplace, sistem manajemen produk, atau aplikasi katalog. Jadi, jika Anda sedang membangun aplikasi dengan fitur serupa, pastikan untuk memanfaatkan withQueryString()! Siap mencoba? Selamat mengembangkan! 🚀

Membuat Custom Helper di Laravel

Muhammad Eko Pujianto — Thu, 16 Nov 2023 04:23:03 +0000

Pernah dengar istilah custom helper di laravel? saya rasa sudah tidak asing untuk para developer laravel.
generateRandomCode('EN', 8); merupakan function yang dibuat sendiri dan bisa di akses pada semua file php di project laravel kita.

Bagaimana membuat ini?

mari kita bereksperiment :

1. Buat file Helpers.php pada path app/Helpers.php

Buatlah file bernama Helpers.php pada path app/Helpers.php, ingat perhatikan case-sensitivnya penulisan helpers.php dengan Helpers.php , mungkin di local development ini bisa running well, namun belum tentu di production. Karena itu sudah hal yang berbeda.

<?php

use Illuminate\Support\Str;

if (!function_exists('generateRandomCode')) {
    /**
     * Generates a random code by combining the current date and a random string.
     *
     * @return string The generated random code.
     */
    function generateRandomCode($prefix = null, $length = 4): string
    {
        // Get the current date in the format 'Ymd'
        $currentDate = date('Ymd');

        // Generate a random string of length 4
        $randomString = strtoupper(Str::random($length));

        // Combine the current date and the random string
        $randomCode = $currentDate . $randomString;
        if (!is_null($prefix)) {
            $randomCode = $prefix . $randomCode;
        }
        return $randomCode;
    }
}

Di atas merupakan contoh kode dari function generateRandomCode(), tentu ini bisa disesuaikan dengan yang kita butuhkan.

2. Tambahkan file Helpers.php pada file composer.json

{
  "autoload": {
    "psr-4": {
      "App\\": "app/",
      "Database\\Factories\\": "database/factories/",
      "Database\\Seeders\\": "database/seeders/"
    },
    "files": ["app/Helpers.php"] // <-- tambahkan ini
  },
  "autoload-dev": {
    "psr-4": {
      "Tests\\": "tests/"
    },
    "files": ["app/Helpers.php"] // <-- tambahkan ini
  }
}

fokus pada baris kode yang saya berikan tanda // <-- tambahkan ini, ini yang harus kita tambahkan di file composer.json. Berdasarkan pengalaman saya autoload dan autoload-dev ini berbeda, kurang lebih seperti ini:

autoload : berjalan untuk production
autoload-dev : berjalan untuk development

efeknya apa, jika kita hanya menuliskan di satu sisi saja, semisal hanya di autoload-dev, mungkin saat development di local itu running well, namun saat naik ke production pasti akan muncul error undefined. Karena dianggap helper tidak pernah ada di production.

3. Running Autoload nya
Buka terminal dan run composer dump-autoload

Finnaly, kita dapat memanggil custom function dari Helpers seperti ini :

$newTrx = new ProductTransaction();
$newTrx->code = generateRandomCode('EN', 8); // <- ini

contoh pemanggilan generateRandomCode() pada controller.

Gimana, menarik bukan?

selamat bereksperiment.

Create multi auth guard on laravel with custom table

Muhammad Eko Pujianto — Sat, 21 May 2022 13:49:47 +0000

Membuat multi auth guard pada laravel dengan custom table.

Umumnya kita develop aplikasi laravel menggunakan starter kit bawaan laravel untuk proses login dan register. Ada laravel/ui, laravel/breeze, dan masih banyak lainnya. Namun bawaan starter kit ini defaultnya ke table users , lantas gimana kalau kita pengen ke table yang lainnya?

Oke tutorial berikut akan menjelaskan gimana cara auth dengan guard dan table custom:

pada tutorial ini saya akan membuat auth admin dari table admins di database.

1. Buat Database dulu

pertama silahkan buat databse admin dulu, kita bisa menggunakan perintah berikut:

php artisan make:migration create_admins_table

2. Setup auth.php

pergi ke config/auth.php , tambahkan sedikit kode untuk mendukung proses auth dengan guard admin

'guards' => [
        'web' => [
            'driver' => 'session',
            'provider' => 'users',
        ],
        // Tambahkan yang ini 👇
        'admin' => [
            'driver' => 'session',
            'provider' => 'admins',
        ],
    ],

'providers' => [
        'users' => [
            'driver' => 'eloquent',
            'model' => App\Models\User::class,
        ],
        // Tambahkan yang ini 👇
        'admins' => [
            'driver' => 'eloquent',
            'model' => App\Models\Admin::class,
        ],
    ],

'passwords' => [
        'users' => [
            'provider' => 'users',
            'table' => 'password_resets',
            'expire' => 60,
            'throttle' => 60,
        ],
        // Tambahkan yang ini 👇
        'admins' => [
            'provider' => 'admins',
            'table' => 'password_resets',
            'expire' => 60,
            'throttle' => 60,
        ],
    ],

3. Model Admin

Siapkan model untuk admin, model di Laravel menggambarkan sebagai objek nyata dalam konsep OOP. Di sini model admin.php merepresentatifkan table admins di database.

buat model melalui perintah:

php artisan make:model Admin

sedikit edit kodenya jadi seperti ini:

<?php
namespace App\Models;
use Illuminate\Database\Eloquent\Factories\HasFactory;
use Illuminate\Foundation\Auth\User; //penting untuk authnya
use Illuminate\Notifications\Notifiable;

class Admin extends User
{
    use HasFactory, Notifiable;
    protected $fillable = [
        'name',
        'email',
        'password',
    ];
    protected $hidden = [
        'password',
        'remember_token',
    ];
    protected $casts = [
        'email_verified_at' => 'datetime',
    ];
}

Dalam konsep auth manual laravel yang terpenting adalah import class User bawaan sistem laravel.

use Illuminate\Foundation\Auth\User;

4. Siapkan Controller Auth untuk Admin

Database, Model, Config sudah oke tinggal Controllernya. Silahkan buat controller dengan perintah:

php artisan make:controller Admin/AdminController

di sini saya bikin Admin/AdminController agar dibuatkan folder controller tersendiri oleh laravel

sedikit catatan untuk membuat manual auth di laravel, maka disarankan harus import Auth dari Facades. Ini sesuai dokumentasi official dari laravel.com

Oke lanjut untuk edit AdminController kita menjadi seperti ini:

<?php

namespace App\Http\Controllers\Admin;

use App\Http\Controllers\Controller;
use Illuminate\Foundation\Auth\AuthenticatesUsers;
use Illuminate\Http\Request;
use Illuminate\Support\Facades\Auth;

class AdminController extends Controller
{
    use AuthenticatesUsers;

    public function __construct()
    {
        $this->middleware('guest:admin')->except('logout');
    }

    public function showLoginForm()
    {
        return view('admin.auth.login');
    }

    public function login(Request $request)
    {
        $this->validate($request, [
            'email' => 'required|email',
            'password' => 'required',
        ]);
        // return 'success';
        $credentials = [
            'email' => $request->email,
            'password' => $request->password
        ];
        if ($this->guard()->attempt($credentials, $request->has('remember'))) {
            $request->session()->regenerate();
            return redirect()->intended('admin');
        }
        return back()->withErrors([
            'email' => 'The provided credentials do not match our records.',
        ])->onlyInput('email');
    }

    /**
     * Get the guard to be used during authentication.
     *
     * @return \Illuminate\Contracts\Auth\StatefulGuard
     */
    protected function guard()
    {
        return Auth::guard('admin');
    }
}

Yang menjadi perhatian teman-teman adalah guard nya guard('admin') bukan guard() biasa. Ini tanda untuk laravel bahwa yang digunakan untuk proses login adalah guard admin dimana menggunakan table admins

Finnaly

Untuk setup core nya udah selesai, sisanya tinggal pemanggilan route dan views yang disiapkan untuk controller tadi.

Silahkan mencoba!
🙏