Parameter Template EULA PDF (LarisFont)
Daftar parameter dinamis Custom EULA Text (%%shopname%%, %%products%%, %%ordernumber%%, dan lainnya) beserta sumber data dan contoh penggunaan.
Parameter template memungkinkan Custom EULA Text terisi otomatis saat PDF dibuat. Anda cukup menyisipkan parameter di HTML template; LarisFont akan menggantinya dengan data toko, pelanggan, atau order sebelum merender PDF.
Daftar resmi parameter ditampilkan di bawah editor Custom EULA Text dengan label Available Parameters. Urutan di plugin sama seperti tabel di bawah.
Daftar parameter
| Parameter | Sumber data | Keterangan |
|---|---|---|
%%shopname%% |
Field Shop Name, atau nama situs WordPress jika kosong | Nama licensor di dokumen |
%%shopaddress%% |
Field Shop Address, atau alamat toko WooCommerce jika kosong | Alamat toko (teks multiline) |
%%email%% |
Field Contact Email, atau email admin jika kosong | Email kontak (di-encode antispambot) |
%%customername%% |
Nama billing order | Nama lengkap pelanggan |
%%customeraddress%% |
Alamat billing terformat WooCommerce | Tanpa baris nama dan company (dibersihkan plugin) |
%%ordernumber%% |
Nomor order WooCommerce | Nomor lisensi di tabel License Details |
%%orderdate%% |
Tanggal pembayaran order | Jika belum ada tanggal bayar, fallback ke tanggal order dibuat; diformat locale WooCommerce |
%%products%% |
Item line order | HTML: nama produk, qty (×), dan item meta (termasuk deskripsi variasi jika fitur display aktif) |
Parameter tambahan di template default
Template default juga memakai %%customeremail%% di sel Licensee. Parameter ini berfungsi saat PDF dibuat, tetapi tidak tercantum di daftar Available Parameters di pengaturan. Anda tetap bisa memakainya di template kustom.
Perilaku %%products%%
Untuk setiap item di order, LarisFont menghasilkan blok HTML berisi:
- Nama produk (bold), dengan filter
woocommerce_order_item_name - Kuantitas, format
× {qty}(menampilkan qty refund jika ada) - Item meta WooCommerce (
wc_display_item_meta), misalnya atribut variasi atau deskripsi lisensi
Beberapa produk dipisahkan <hr/>. Cocok untuk sel tabel di section LICENSE DETAILS.
Jika Variation Description Display For WooCommerce aktif dan opsi order detail dicentang, deskripsi variasi ikut tampil di meta produk pada PDF.
Contoh penggunaan
Di paragraf pendahuluan
<p>Perjanjian ini antara <strong>%%customername%%</strong>
dan <strong>%%shopname%%</strong> mengatur penggunaan materi berlisensi berikut.</p>Di tabel License Details (pola default)
<table>
<tr>
<td>License Number:</td>
<td>%%ordernumber%%</td>
</tr>
<tr>
<td>Effective Date:</td>
<td>%%orderdate%%</td>
</tr>
<tr>
<td>Licensor:</td>
<td><strong>%%shopname%%</strong><br>%%shopaddress%%</td>
</tr>
<tr>
<td>Licensee:</td>
<td><strong>%%customername%%</strong><br>
%%customeraddress%%<br>%%customeremail%%</td>
</tr>
<tr>
<td>Licensed Materials & License Details:</td>
<td>%%products%%</td>
</tr>
</table>Di paragraf penutup
<p>Hubungi dukungan <strong>%%shopname%%</strong> di <strong>%%email%%</strong>.</p>Preview vs order nyata
| Parameter | Preview EULA (PDF) | PDF order paid |
|---|---|---|
%%shopname%%, %%shopaddress%%, %%email%% |
Terisi dari pengaturan | Terisi dari pengaturan |
%%customername%%, %%customeraddress%%, %%ordernumber%%, %%orderdate%%, %%products%% |
Kosong / tidak ada order | Terisi dari order |
Gunakan Preview EULA (PDF) untuk cek layout toko dan style. Untuk verifikasi parameter order, uji dengan order nyata atau buat ulang dari admin.
Troubleshooting
Parameter salah ketik
Harus persis %%shopname%%, bukan %shopname% atau {shopname}. Perhatikan huruf besar-kecilnya (case-sensitive).
%%orderdate%% kosong
Jarang terjadi pada order paid. Plugin fallback ke date_created jika date_paid belum terset. Pastikan order sudah Processing/Completed (bukan pending).
%%products%% tanpa deskripsi lisensi variasi
Aktifkan Variation Description Display dan opsi tampilan di order/email/EULA. Pastikan variasi punya deskripsi (manual atau default term).