🌐 Panduan Memasang MonitorPIC di Web Hosting (cPanel)

Untuk hosting yang memakai cPanel (Niagahoster, Hostinger, Rumahweb, IDCloudHost, dan sejenisnya). Ikuti urut dari Langkah 0. Setiap langkah punya tanda ✅ supaya Anda tahu sudah benar. Tampilan menu cPanel tiap penyedia sedikit berbeda; nama menu yang dipakai di sini adalah nama bakunya.

Langkah 0 – Kumpulkan dulu (5 menit)

Siapkan catatan berikut. Tulis di Notepad, jangan di kertas yang terlihat orang lain.

• Alamat login cPanel + username + password (dari email hosting).
• Domain atau subdomain yang akan dipakai, mis. monitor.perusahaan.com (disarankan subdomain khusus).
• Paket ZIP MonitorPIC terbaru (berkas monitorpic-xampp-v9xx-….zip).
• Nomor WhatsApp pengirim (khusus kantor) bila ingin reminder WA, dan email SMTP bila ingin email.

Langkah 1 – Pastikan hosting memenuhi syarat

1. Login cPanel → cari Select PHP Version (atau MultiPHP Manager).
2. Pilih PHP 8.1 (atau 8.2/8.3) untuk domain Anda → Apply/Set as current.
3. Di Select PHP Version → Extensions centang: pdo_mysql (kadang tertulis mysqlnd/pdo), mbstring, json, curl, openssl, zlib. Klik Save.
4. Cari menu Cron Jobs di cPanel. Jika menu itu tidak ada, tanyakan ke support: "apakah paket ini mendukung cron job PHP CLI?".

Langkah 2 – Domain/subdomain dan SSL (HTTPS)

1. cPanel → Domains (atau Subdomains) → Create A New Domain / buat subdomain, mis. monitor pada perusahaan.com.
2. Perhatikan kolom Document Root (mis. /home/akunanda/monitor.perusahaan.com). Catat: di sinilah semua berkas aplikasi diunggah (Langkah 4).
3. cPanel → SSL/TLS Status → pilih domain/subdomain tadi → Run AutoSSL. Tunggu beberapa menit sampai gembok hijau.
4. cPanel → Domains → aktifkan Force HTTPS Redirect untuk domain itu.

Langkah 3 – Buat database MySQL

1. cPanel → MySQL® Databases.
2. Bagian Create New Database: ketik nama, mis. monitorpic → Create Database. Hasil akhirnya berawalan nama akun, mis. akunanda_monitorpic.
3. Bagian MySQL Users → Add New User: username mis. app (jadi akunanda_app). Klik Password Generator → Use Password (salin password panjang itu) → Create User.
4. Bagian Add User To Database: pilih user dan database tadi → Add → centang ALL PRIVILEGES → Make Changes.
5. Catat ke Notepad tiga hal: nama database lengkap, nama user lengkap, password.

Langkah 4 – Unggah berkas aplikasi

1. Di komputer, ekstrak ZIP MonitorPIC. Anda akan mendapat folder (mis. monitorpic) berisi index.html, api.php, assets, inc, dll.
2. Cara paling mudah: zip ulang isi folder itu (pilih semua berkas di dalam folder, bukan foldernya) menjadi aplikasi.zip.
3. cPanel → File Manager → masuk ke Document Root dari Langkah 2 → tombol Upload → pilih aplikasi.zip → tunggu 100%.
4. Kembali ke File Manager → klik kanan aplikasi.zip → Extract → Extract File(s). Lalu hapus aplikasi.zip.
5. Klik Settings (pojok kanan atas File Manager) → centang Show Hidden Files (dotfiles) → Save. Ini agar berkas .htaccess terlihat.

Langkah 5 – Isi database (impor)

1. Unduh database_hosting.sql dari File Manager ke komputer Anda (klik kanan → Download), atau gunakan salinan hasil ekstrak di komputer.
2. cPanel → phpMyAdmin. Di kolom kiri klik nama database Anda (mis. akunanda_monitorpic).
3. Klik tab Import → Choose File → pilih database_hosting.sql → biarkan pengaturan bawaan → klik Import di bagian paling bawah.
4. Tunggu pesan hijau "Import has been successfully finished".

Langkah 6 – Buat config.php

1. File Manager → klik kanan config.example.php → Copy → nama baru config.php (di folder yang sama).
2. Klik kanan config.php → Edit (abaikan peringatan encoding → Edit).
3. Ubah baris berikut sesuai catatan Langkah 3 (tanda kutip tunggal jangan dihapus):

define('DB_HOST', 'localhost');
define('DB_NAME', 'akunanda_monitorpic');   // nama database LENGKAP
define('DB_USER', 'akunanda_app');          // nama user LENGKAP
define('DB_PASS', 'password-dari-langkah-3');

