Preview EULA PDF dan Hapus Cache (LarisFont)

Cara memakai tombol Preview EULA (PDF) untuk uji template, dan Delete All Cached EULA (PDF) agar PDF order dibuat ulang dengan pengaturan terbaru.

LarisFont menyimpan PDF EULA per order di server supaya unduhan berikutnya lebih cepat. Anda bisa preview template kapan saja tanpa order nyata, dan menghapus semua cache kalau template, logo, atau style berubah.

Preview template

Cara membuka preview

1. Buka LarisFont → Dashboard → Font EULA (End User License Agreement) PDF For WooCommerce → Settings.
2. Klik tombol Preview EULA (PDF) (di atas section Settings).
3. PDF terbuka di tab browser baru, nama file unduhan: EULA-preview.pdf.

Apa yang di-preview?

Preview memakai data contoh, bukan order pelanggan:

• %%shopname%%, %%shopaddress%%, %%email%% terisi dari pengaturan toko
• Parameter order (%%ordernumber%%, %%customername%%, %%products%%, dll.) tidak terisi karena tidak ada order

Preview selalu dibuat ulang (file preview.pdf di wp-content/uploads/tplfeula/). Cocok untuk memverifikasi logo, font, margin, dan layout HTML setelah Anda mengubah Custom EULA Text atau section Style.

Untuk memastikan parameter order terisi benar, uji dengan order paid atau regenerate dari admin.

Cache PDF order

Di mana file disimpan?

• PDF order: wp-content/uploads/tplfeula/{domain}-eula-{order_id}-{order_key}.pdf
• Cache font Dompdf: wp-content/cache/tplfeula-cache/

Saat pelanggan atau admin mengunduh EULA, plugin akan memakai file cache jika sudah ada. Jika belum ada, PDF dibuat lalu disimpan.

Kapan perlu hapus cache?

Hapus cache jika Anda mengubah:

• Custom EULA Text
• Shop Logo, Shop Name, Shop Address, Contact Email
• Pengaturan Style (font, ukuran, margin)

Tanpa hapus cache, order lama masih menyajikan PDF versi lama sampai file dihapus atau dibuat ulang.

Hapus semua cache PDF

1. Di pengaturan EULA PDF, temukan Cached PDF Files.
2. Klik Delete All Cached EULA (PDF).
3. Setelah berhasil, halaman reload dengan pesan: All cached PDF files has been deleted successfully.

Tombol ini menghapus semua file *.pdf di folder tplfeula/ (termasuk preview.pdf). PDF berikutnya akan dibuat ulang saat:

• Seseorang mengklik Preview EULA (PDF)
• Pelanggan mengunduh EULA untuk order eligible
• Admin mengklik View EULA atau Regenerate EULA di metabox order

Izin: hanya user dengan kapabilitas manage_options yang bisa menghapus cache global.

Regenerate satu order saja

Jika hanya satu order yang perlu diperbarui, gunakan metabox LarisFont - EULA (PDF) di halaman edit order tanpa menghapus seluruh cache. Lihat Regenerate EULA dari Halaman Order Admin.

Troubleshooting

Preview error “cannot be generated for technical reasons”

• Pastikan library Dompdf ada di plugin (lib/dompdf/vendor/autoload.php).
• Pastikan folder upload dan cache bisa ditulis.
• Cek error log PHP untuk pesan EULA PDF Generation Error.

Setelah hapus cache, pelanggan masih lihat PDF lama

Browser atau plugin cache bisa menyimpan tab PDF. Minta pelanggan buka link unduh di tab baru atau hard refresh. Pastikan regenerate/hapus cache sudah selesai sebelum mereka mengunduh lagi.

Hapus cache tidak menghapus font cache Dompdf

Delete All Cached EULA (PDF) hanya menghapus PDF order/preview, bukan folder tplfeula-cache/ (cache font internal Dompdf). Itu normal dan tidak perlu dibersihkan untuk update template.