Pemecahan Masalah

Kesimpulan

Sebagian besar masalah ZenBlocks dapat diselesaikan dengan Clear CSS Cache, mengaktifkan ulang plugin, dan membersihkan cache browser. Di bawah ini adalah langkah pemeriksaan untuk tiap masalah.

Blok tidak muncul di panel inserter

Langkah pemeriksaan

  1. Periksa apakah plugin aktif
  • Buka Plugins di dashboard WordPress
  • Pastikan ZenBlocks ada di daftar dan statusnya aktif
  • Jika nonaktif, klik Activate
  1. Periksa versi WordPress
  • Cek versi WordPress di Dashboard > Updates
  • ZenBlocks membutuhkan WordPress 6.0 atau lebih baru
  1. Periksa apakah Classic Editor aktif
  • Jika plugin Classic Editor aktif, block editor bisa dinonaktifkan
  • Pastikan editor default di Settings > Writing adalah block editor
  1. Periksa konflik dengan plugin lain
  • Nonaktifkan sementara semua plugin lain dan sisakan ZenBlocks saja
  • Jika blok muncul, aktifkan plugin lain satu per satu untuk menemukan penyebab konflik

Panel pengaturan tidak terbuka / tidak tampil

Langkah pemeriksaan

  1. Pastikan blok sedang dipilih
  • Klik blok untuk memilihnya
  • Pastikan ada bingkai biru di sekitar blok
  1. Periksa apakah sidebar terlihat
  • Klik ikon Settings (ikon roda gigi) di kanan atas editor
  • Pastikan tab Block di bagian atas sidebar sedang dipilih
  1. Periksa error di developer tools browser
  • Buka developer tools browser (F12)
  • Periksa apakah ada error JavaScript di tab Console
  • Jika ada error, laporkan di forum dukungan beserta screenshot

Style tidak diterapkan di front-end

Langkah pemeriksaan

  1. Bersihkan CSS cache
  • Buka Settings > ZenBlocks di dashboard WordPress
  • Klik Clear CSS Cache
  • Simpan ulang halaman yang bermasalah
  1. Bersihkan cache browser
  • Bersihkan cache browser
  • Atau lakukan hard reload dengan Ctrl+Shift+R / Cmd+Shift+R
  1. Simpan ulang halaman
  • Buka halaman target di editor
  • Klik Update
  • File CSS akan dibuat ulang
  1. Periksa cache sisi server
  • Jika menggunakan plugin cache seperti WP Super Cache, W3 Total Cache, atau LiteSpeed Cache, bersihkan cache tersebut juga
  • Jika menggunakan CDN seperti Cloudflare, purge cache CDN juga

Catatan: CSS cache ZenBlocks disimpan di /wp-content/uploads/zenblocks/. Pastikan direktori ini dapat ditulis.

Pengaturan responsive tidak diterapkan

Langkah pemeriksaan

  1. Periksa apakah nilai per perangkat sudah diatur
  • Di setiap panel pengaturan sidebar, klik ikon perangkat (PC / MD / TB / SP)
  • Jika nilai untuk perangkat tertentu kosong, nilai PC akan dipakai sebagai fallback
  1. Periksa breakpoint
  • Periksa nilai breakpoint di Settings > ZenBlocks
  • Pastikan nilai yang dikustomisasi sudah sesuai
  1. Bersihkan CSS cache
  • Responsive CSS disimpan di cache, jadi cache harus dibersihkan setelah mengubah pengaturan
  • Klik Settings > ZenBlocks > Clear CSS Cache
  1. Periksa di mode responsive browser
  • Buka developer tools browser (F12)
  • Ubah lebar tampilan pada device toolbar agar sesuai dengan breakpoint
  • Periksa tampilan pada setiap breakpoint

Animasi tidak berjalan

Langkah pemeriksaan

  1. Periksa apakah fitur Pro aktif (animasi adalah fitur Pro)
  • Pastikan lisensi berstatus Active di Settings > ZenBlocks
  • Pastikan plugin ZenBlocks Pro aktif
  1. Periksa pengaturan animasi
  • Buka panel Animation Settings di sidebar
  • Pastikan jenis animasi tidak diatur ke None
  • Pastikan Duration bukan 0
  1. Periksa di front-end
  • Animasi bisa dipratinjau di editor, tetapi pemeriksaan akhir harus dilakukan di front-end
  • Muat ulang halaman untuk melihat animasi diputar
  1. Periksa konflik dengan transisi
  • Jika animasi dan transisi aktif bersamaan, perilaku yang tidak diinginkan bisa terjadi
  • Periksa apakah ada peringatan di panel transition

Efek hover tidak bekerja

Langkah pemeriksaan

  1. Periksa apakah tab Hover memiliki nilai
  • Pilih tab Hover di panel pengaturan sidebar
  • Pastikan properti yang ingin diubah sudah memiliki nilai
  1. Periksa pengaturan transisi
  • Pastikan Duration pada panel transition tidak bernilai 0ms
  • Nilai yang direkomendasikan: 200ms sampai 400ms
  1. Bersihkan CSS cache lalu periksa lagi

Untuk detail lebih lanjut, lihat FAQ buttonBasic: style hover tidak diterapkan.

Muncul error validasi blok

Langkah pemeriksaan

  1. Perbarui plugin ke versi terbaru
  • Perbarui ZenBlocks dari Plugins > Updates di dashboard WordPress
  1. Pulihkan blok
  • Klik Attempt to recover block pada pesan error
  • Setelah dipulihkan, periksa pengaturan lalu simpan ulang halaman
  1. Jika masih belum selesai
  • Hapus blok lalu buat ulang
  • Jika sebelumnya disimpan sebagai custom design, terapkan preset ke blok baru untuk memulihkannya

Catatan: Error validasi dapat muncul ketika format output HTML berubah setelah update plugin. Fitur pemulihan blok akan menyesuaikannya ke format terbaru secara otomatis.

Jika masalah tetap berlanjut

Jika langkah di atas belum menyelesaikan masalah, silakan kirim laporan ke forum dukungan WordPress.org.

Saat mengirim laporan, sertakan informasi berikut:

  • Versi WordPress
  • Versi PHP
  • Nama tema yang digunakan
  • Versi ZenBlocks / ZenBlocks Pro
  • Langkah reproduksi masalah
  • Screenshot atau rekaman layar
  • Pesan error yang tampil di Console developer tools browser