Penampil Dokumen (PDF)

Penampil Dokumen adalah halaman utilitas untuk membuka dan membaca berkas PDF di dalam CRM — misalnya PDF penawaran, syarat & ketentuan, atau lampiran lain. Halaman ini bukan sistem manajemen dokumen (tidak ada unggah berkas atau pengategorian); fungsinya menampilkan sebuah PDF dari URL yang diberikan, lengkap dengan kontrol baca (zoom, unduh, cetak) dan — pada mode tertentu — pelacakan bacaan serta konfirmasi persetujuan. Halaman dibuka dengan parameter pada URL, biasanya dari tautan/aksi di modul lain.

Path: /documents dan /documents/view

---

Dua Mode Penampil

Tersedia dua halaman penampil dengan tujuan berbeda.

Halaman	Tujuan	Sumber PDF
/documents	Membaca dokumen dengan pelacakan bacaan & (opsional) persetujuan	Parameter url
/documents/view	Menampilkan PDF sederhana di dalam bingkai (iframe)	Parameter src (URL ter-encode base64)

---

Penampil dengan Persetujuan — /documents

Halaman ini merender seluruh halaman PDF (menggunakan PDF.js), memantau posisi baca pengguna, dan dapat mewajibkan persetujuan sebelum melanjutkan.

Toolbar

• Kembali — Kembali ke halaman sebelumnya (atau ke cancel bila ditentukan).
• Navigasi Halaman — Kolom nomor halaman dan indikator "Hal x / total".
• Zoom — Perkecil, reset (klik persentase), perbesar (0,5×–3×).
• Fullscreen — Membuka PDF di tab baru.
• Print — Mencetak dokumen.
• Download — Mengunduh PDF.

Pelacakan Bacaan

Saat pengguna menggulir hingga halaman terakhir, muncul penanda Sudah dibaca. Pada mode persetujuan, ditampilkan pula progress membaca (persentase) dengan instruksi menggulir sampai akhir.

Mode Persetujuan

Bila diaktifkan (parameter approval=true), di bagian bawah muncul:

• Kotak centang persetujuan — Aktif hanya setelah dokumen dibaca sampai halaman terakhir. Teks persetujuan dapat diatur lewat parameter approvalText.
• Tidak Setuju — Membatalkan (kembali ke cancel atau halaman sebelumnya).
• Setuju & Lanjutkan — Aktif setelah dokumen dibaca dan kotak persetujuan dicentang; mengarahkan ke redirect.

Tanpa mode persetujuan, setelah dokumen selesai dibaca muncul panel mengambang berisi kotak persetujuan dan tombol lanjut (label mengikuti redirectLabel).

Parameter URL

Parameter	Fungsi
url	URL berkas PDF yang ditampilkan
name	Nama/judul dokumen di header
redirect	Tujuan setelah pengguna melanjutkan/menyetujui
redirectLabel	Label tombol lanjut (default "Lanjutkan")
approval	true untuk mengaktifkan mode persetujuan
approvalText	Teks pernyataan persetujuan
cancel	Tujuan saat pengguna membatalkan/kembali

---

Penampil Sederhana — /documents/view

Halaman ini menampilkan PDF di dalam bingkai (iframe) untuk pratinjau cepat.

Toolbar

• Kembali — Kembali ke halaman sebelumnya.
• Zoom — Perkecil, reset, perbesar (0,5×–3×).
• Rotate — Memutar tampilan 90°.
• Fullscreen — Membuka PDF di tab baru.
• Print — Mencetak dokumen.
• Download — Mengunduh PDF.

Parameter URL

Parameter	Fungsi
src	URL PDF yang di-encode base64 (di-decode saat dibuka)
name	Nama berkas untuk header dan nama unduhan

Cara Membuka

Kedua halaman ini dibuka melalui tautan berparameter dari aksi atau modul lain, bukan dari menu navigasi tersendiri. Bila parameter PDF tidak diberikan, halaman menampilkan pesan kesalahan.