README

CI4 Indodev Toolkit adalah library CodeIgniter 4 yang dirancang khusus untuk mempermudah developer Indonesia dalam menangani format data lokal, seperti tanggal, mata uang, angka terbilang, dan validasi identitas resmi (NIP/NIK/NPWP).

Fitur Utama

• 📅 IndoDate: Konversi tanggal ke format Indonesia (Lengkap, Ringkas, Hari, Bulan, Tahun) dan Waktu Relatif
• 💰 IndoNumber/Currency: Format Rupiah, Pemisah Ribuan, Sanitasi Angka, dan Terbilang (hingga Triliun)
• ✅ IndoValidation: Validasi cerdas untuk NIP, NIK, NPWP, Nomor HP, dan Kode Pos
• 🔒 IndoSecurity: Masking data sensitif dengan menyensor bagian tengah

Instalasi

composer require mjajak/ci4-indodev-toolkit

Library akan otomatis memuat (auto-load) helper sehingga bisa langsung digunakan di Controller dan View.

Menjalankan Test

composer test

Test bawaan menggunakan script PHP sederhana tanpa dependency tambahan.

Penggunaan

1. Fungsi Tanggal (IndoDate)

echo indo_date_lengkap('2026-01-14');      // Rabu, 14 Januari 2026
echo indo_date_ringkas('2026-01-14');      // 14 Januari 2026
echo indo_date_bulan_tahun('2026-01-14');  // Januari 2026
echo indo_date_hari('2026-01-14');         // Rabu
echo indo_date_relative('2026-01-14 10:00:00'); // 3 jam yang lalu
echo indo_date_ringkas('invalid');         // invalid

2. Fungsi Angka & Rupiah (IndoNumber)

echo indo_number_rupiah(1500000);          // Rp1.500.000
echo indo_number_terbilang(1250);          // Seribu Dua Ratus Lima Puluh
echo indo_number_sanitize('Rp 1.500.000'); // 1500000
echo indo_number_thousand_separator(1500000); // 1.500.000

3. Fungsi Validasi (IndoValidation)

is_nip('199501012020011001');    // true
is_nik('3201011234560001');      // true
is_phone('081234567890');        // true
is_date('2026-01-14');           // true
is_date_indo('14-01-2026');      // true
is_npwp('12.345.678.9-012.345'); // true
is_kode_pos('12345');            // true

4. Fungsi Keamanan (IndoSecurity)

echo indo_security_mask('3201011234560001', 6, 4); // 320101******0001
echo indo_security_mask('081234567890', 4, 2);     // 0812******90
echo indo_security_mask('', 4, 4);                 // ''

Kontribusi

Kontribusi terbuka untuk semua! Jika Anda menemukan bug atau ingin menambahkan fitur baru, silakan buat Pull Request atau Issue di GitHub.

Lisensi

Dirilis di bawah Lisensi MIT.

Dibuat dengan ❤️ untuk Developer Indonesia.