Modal Prabaca — prabaca blok dalam modal
PreviewModal — modal yang umum untuk semua layar pengaturan Wave-2, yang menunjukkan hasil kerja blok secara real-time. Dibuka dengan tombol «Open in modal» pada layar pengaturan.
Mengapa ini diperlukan
Ketika Anda mengatur blok (strategi, filter, audiens) — Anda ingin segera memahami produk apa yang akan muncul dengan pengaturan tersebut. PreviewModal memungkinkan Anda untuk memeriksa ini tanpa menerbitkan blok di situs dan tanpa beralih antara admin dan frontend.
Tab Dasar — daftar produk
Tab pertama — Basic. Menampilkan tabel produk yang akan dikembalikan oleh API dengan pengaturan blok saat ini:
- Pengunduhan dilakukan dengan infinite scroll melalui komponen
NewBlockPreviewTable. - Di tabel — prabaca kartu (nama, gambar, penanda, metadata singkat).
- Daftar diperbarui secara otomatis saat pengaturan blok di layar induk diubah.
Tab Investigasi — diagnosis
Tab kedua — Investigate — diperlukan untuk debugging. Di sini terlihat apa yang terjadi "di balik layar" saat membentuk hasil:
| Kolom | Apa artinya |
|---|---|
| appliedAudienceRule | Aturan audiens mana yang diterapkan untuk permintaan saat ini. Lihat Filter Audiens. |
| warnings | Diagnosis — misalnya, "set atribut kosong", "fallback memilih produk tidak dari kategori yang dipilih". |
| fallbackUsed | Flag: apakah jalur fallback (tampilan produk tren cadangan) telah dijalankan. |
| contextEcho | Echo konteks permintaan — apa yang sebenarnya diterima sistem (user ID, keranjang, kategori yang dipilih, dll.). |
Jika backend tidak mengembalikan kolom tertentu — bagian Investigate yang sesuai akan disembunyikan, tanpa kesalahan. Ini dilakukan untuk pengembangan API yang tidak menyakitkan.
Simulated user ID — prabaca "atas nama" pengguna
Di bawah kolom Prabaca ada input Simulated user ID. Masukkan ID pengguna mana pun — prabaca akan membangun hasil seolah-olah permintaan datang dari dia. Berguna untuk:
- Memeriksa rekomendasi pribadi (Personal recommendations, Repeat purchase) untuk klien tertentu;
- Merekayasa keluhan seperti "saya tidak melihat produk yang tepat di blok" — masukkan ID-nya dan lihat apa yang akan dia lihat.
Tanpa menyebutkan Simulated user ID, prabaca menggunakan konteks admin Anda sendiri, dan untuk blok yang dipersonalisasi, hasilnya bisa kosong atau tidak relevan.
Hak akses blocks.preview
Akses ke endpoint admin prabaca blok dikontrol oleh hak terpisah blocks.preview dalam pohon hak.
Ini memungkinkan:
- Memberikan peran yang mengedit blok, tanpa akses ke prabaca (misalnya, untuk manajer konten "hanya-form").
- Menyembunyikan data sensitif dari beberapa admin yang dapat terungkap melalui Investigate (konteks permintaan, echo parameter).
Untuk pengembang dan QA — selalu berikan blocks.preview. Untuk manajer konten — hanya jika mereka harus melihat hasil aktual blok sebelum publikasi.