Panduan Post Metabox: Guest Integrations: Google Sheet CSV & Kolom Mapping

Sub-Tab Guest Integrations & Google Sheet CSV pada metabox RSVPKit adalah modul integrasi sumber data tamu tingkat postingan yang memungkinkan validasi daftar undangan tertutup (closed guest list), pengambilan header kolom spreadsheet secara langsung melalui AJAX, serta pemetaan dinamis untuk nama tamu, kuota maksimal pax, dan nomor meja.

Memahami Kebutuhan Validasi Tamu Tertutup & Kuota Personalisasi

Pada pesta pernikahan berskala privat (intimate wedding) atau resepsi di gedung berkapasitas ketat, calon pengantin sering kali menghadapi kendala pembengkakan tamu. Tautan undangan digital yang disebarkan ke grup percakapan kerap diteruskan (forward) kepada pihak luar yang tidak diundang, memicu kehadiran tamu tak terduga yang menguras jatah konsumsi katering.

Selain risiko tamu liar, kebutuhan untuk membatasi kuota personal juga sangat mendesak. Pengantin ingin tamu VIP atau keluarga dekat diperbolehkan membawa 2 hingga 4 pendamping, sementara rekan kerja biasa dibatasi hanya 1 orang saja.

WDP RSVPKit memecahkan masalah ini melalui sub-tab Guest Integrations. Dengan menghubungkan lembar kerja Google Sheets dalam format CSV terpublikasi, sistem formulir secara otomatis memeriksa apakah nama yang diketik terdaftar dan mengunci batas maksimal pengisian pax sesuai angka yang telah ditetapkan pengantin di spreadsheet.

Prasyarat Sebelum Konfigurasi

Pastikan hal-hal berikut telah siap sebelum menghubungkan spreadsheet:

1. Google Sheets Telah Dibuat: Memiliki dokumen Google Spreadsheet yang memuat data tamu dengan kolom minimal: Nama Tamu dan Jatah Pax.
2. Publish to Web Aktif: Dokumen telah dipublikasikan melalui menu Google Sheets: File > Share > Publish to the web > Link > Comma-separated values (.csv).
3. Editor Postingan Terbuka: Buka lembar kerja postingan undangan Anda di WP Admin.

Bedah Mendalam Modul Guest Integrations

Untuk mengonfigurasi modul ini, buka postingan undangan di WP Admin dan klik sub-tab Guest Integrations (CSV) pada panel RSVPKit Settings:

1. Saklar Enable Guest List Validation

Mengaktifkan sistem gerbang validasi kehadiran:

• Status Nonaktif (Off): Formulir bersifat terbuka (open RSVP). Siapa pun yang memiliki tautan dapat mengetikkan nama bebas dan mengirimkan konfirmasi.
• Status Aktif (On): Formulir berubah menjadi sistem tertutup (closed RSVP). Tamu wajib mengetikkan nama yang terdaftar di basis data spreadsheet untuk dapat melanjutkan pengisian kehadiran.

2. Konfigurasi CSV URL & Alat Sinkronisasi

Menghubungkan sumber data lembar kerja Google:

• Google Sheet CSV URL (Publish to Web): Kolom tempat Anda menempelkan URL berakhiran format output=csv.
• Tombol Load Columns (AJAX): Tombol cerdas yang menghubungi server Google secara asinkron untuk membaca baris pertama (nama-nama kolom) dan menampilkannya pada pilihan dropdown pemetaan di bawahnya tanpa memuat ulang halaman WordPress.
• Tombol Clear Cache: Menghapus memori transient lokal seketika saat ada pembaruan nama atau alokasi kuota baru di file spreadsheet Google.

3. Pemetaan Kolom Dinamis (Dynamic Column Mapping)

Setelah tombol Load Columns ditekan, sistem menampilkan 3 kotak pilihan dropdown yang memuat seluruh nama kolom dari spreadsheet Anda:

• Kolom Nama Tamu: Pilih kolom yang memuat nama lengkap undangan (contoh: Nama Undangan atau Guest Name).
• Kolom Batas Kuota Pax: Pilih kolom yang menentukan jatah maksimal pendamping tamu tersebut (contoh: Jatah Pax atau Max Quota).
• Kolom Meja / Kategori VIP: Pilih kolom yang memuat informasi penempatan meja atau label kehormatan (contoh: Nomor Meja atau VIP Tag).

4. Proteksi Fallback Kuota Default

Jika dalam lembar kerja terdapat baris tamu yang kolom kuotanya kosong atau belum sempat diisi oleh pengantin, WDP RSVPKit secara otomatis menerapkan kuota aman bawaan (default: 1 Pax) agar formulir tetap dapat diproses dengan lancar.

Tabel Referensi Post Meta Keys Guest Integrations

Skenario Praktik Lapangan: Andy & Zhea

Pasangan Andy & Zhea menyelenggarakan acara makan malam resepsi berkonsep seated dinner di mana setiap tamu telah dialokasikan nomor meja dan jatah kursi khusus:

1. Penyusunan Spreadsheet: Pengantin membuat dokumen Google Sheets dengan 4 kolom utama: Nama Tamu, Alokasi Pax, Nomor Meja, dan Kategori.
2. Publikasi CSV: File dipublikasikan via menu Publish to Web berformat CSV dan tautannya ditempelkan di metabox undangan Andy & Zhea.
3. Pemetaan Kolom via AJAX: Vendor mengklik tombol Load Columns (AJAX). Seluruh nama kolom muncul secara instan di dropdown dan dipetakan sesuai fungsinya.
4. Pengalaman Tamu: Ketika tamu kehormatan Dr. H. Bambang Soediro membuka tautan undangan personalnya, formulir secara otomatis mendeteksi namanya, membatasi pilihan porsi maksimal 2 Pax, dan mengonfirmasi bahwa ia ditempatkan di Meja 01 VIP.
5. Hasil Operasional: Penyelenggara berhasil mencegah kehadiran tamu liar dan susunan meja resepsi berjalan rapi tanpa ada kursi yang tertukar.

Tips & Praktik Terbaik Integrasi Spreadsheet CSV

• Gunakan Baris Pertama Khusus Judul: Selalu letakkan judul nama kolom pada Baris 1 dokumen spreadsheet tanpa ada baris kosong di atasnya agar tombol AJAX dapat mendeteksi nama kolom dengan tepat.
• Hindari Simbol Rumit pada Judul Kolom: Berikan nama kolom yang sederhana dan konsisten (contoh: gunakan Nama_Tamu atau Nama Undangan tanpa tanda baca kurung atau garis miring berlebihan).
• Gunakan Trik Publish Otomatis: Centang opsi "Automatically republish when changes are made" di jendela Publish to Web Google Sheets agar setiap editan langsung siap dibaca oleh website.