README

Package Laravel Icaptcha menyediakan solusi keamanan berbasis image CAPTCHA yang fleksibel untuk aplikasi Laravel Anda. Icaptcha menawarkan berbagai tipe tantangan (teks, matematika, dan pengetahuan umum) dan mudah diintegrasikan menggunakan Blade Directive sederhana.

✨ Fitur Utama

• Tiga Tipe Tantangan: Mendukung Captcha Teks Acak, Matematika Sederhana, dan Tebak Nama Kota (pengetahuan umum).
• Kustomisasi Runtime: Konfigurasi dapat ditimpa langsung di view Anda.
• Validasi Satu Kali Pakai (One-Time Use): Jawaban Captcha dihapus dari session segera setelah validasi untuk keamanan.
• Noise dan Rotasi: Teks dan gambar diacak untuk mencegah bot OCR (Optical Character Recognition).
• Modularitas: Menggunakan view dan data yang dapat dipublikasikan untuk kustomisasi mudah.

🚀 Instalasi

1. Instalasi Composer

composer require novay/icaptcha

2. Publikasi Aset

Setelah instalasi, jalankan perintah publish untuk menyalin config, view, dan data ke direktori aplikasi Anda:

php artisan vendor:publish --tag=icaptcha-config  # [config/icaptcha.php]
php artisan vendor:publish --tag=icaptcha-views   # [resources/views/vendor/icaptcha/icaptcha.blade.php]
php artisan vendor:publish --tag=icaptcha-data    # [storage/app/vendor/icaptcha/cities.json]

Disarankan: Periksa dan sesuaikan pengaturan di config/icaptcha.php sesuai kebutuhan Anda, terutama path font dan dimensi gambar.

🔑 Penggunaan

1. Menampilkan Captcha di View

Gunakan Blade Directive @icaptcha di mana pun Anda membutuhkan kode keamanan (biasanya di formulir login atau pendaftaran).

<div class="form-group">
    <label for="icaptcha">Kode Keamanan</label>
    <div class="icaptcha-wrapper">
        @icaptcha 
    </div>
    <input type="text" name="icaptcha" required class="form-control" placeholder="Masukkan jawaban di atas">
    </div>

2. Kustomisasi Tipe Captcha (Runtime)

Anda dapat menimpa tipe dan parameter konfigurasi Captcha langsung saat pemanggilan directive:

🔒 Validasi Jawaban

Gunakan aturan validasi icaptcha yang disediakan oleh package di Request atau Controller Anda.

// Dalam FormRequest atau Controller

public function store(Request $request)
{
    $request->validate([
        // ... aturan validasi lainnya
        'icaptcha' => 'required|icaptcha', 
    ], [
        'icaptcha.required' => 'Mohon masukkan kode keamanan.',
        'icaptcha.icaptcha' => 'Jawaban kode keamanan tidak tepat.',
    ]);
    
    // ... Logika login atau pendaftaran berhasil
}

Perhatian: Aturan icaptcha secara otomatis mengambil jawaban yang benar dari session, membandingkannya dengan input pengguna, dan menghapus kunci session setelah validasi.

⚙️ Detail Konfigurasi

Berikut adalah kunci-kunci penting di config/icaptcha.php:

Lisensi

Package ini dirilis di bawah Lisensi MIT.