Arsitektur Native WP_Query: Solusi Tanpa iFrame atau Reverse Proxy

Arsitektur Native WP_Query pada WDP Link Post bekerja dengan mengintersepsi query WordPress pada hook parse_request dan pre_get_posts. Mesin ini memetakan host domain kustom langsung ke entri ID posting asli di database, lalu menjalankan eksekusi native WP_Query dalam konteks jendela tingkat atas (top-level browsing context). Hasilnya, situs web undangan berjalan 100% native tanpa pembungkus <iframe> dan tanpa perlu konfigurasi reverse proxy Nginx yang rumit.

Tantangan Klasik Perutean Domain pada Website Undangan

Banyak vendor undangan pernikahan digital berbasis WordPress terjebak pada metode lama saat menyediakan fitur subdomain atau custom domain untuk klien. Dua metode yang paling umum digunakan namun bermasalah adalah:

1. Metode iFrame / Web Forwarding Masking: Domain pengantin memuat halaman pembungkus satu baris yang menyematkan link website asli vendor via tag <iframe>.
2. Reverse Proxy Eksternal: Menjalankan server proxy perantara (seperti Cloudflare Workers atau server VPS Nginx terpisah) untuk me-rewrite URL.

Kedua pendekatan ini menimbulkan hambatan teknis serius di era browser modern yang memprioritaskan privasi dan keamanan ketat.

Dampak Keterbatasan iFrame terhadap Pengalaman Pengunjung

Ketika undangan pernikahan dibuka melalui wrapper iFrame, sistem keamanan browser mobile (khususnya Safari iOS dan Google Chrome) menganggap website undangan sebagai konten pihak ketiga (third-party context). Dampaknya sangat fatal bagi momen pernikahan klien:

• Audio Autoplay Terblokir: Browser memblokir eksekusi API AudioContext atau pemutaran musik otomatis karena mendeteksi interaksi pengguna berada di luar dokumen induk.
• RSVP dan Komentar Gagal: Safari Intelligent Tracking Prevention (ITP) memblokir pengiriman cookie sesi dan token nonce AJAX karena dianggap cross-site tracking.
• Tampilan Terpotong di Ponsel: Scroll bar ganda muncul, viewport 100vh berantakan saat keyboard virtual muncul, dan tombol buka undangan seringkali tidak merespons sentuhan.
• Pratinjau WhatsApp Hilang: Saat link dibagikan di WhatsApp, bot perayap hanya membaca metadata halaman pembungkus iFrame kosong tanpa gambar mempelai.

Bagi vendor seperti Andy yang menangani pesanan undangan pernikahan untuk klien bernama Zhea, kegagalan teknis ini merusak reputasi profesional dan memicu komplain bertubi-tubi dari keluarga kedua mempelai.

Solusi Terpadu: Pure In-Process WP_Query Engine

WDP Link Post mengeliminasi seluruh masalah di atas dengan arsitektur In-Process Request Interception. Mesin ini tidak membungkus halaman dalam iFrame dan tidak memerlukan server perantara.

Tahapan Eksekusi Internal

1. Host Extraction: Saat permintaan masuk ke server web (misalnya https://andy-zhea.com), WDP Link Post menangkap variabel $_SERVER['HTTP_HOST'] pada fase awal boot WordPress.
2. Database Lookup: Router mencocokkan host dengan entri tabel database wp_wdplp_mappings atau meta key _wdplp_subdomain.
3. Query Alteration: Pada hook parse_request, WDP Link Post mengubah parameter query internal:

   add_action('parse_request', function($wp) {
       $matched_post_id = WDPLP_Router::resolve_host($_SERVER['HTTP_HOST']);
       if ($matched_post_id) {
           $wp->query_vars = [
               'p' => $matched_post_id,
               'post_type' => get_post_type($matched_post_id)
           ];
       }
   });

1. Direct Rendering: WordPress merender template Elementor langsung sebagai dokumen HTML utama. Browser membaca dokumen tersebut sebagai first-party context, sehingga seluruh API JavaScript, audio, cookies, dan aset CSS bekerja normal.

Studi Kasus Nyata: Pernikahan Andy & Zhea

Vendor WeddingPress mengatur proyek undangan pernikahan untuk pasangan Andy dan Zhea.

• Domain Kustom Klien: https://andy-zhea.com
• Database Hosting Utama: portal-undangan.com (ID Post: 418)

Dengan arsitektur native ini:

1. Tamu undangan mengetik https://andy-zhea.com/?to=Bapak+Budi di peramban iPhone mereka.
2. Server Apache / LiteSpeed mengarahkan lalu lintas ke instalasi WordPress utama.
3. WDP Link Post memetakan host ke Post ID 418 secara instan dalam memori (overhead waktu di bawah 1.8 milidetik).
4. Musik langsung berputar saat tombol "Buka Undangan" ditekan.
5. Form konfirmasi RSVP terkirim sukses tanpa hambatan cookie safari.

Tabel Komparasi: Native WP_Query vs iFrame

Tips & Praktik Terbaik