FAQ & Troubleshooting

Buka menu Ecommerce (sekarang Pengaturan lanjutan) lalu klik tautan Checklist Setup di kanan atas — itu dashboard setup dan daftar uji setelah publikasi. Dari daftar plugin, tautan Setup Ecommerce juga menuju halaman yang sama. Selama setup belum diterbitkan, menu Ecommerce langsung membuka wizard-nya.

Plugin Sejoli belum aktif. Buka Plugins, aktifkan Sejoli — atau klik tombol Activate Sejoli pada notice. Commerce berjalan otomatis begitu Sejoli tersedia.

Tidak. Semua fitur dimulai dalam kondisi nonaktif. Perubahan baru terjadi setelah Anda Publish Ecommerce Setup di wizard, dan mode Safe Start hanya mengaktifkan Commerce untuk produk pilihan.

Deactivate plugin-nya. Checkout native Sejoli kembali seperti semula; template notifikasi lama otomatis dipakai lagi; tidak ada data yang hilang.

Cek tiga hal: (1) status visibilitas produk di metabox Commerce Catalog Visibility; (2) Catalog Visibility Default global; (3) produk harus berstatus published. Atur cepat lewat kolom visibilitas di daftar produk.

Produk fisik wajib punya berat dan origin yang valid (setting fisik native Sejoli). Lengkapi datanya, atau isi Fallback Origin di Advanced Settings sebagai jaring pengaman.

Setiap penggantian homepage menyimpan snapshot pengaturan sebelumnya. Pulihkan lewat kartu Snapshot beranda tersedia di dashboard Ecommerce (Kembalikan beranda lama) atau lewat Pengaturan lanjutan → Storefront. Halaman Storefront sendiri tidak ikut terhapus.

Gunakan menu Reset Data (di bawah menu Sejoli): pilih scope-nya (Settings, Onboarding, Storefront, Visibilitas katalog) lalu ketik RESET untuk konfirmasi. Alat ini tidak menyentuh konten produk maupun data order — tersedia juga via WP-CLI: wp sejoli-commerce reset.

Fitur fisik masih beta dan nonaktif default — aktifkan di Advanced Settings → Physical Products. Bila sudah aktif namun checkout tetap terblokir, ada paket yang gagal mendapat ongkir: cek berat/origin produk dan cakupan layanan kurir ke daerah tujuan.

Pesan ini muncul bila penyedia ongkir gagal merespons saat itu juga — bukan karena data produk. Pesan kini menyertakan alasan dari penyedia. Cara menangani: coba ulang (tarik ulang total atau terima ulang bump) — hasil gagal tidak pernah di-cache, jadi langsung mengambil tarif baru. Untuk paket yang sebelumnya pernah berhasil dikutip, Commerce memakai otomatis salinan tarif terakhirnya (hingga 1 jam) selama gangguan. Bila gagal terus, cek kuota/status API ongkir di pengaturan Sejoli.

Tidak, selama Fallback Origin terisi di Advanced Settings. Produk tanpa origin otomatis memakai fallback global (ini berlaku juga untuk produk bump). Origin di produk tetap yang menang bila diisi. Dua-duanya kosong baru ditolak dengan pesan jelas.

Pastikan mode halaman produk = Commerce detail (global atau per produk). Pembeli/engine funnel bisa tetap memaksa checkout native dengan ?buy-now=1.

Periksa Enable Commerce /checkout intercept di Advanced Settings. Jika baru diaktifkan, buka Settings → Permalinks sekali (atau simpan ulang) untuk memperbarui rewrite rules. Ingat: /checkout/loading, /checkout/thank-you, dan /checkout/renew memang tetap milik Sejoli native.

Itu by design: list Orders menampilkan satu baris per transaksi. Rincian setiap produk ada di Order Inspector → tab Order Items.

Itu produk wadah internal tempat Commerce menampung transaksi multi-produk — normal, tidak bisa dibeli orang lain, dan jangan dihapus/diubah. Kelola transaksinya lewat menu Orders. Bila ada produk yang gagal terbentuk di dalam transaksi, gunakan tombol Manual Retry di Order Inspector. Laporan omzet native Sejoli otomatis mengecualikan order wadah ini agar tidak terhitung ganda.

Pembuatan order ditolak database saat itu terjadi. Buka Sejoli → Diagnostik Order: setiap kegagalan tercatat lengkap (penyebab, query, kode referensi) — kegagalan akibat kolom tabel order yang kurang (versi Sejoli core lebih baru dari skema lama) diperbaiki otomatis saat checkout dan order tetap tersimpan. Serahkan kode SJCOM-… ke dukungan bila perlu penelusuran lebih lanjut.

