Classic vs Block Cart dan Checkout (IndoOngkir Suite)
Perbandingan Classic Cart/Checkout shortcode vs Cart/Checkout Block WooCommerce, serta dukungan dan batasan fitur IndoOngkir Suite di setiap mode.
WooCommerce menyediakan dua cara menampilkan halaman Cart dan Checkout: Classic (shortcode) dan Block (Gutenberg). Sekilas hasilnya bisa terlihat mirip di frontend, tetapi cara field alamat dirender, cara kalkulator ongkir bekerja, dan hook plugin dieksekusi itu berbeda.
IndoOngkir Suite mendukung kedua mode untuk perhitungan ongkir inti. Namun, beberapa modul (terutama IndoCheckout) dan shipping calculator di halaman Cart biasanya lebih lengkap kalau Anda memakai Classic shortcode. Tutorial ini membantu Anda memilih mode yang paling pas sebelum lanjut konfigurasi.
Apa itu Classic Cart/Checkout?
Halaman cart dan checkout memakai shortcode WordPress di dalam halaman:
| Halaman | Shortcode |
|---|---|
| Keranjang | [woocommerce_cart] |
| Checkout | [woocommerce_checkout] |
Ini adalah cara tradisional WooCommerce. Banyak tema Indonesia dan plugin ongkir (termasuk IndoCheckout) paling matang di mode ini.
Apa itu Cart/Checkout Block?
Halaman cart dan checkout memakai block Gutenberg WooCommerce:
| Halaman | Block |
|---|---|
| Keranjang | Cart (woocommerce/cart) |
| Checkout | Checkout (woocommerce/checkout) |
Instalasi WooCommerce baru sering memakai block sebagai default. Editor WordPress memang lebih terintegrasi, tetapi beberapa kustomisasi field checkout dari plugin pihak ketiga belum selalu setara dengan Classic.
Prasyarat
- Plugin IndoOngkir Suite terpasang, lisensi valid
- Modul IndoOngkir aktif (checkbox Status di sub-tab IndoOngkir)
- Anda bisa mengedit halaman Cart dan Checkout di Halaman WordPress admin
Cara membuka pengaturan yang relevan
Cek mode cart/checkout (editor halaman):
- Buka Halaman di WordPress admin.
- Edit halaman keranjang dan checkout yang dipakai toko.
Pengaturan IndoOngkir yang terpengaruh mode checkout:
- Buka WooCommerce → Pengaturan → IndoOngkir → IndoOngkir.
- Perhatikan opsi di section terkait alamat dan tampilan, misalnya Mode Input Alamat dan opsi tampilan cart/checkout.
Pengaturan IndoCheckout (jika modul aktif):
- Buka WooCommerce → Pengaturan → IndoOngkir → IndoCheckout.
- Baca catatan di halaman tentang batasan Checkout Block vs
[woocommerce_checkout]shortcode.
Cara mengecek mode yang sedang dipakai
- Edit halaman keranjang toko Anda.
- Jika konten berisi shortcode
[woocommerce_cart]→ Classic Cart. - Jika konten berisi block Cart → Block Cart.
- Ulangi untuk halaman checkout:
[woocommerce_checkout]= Classic Checkout, block Checkout = Block Checkout.
Perbandingan fitur IndoOngkir Suite
| Fitur / modul | Classic (shortcode) | Block |
|---|---|---|
| IndoOngkir: hitung ongkir di checkout | Didukung penuh | Didukung |
| Mode Input Alamat (autocomplete / berurutan) | Didukung penuh | Didukung; jika menjual ke internasional (bukan hanya Indonesia), mode autocomplete dipaksa |
| Tampilan asal pengiriman, berat, ETD di checkout | Didukung | Terbatas (beberapa opsi khusus Classic) |
| Shipping calculator di halaman cart | Didukung (jika Enable the shipping calculator on the cart page aktif di WooCommerce) | Dinonaktifkan otomatis saat halaman memakai block Cart |
| IndoCheckout: urutan dan visibilitas field | Direkomendasikan | Didukung, belum 100% setara |
| IndoCheckout: billing_email disembunyikan | Aturan guest checkout khusus berlaku di Classic | Perilaku berbeda di Block |
| IndoCheckout: last_name | Bisa disembunyikan | Tidak bisa disembunyikan di Checkout Block |
| IndoDiskon, IndoAsuransi, IndoCOD | Didukung | Didukung |
Catatan teknis dari plugin
- Di halaman dengan block Cart, plugin memaksa opsi kalkulator ongkir WooCommerce menjadi nonaktif (
woocommerce_enable_shipping_calc=no) agar tidak bentrok dengan Cart Block. - Script khusus block (
wcindoongkir-block) hanya dimuat jika halaman checkout memakai block Checkout. - IndoCheckout memuat catatan admin bahwa pengaturan billing_email dan placeholder hanya berlaku untuk
[woocommerce_checkout]shortcode.
Rekomendasi pemilihan mode
| Situasi toko | Mode yang disarankan |
|---|---|
| IndoCheckout aktif, butuh urutan field Indonesia lengkap | Classic Cart + Classic Checkout |
| Butuh shipping calculator di halaman keranjang | Classic Cart shortcode |
| Sudah pakai Block, ongkir jalan normal, tidak pakai IndoCheckout berat | Boleh tetap Block; uji semua fitur yang dipakai |
| Toko internasional + Checkout Block | Siapkan mode autocomplete alamat (bukan input berurutan provinsi/kota) |
Langkah singkat: ganti mode (jika perlu)
Jika setelah membaca perbandingan Anda memutuskan pindah mode:
- Classic → Block: Cara Migrasi dari Classic ke Cart/Checkout Block (IndoOngkir Suite)
- Block → Classic: Cara Migrasi dari Block ke Classic Cart/Checkout (IndoOngkir Suite)
Cara memastikan mode + ongkir berjalan
- Tentukan mode dari editor halaman (shortcode atau block).
- Tambahkan produk ke keranjang, buka checkout sebagai pengunjung (tab incognito).
- Isi alamat pengiriman Indonesia (provinsi, kota, kecamatan sesuai Mode Input Alamat).
- Pastikan metode pengiriman IndoOngkir muncul dengan tarif.
- Jika memakai IndoCheckout, bandingkan urutan field dengan pengaturan di sub-tab IndoCheckout.
Troubleshooting
Ongkir muncul di Classic tetapi tidak di Block
- Pastikan halaman checkout memakai block Checkout, bukan shortcode campuran.
- Cek Mode Input Alamat di sub-tab IndoOngkir; untuk penjualan multi-negara, autocomplete bisa dipaksa di Block.
- Lihat Troubleshooting: Ongkir Tidak Muncul di Checkout (IndoOngkir Suite).
Urutan field checkout tidak sesuai pengaturan IndoCheckout
- IndoCheckout paling akurat di
[woocommerce_checkout]shortcode. Pertimbangkan migrasi ke Classic: Cara Migrasi dari Block ke Classic Cart/Checkout (IndoOngkir Suite).
Kalkulator ongkir tidak ada di halaman cart
- Di Block Cart, kalkulator memang dinonaktifkan plugin. Pakai Classic Cart atau hitung ongkir langsung di checkout.