define('VERIFY_SSL', true);                 // biarkan true

1. Baris WhatsApp/Email diisi di Langkah 11 dan 12; sekarang biarkan. Klik Save Changes.
2. Klik kanan config.php → Change Permissions → set 640 (Owner: baca+tulis; Group: baca; World: kosong) → Save. Bila nanti muncul error "tidak bisa membaca config", ubah ke 644.

Langkah 7 – Izin folder

1. Pastikan folder uploads, logs dapat ditulis: klik kanan folder → Change Permissions → 755 (bila nanti unggah dokumen gagal, ubah ke 775).
2. Folder backups dibuat otomatis oleh aplikasi saat backup pertama. Bila gagal, buat folder baru bernama backups dan beri izin 755.
3. Pastikan berkas .htaccess ada di folder utama dan di dalam uploads, logs, inc, tests, tools, migrations, docs. Berkas ini menolak akses web ke folder-folder internal tersebut.

Langkah 8 – Jalankan pemeriksa otomatis (cek_hosting.php)

Berkas cek_hosting.php memeriksa PHP, ekstensi, config, folder, database, password bawaan, cron, dan HTTPS, dan memberi tahu apa yang perlu diperbaiki. Ia tidak mengubah data dan tidak menampilkan password.

1. Edit config.php lagi dan tambahkan satu baris di paling bawah (ganti isinya dengan kata acak panjang buatan Anda, minimal 16 karakter):

define('SETUP_KEY', 'ganti-dengan-kata-acak-panjang-anda');

1. Buka di browser: https://monitor.perusahaan.com/cek_hosting.php?k=ganti-dengan-kata-acak-panjang-anda
2. Baca hasilnya. Arti penanda: [OK] baik · [GAGAL] harus diperbaiki · [PERIKSA] sebaiknya diperbaiki · [info] keterangan saja.
3. Perbaiki setiap [GAGAL] sesuai petunjuk di sebelahnya, lalu muat ulang halaman sampai tidak ada [GAGAL]. Pada tahap ini wajar bila masih ada: "Password bawaan … admin" (diselesaikan di Langkah 9) dan "Cron belum pernah berjalan" (diselesaikan di Langkah 10).
4. Setelah seluruh pemasangan selesai (Langkah 14), hapus baris SETUP_KEY dari config.php dan hapus berkas cek_hosting.php dari server.

Langkah 9 – Login pertama dan ganti password admin (WAJIB)

1. Buka https://monitor.perusahaan.com/ → login admin / admin123.
2. Segera klik nama akun (kanan atas) → Profil Saya → ganti password dengan yang kuat (≥ 10 karakter, campuran huruf besar/kecil, angka, simbol; jangan memakai nama perusahaan). Isi juga No. WA (format 6281234567890, tanpa + dan tanpa 0 di depan) dan Email Anda → Simpan.
3. Muat ulang cek_hosting.php?k=…; baris "Password bawaan/mudah ditebak" harus berubah menjadi [OK].
4. Menu Administrasi → Parameter Sistem: isi nama aplikasi, kriteria password, jam bantuan, unit/kategori (Master), lalu buat akun PIC di Administrasi → Pengguna → Tambah (isi No. WA & Email asli, level pegawai, unit tanggung jawab).

Langkah 10 – Cron Job (pengganti Windows Task Scheduler)

cron.php harus dijalankan tiap 15 menit. Ia mengirim reminder terjadwal, memproses antrean notifikasi, pengingat persetujuan, ringkasan terjadwal, dan backup.

1. cPanel → Cron Jobs. Bagian Add New Cron Job → Common Settings: pilih Once Per Fifteen Minutes (*/15 * * * *) (bila tidak ada, isi menit */15 dan kolom lain *).
2. Kolom Command, isi (sesuaikan akunanda dan folder Document Root dari Langkah 2):

/usr/local/bin/php /home/akunanda/monitor.perusahaan.com/cron.php >/dev/null 2>&1

1. Klik Add New Cron Job.
2. Jika cron tidak jalan karena jalur PHP berbeda, lihat jalur yang disarankan hosting (sering /usr/local/bin/php, /opt/cpanel/ea-php81/root/usr/bin/php, atau php saja). Tanyakan support: "perintah cron untuk menjalankan PHP 8.1 CLI".
3. Tunggu 15–30 menit, lalu buka Admin → Kesehatan Sistem di aplikasi. Baris cron harus hijau (terakhir < 30 menit).

Langkah 11 – WhatsApp lewat Fonnte

1. Buka fonnte.com → daftar → login. Menu Device → Add Device → isi nomor WhatsApp pengirim (disarankan nomor khusus kantor).
2. Di HP: WhatsApp → Perangkat tertaut → Tautkan perangkat → scan QR di Fonnte. Status device harus Connected.
3. Salin Token device.
4. Edit config.php:

