Dokumentasi Referensi

Token teks undangan

Penanda yang berganti jadi data — nama, tanggal, lokasi, isian Detail.

Token adalah penanda yang Anda tulis di dalam teks, dan saat undangan dibuka ia berganti menjadi data sebenarnya. Anggap saja seperti titik-titik pada formulir: Anda menaruh penanda di tempat nama, lalu namanya diisikan sendiri.

Gunanya agar Anda tidak menulis ulang hal yang sama di banyak tempat: ubah satu kali di isian, seluruh undangan ikut berubah.

Kata "token" dipakai di sini karena itulah sebutan yang muncul di editor, jadi Anda mengenali hal yang sama saat melihatnya di layar.

Token ditulis di antara dua kurung kurawal, misalnya {{primaryName}}.

Token yang salah tulis menjadi teks kosong, tidak merusak undangan. Jadi aman dicoba, tapi periksa hasilnya di pratinjau supaya tidak ada bagian yang hilang tanpa Anda sadari.

Token dasar

Token Menghasilkan
{{primaryName}} Nama utama
{{secondaryName}} Nama kedua
{{title}} Judul acara
{{venue}} Nama tempat
{{venueAddress}} Alamat tempat
{{guestName}} Nama tamu yang membuka undangan

{{guestName}} hanya terisi bila tamu membuka tautan personal miliknya. Kalau tamu datang dari tautan umum, token ini kosong. Jadi jangan menulis kalimat yang jadi rusak tanpanya, misalnya "Kepada {{guestName}}, kami mengundang" akan terbaca aneh bila kosong.

Tanggal acara

{{eventDate}} menghasilkan tanggal acara. Anda bisa memilih bentuknya dengan menambahkan titik dua dan nama bentuk:

Ditulis Contoh hasil
{{eventDate}} Sabtu, 12 September 2026
{{eventDate:long}} Sabtu, 12 September 2026
{{eventDate:date}} 12 September 2026
{{eventDate:short}} 12/09/2026
{{eventDate:weekday}} Sabtu
{{eventDate:day}} 12
{{eventDate:month}} September
{{eventDate:monthShort}} Sep
{{eventDate:year}} 2026
{{eventDate:time}} 10.00

Dua hal yang mudah membuat salah kira:

  • {{eventDate}} tanpa tambahan apa pun menyertakan nama hari. Kalau Anda ingin tanggal saja tanpa hari, pakai {{eventDate:date}}.
  • {{eventDate:short}} menghasilkan tanggal berangka penuh seperti 12/09/2026, bukan singkatan bulan.

Bentuk-bentuk sepotong berguna untuk tampilan tanggal besar bergaya kalender, tempat angka, bulan, dan tahun diletakkan terpisah. Perlu diketahui {{eventDate:day}} menuliskan angka dengan dua digit, jadi tanggal 5 tampil sebagai 05.

Hasilnya juga mengikuti bahasa yang sedang dilihat tamu, sehingga nama hari dan bulan otomatis berganti pada undangan multi-bahasa.

Isian dari tab Detail

Isian yang Anda buat di tab Detail dipanggil dengan kuncinya, misalnya {{full-name-1}} atau {{quote}}. Angka di belakang menunjukkan isian ke berapa dalam grup.

Isian bertipe tanggal selalu diformat menjadi tanggal terbaca, meski Anda tidak menambahkan bentuk apa pun. Jadi {{event-date-1}} menghasilkan "12 September 2026", bukan angka mentah. Bentuk tanggal di atas juga berlaku di sini.

Isian lokasi

Isian bertipe lokasi menyediakan turunan siap pakai untuk tombol peta:

Token Kegunaan
{{namaIsian.mapsUrl}} Tautan membuka Google Maps
{{namaIsian.mapsEmbed}} Peta yang tersemat di halaman
{{namaIsian.wazeUrl}} Tautan membuka Waze
{{namaIsian.coords}} Koordinat

Perlu diperhatikan: kalau Anda hanya menempelkan tautan pendek Google Maps tanpa koordinat, tombol buka Maps tetap berfungsi, tetapi peta tersemat tidak bisa ditampilkan. Untuk mendapatkan keduanya, ambil lokasi yang menyertakan koordinat.

GAMBARIsian lokasi terisi dengan koordinat, berdampingan dengan hasilnya di undangan: peta tersemat dan tombol Buka Maps

Teks yang mengikuti bahasa tamu

{{i18n.<kunci>}} menghasilkan teks bawaan sistem yang otomatis mengikuti bahasa yang sedang dilihat tamu, misalnya {{i18n.openInvitation}} untuk label membuka undangan.

Gunakan ini pada label umum bila undangan Anda multi-bahasa, supaya Anda tidak perlu menyiapkan terjemahan sendiri untuk hal-hal baku.

Format lama

Anda mungkin menemukan bentuk bersarang seperti {{couple.groomFull}} pada template lama. Bentuk itu masih berfungsi demi kompatibilitas, tetapi jangan dipakai untuk undangan baru. Pakai token dasar dan kunci isian di atas.