Ya, tetap dapat. Afiliasi menempel pada pengunjung, bukan produknya — selama produk yang dibeli mengaktifkan affiliate dan si member lolos syarat affiliate produk itu (mis. aturan harus pernah membeli), komisinya tetap jalan. Selengkapnya di Kupon Affiliate & Komisi.

Kupon affiliate mengalihkan seluruh komisi transaksi ke pemilik kupon — meski kupon itu hanya mendiskon satu produk di keranjang. Pengecualian: bila ada kupon affiliate dari dua orang berbeda, semuanya gugur dan komisi kembali ke pemilik link referral. Lihat diagram lengkapnya di Kupon Affiliate & Komisi.

Buka Order Inspector → Transaction untuk membandingkan total bayar vs jumlah seluruh produk di dalamnya. Sistem sudah mencoba perbaikan otomatis (status Needs Repair); bila berakhir Manual Review, cocokkan manual lalu jalankan Manual Retry.

Pembeli bisa meminta link baru lewat form di halaman tracking (nomor order + email/telepon yang cocok). Alternatif: buat/regenerate link dari panel tracking link di Order Inspector.

Perilaku normal: kuota waybill harian dari provider (Rajaongkir) untuk akun API key Anda sudah terpakai. Coba lagi besok, atau longgarkan Advanced Settings → Catalog & Pages — perbesar Courier data refresh interval (penampilan dalam jendela cache tidak mengonsumsi kuota) dan sesuaikan Max courier refreshes per package per day dengan paket akun Anda.

Timeline pelacakan saat ini hanya didukung untuk provider pengiriman Rajaongkir — bila toko memakai provider lain (mis. Mengantar), tombolnya memang tidak ditampilkan. Dukungan provider lain ada di roadmap; sementara itu pembeli tetap bisa melihat resi dan tautan situs kurir.

Pastikan kurir yang terpilih di paket sesuai dengan resi (resi J&T tidak bisa dilacak sebagai JNE). Kurir tertentu (mis. JNE) juga memverifikasi 5 digit terakhir nomor HP penerima — nomor tujuan yang salah saat checkout membuat pelacakan gagal meski resinya benar.

Jangan kirim notifikasi native lama secara manual untuk transaksi Commerce — gunakan Resend notification di Order Inspector agar notifikasi Ecommerce multi-produk yang terkirim.

Tidak. Template lama disimpan sebagai fallback dan diimpor ke template Ecommerce saat wizard. Menonaktifkan Commerce mengembalikan notifikasi native dengan isi template lama Anda.

Cek Pengaturan lanjutan → Tampilan → Header — toggle Tampilkan header toko bisa saja dimatikan (misalnya untuk pola homepage sendiri dengan katalog embed). Selama header aktif, tombol Keranjang dan Akun selalu tampil; menu dan pencarian punya toggle masing-masing.

Tekan tombol Reset pada color picker Background/Warna teks header lalu Save Changes — warna brand saat ini akan diisi ulang. Perlu dicatat: setelah di-Reset, warna header tersemat pada nilai brand saat itu; bila brand colour diubah lagi, tekan Reset sekali lagi untuk menyelaraskan.

Bisa. Pilih mode presentasi Pertahankan situs web yang sudah ada — homepage, tema, dan page builder (Elementor, Divi, dll.) Anda tidak disentuh. Bagian toko tinggal dipasang lewat shortcode di homepage: grid produk [sejoli_commerce_products], tombol keranjang [sejoli_commerce_cart_button], hingga minicart. Katalog, keranjang, dan checkout tetap dijalankan Commerce di halamannya sendiri. Panduan lengkap: Homepage dengan Page Builder.

Itu terjadi pada versi lama karena warna tema menimpa Commerce. Versi saat ini memakai warna brand (kartu Branding di tab Tampilan) untuk hover/fokus semua tombol dasar — stepper kuantitas, terapkan kupon, toolbar katalog, dan ring fokus keyboard. Pastikan plugin versi terbaru dan cache browser dibersihkan.

Pastikan (1) Enable embeddable catalog handoff aktif; (2) origin situs eksternal tercantum persis di Allowed Embed Origins (skema + host, tanpa path); (3) script data-target menunjuk elemen yang ada di halaman tersebut.

Token kadaluarsa (TTL default 600 detik) atau sudah pernah dipakai — token bersifat sekali pakai. Minta pengunjung mengulang dari katalog embed.

Aktifkan Enable catalog & cart routes in member area di Advanced Settings → Tools.