define('WA_PROVIDER', 'fonnte');
define('FONNTE_TOKEN', 'tempel-token-di-sini');
define('WA_TEST_NUMBER', '6281234567890');   // sementara: semua pesan dialihkan ke nomor Anda sendiri

1. Di aplikasi: Reminder → Jadwal & Template → Koneksi WhatsApp & Email → klik Tes kirim WA ke saya.
2. Bila pesan tes sudah masuk dan isinya benar, kosongkan WA_TEST_NUMBER ('') agar pesan terkirim ke PIC sebenarnya.

Langkah 12 – Email (opsional)

Dua pilihan: akun email dari hosting Anda, atau Gmail dengan App Password.

1. Email hosting: cPanel → Email Accounts → buat noreply@perusahaan.com. Lalu pada akun itu klik Connect Devices untuk melihat server SMTP (biasanya mail.perusahaan.com, port 465 SSL atau 587).
2. Gmail: akun Google → Keamanan → aktifkan Verifikasi 2 langkah → myaccount.google.com/apppasswords → buat App Password (16 karakter, tanpa spasi). Server smtp.gmail.com port 587.
3. Edit config.php:

define('SMTP_HOST', 'mail.perusahaan.com');
define('SMTP_PORT', 587);
define('SMTP_USER', 'noreply@perusahaan.com');
define('SMTP_PASS', 'password-email');
define('SMTP_FROM_NAME', 'MonitorPIC');
define('EMAIL_TEST_ADDRESS', 'emailanda@gmail.com');   // sementara, kosongkan saat produksi

1. Aplikasi → Tes kirim Email ke saya. Cek juga folder Spam. Bila gagal: coba port 465 atau 587 bergantian dan pastikan SMTP_USER lengkap berbentuk alamat email.

Langkah 13 – Pemeriksaan keamanan (WAJIB)

Buka alamat-alamat berikut di browser (jendela Incognito). Hasil yang benar tertulis di kolom kanan.

• Bila ada alamat yang terbuka padahal seharusnya ditolak: periksa berkas .htaccess ada (aktifkan Show Hidden Files) dan tanyakan support apakah hosting mengizinkan .htaccess (AllowOverride). Pada server Nginx murni .htaccess tidak dipakai; minta support memblokir folder-folder tersebut.
• Admin → Parameter → Sistem: pastikan batas percobaan login (pembatas login) aktif.
• Hanya beri akses Admin kepada orang yang benar-benar perlu.

Langkah 14 – Backup otomatis

1. Admin → Parameter → Sistem → Backup Database Otomatis: aktifkan, jam 02:00, simpan 7 berkas → Simpan.
2. Klik Backup sekarang. Harus muncul berkas monitorpic_AAAAMMDD_JJMMDD.sql.gz di daftar.
3. Unduh satu berkas dari kartu itu dan simpan di tempat lain (komputer kantor/Google Drive). Ulangi minimal tiap minggu. Backup yang hanya ada di server hosting tidak menyelamatkan Anda bila akun hosting bermasalah.
4. Backup tidak mencakup folder uploads/ (dokumen tiket). Unduh folder itu lewat File Manager (Compress → Download) sesekali.
5. Sekarang hapus baris SETUP_KEY dari config.php dan hapus cek_hosting.php dari server. Hapus juga database_hosting.sql dari server (sudah ada di komputer Anda).

Cara memulihkan dari backup ada di docs/BACKUP.md (impor lewat phpMyAdmin pada database kosong atau database yang sama).

Langkah 15 – Memperbarui ke versi baru nanti

1. Backup dulu (Langkah 14: Backup sekarang → unduh).
2. Unggah ZIP versi baru dan ekstrak menimpa berkas lama. Jangan menimpa / hapus config.php, folder uploads/, backups/, logs/ (ZIP resmi memang tidak menyertakan config.php).
3. Jangan impor ulang database_hosting.sql (itu menghapus semua data). Terapkan migrasi saja: bila hosting punya Terminal (cPanel → Terminal): cd ~/monitor.perusahaan.com && php migrate.php. Bila tidak ada Terminal: buat cron sekali jalan dengan perintah /usr/local/bin/php /home/akunanda/monitor.perusahaan.com/migrate.php >> /home/akunanda/monitor.perusahaan.com/logs/migrate.log 2>&1 di menit terdekat, tunggu, baca logs/migrate.log (harus ada "Tidak ada migrasi baru" atau daftar migrasi terapan), lalu hapus cron itu.
4. Muat ulang aplikasi dengan Ctrl+F5 (agar JavaScript/CSS baru terpakai), lalu cek Admin → Kesehatan Sistem.

Langkah 16 – Bila ada masalah

Ringkasan daftar centang