Cara Migrasi dari Block ke Classic Cart/Checkout (IndoOngkir Suite)
Panduan migrasi dari Cart/Checkout Block ke Classic shortcode untuk kontrol IndoCheckout, kalkulator ongkir cart, dan tampilan checkout yang lebih lengkap.
Banyak toko Indonesia memilih balik dari Cart/Checkout Block ke Classic shortcode karena beberapa kebutuhan praktis masih lebih “matang” di mode Classic: kontrol IndoCheckout lebih lengkap, shipping calculator di halaman Cart bisa dipakai, dan beberapa opsi tampilan IndoOngkir biasanya lebih konsisten. IndoOngkir Suite mendukung kedua mode; migrasi ini aman selama Anda mengikuti langkahnya dan menguji hasilnya di frontend.
Tutorial ini menjelaskan cara mengganti block Cart dan Checkout dengan shortcode [woocommerce_cart] dan [woocommerce_checkout], lalu memverifikasi ongkir dan field alamat setelah perubahan.
Prasyarat
- Sudah membaca Classic vs Block Cart dan Checkout (IndoOngkir Suite)
- Plugin IndoOngkir Suite aktif, lisensi valid
- Modul IndoOngkir enabled; IndoCheckout aktif jika Anda butuh urutan field kustom
- Jika toko sudah live, uji di staging atau pastikan ada backup database sebelum mengubah halaman keranjang/checkout.
Cara membuka halaman yang akan dimigrasi
- Buka WooCommerce → Pengaturan → Lanjutan.
- Catat halaman di Cart page dan Checkout page (section Page setup).
- Buka Halaman → All Pages, edit masing-masing halaman.
Langkah-langkah
1. Migrasi halaman Cart ke shortcode Classic
- Edit halaman keranjang toko.
- Hapus block Cart (
woocommerce/cart) dari konten halaman. - Tambahkan block Shortcode (atau blok Paragraf), lalu ketik persis:
[woocommerce_cart]- Klik Update / Perbarui.
Opsional: aktifkan kalkulator ongkir di cart
- Buka WooCommerce → Pengaturan → Shipping.
- Di section Shipping settings, centang Enable the shipping calculator on the cart page jika ingin pelanggan menghitung ongkir dari halaman keranjang (fitur ini tidak tersedia di Cart Block).
- Klik Save changes.
2. Migrasi halaman Checkout ke shortcode Classic
- Edit halaman checkout toko.
- Hapus block Checkout dari konten.
- Tambahkan shortcode:
[woocommerce_checkout]- Klik Update / Perbarui.
3. Pastikan halaman Cart dan Checkout terdaftar di WooCommerce
- Buka WooCommerce → Pengaturan → Lanjutan.
- Pastikan Cart page dan Checkout page masih mengarah ke halaman yang baru diedit.
- Klik Save changes jika diperlukan.
4. Sesuaikan IndoCheckout (jika modul aktif)
- Buka WooCommerce → Pengaturan → IndoOngkir → IndoCheckout.
- Pastikan checkbox Status (Aktifkan modul IndoCheckout) centang.
- Atur urutan field Address Fields, Billing Fields, Shipping Fields, dan Additional Fields di tabel pengaturan IndoCheckout (drag-and-drop atau toggle Show / Required per field).
- Klik Save changes.
Catatan dari plugin untuk Classic shortcode:
- Jika billing_email disembunyikan, Guest checkout dipaksa aktif di halaman checkout Classic.
- Placeholder field hanya berlaku untuk
[woocommerce_checkout]shortcode.
Cara memastikan sudah berjalan
Uji di frontend (tab incognito):
- Cart: produk tampil, total benar; jika kalkulator ongkir WooCommerce aktif, form estimasi ongkir muncul di cart Classic.
- Checkout: field alamat mengikuti urutan IndoCheckout (jika modul aktif).
- Alamat Indonesia: provinsi, kota, kecamatan atau autocomplete berfungsi sesuai Mode Input Alamat di sub-tab IndoOngkir.
- Ongkir: metode kurir IndoOngkir muncul setelah alamat valid.
- IndoDiskon / IndoAsuransi / IndoCOD: biaya tambahan tampil di ringkasan jika modul tersebut enabled.
Kapan migrasi ini direkomendasikan?
| Kebutuhan toko | Alasan pilih Classic |
|---|---|
| IndoCheckout aktif | Kontrol penuh urutan dan visibilitas field |
| Kalkulator ongkir di cart | Cart Block menonaktifkan kalkulator via plugin |
| Opsi tampilan cart/checkout IndoOngkir | Beberapa opsi hanya untuk shortcode Classic |
| Sembunyikan billing_email | Aturan guest checkout khusus Classic |
Catatan
- Setelah migrasi, clear cache tema, plugin cache, dan CDN jika tampilan checkout tidak berubah.
- Jika sebelumnya memakai block-only plugin pembayaran, pastikan gateway masih kompatibel dengan Classic checkout.
Troubleshooting
Shortcode tampil sebagai teks di halaman
- Pastikan shortcode dimasukkan lewat block Shortcode, bukan sebagai teks biasa di HTML yang di-escape.
- Pastikan halaman memakai editor block atau classic yang merender shortcode.
Field checkout tidak mengikuti IndoCheckout
- Pastikan halaman memakai
[woocommerce_checkout], bukan block Checkout. - Pastikan modul IndoCheckout enabled di sub-tab IndoCheckout.
Kalkulator ongkir tidak muncul di cart
- Aktifkan Enable the shipping calculator on the cart page di WooCommerce → Pengaturan → Shipping.
- Pastikan halaman cart memakai
[woocommerce_cart], bukan block Cart.