Cara Mengatur IndoCheckout di WooCommerce (IndoOngkir Suite)
Panduan lengkap IndoCheckout: Status, Address Fields, Billing & Shipping Fields, Additional Fields, Classic vs Block, billing email, dan verifikasi checkout.
Checkout WooCommerce bawaan kadang terasa kurang pas untuk kebutuhan toko Indonesia: urutan field, mana yang wajib, label, sampai field yang ingin disembunyikan. Modul IndoCheckout membantu Anda mengatur show, required, label, placeholder, type, dan urutan field Checkout tanpa perlu menulis kode.
IndoCheckout terintegrasi erat dengan modul IndoOngkir: saat IndoOngkir aktif, field provinsi, kota, dan kelurahan/kecamatan mengikuti mode alamat IndoOngkir secara otomatis. Kalau IndoOngkir nonaktif, Anda mengontrol field alamat standar WooCommerce secara manual.
Rekomendasi: IndoCheckout paling matang di Classic Checkout (shortcode [woocommerce_checkout]). Checkout Block didukung untuk sebagian kebutuhan (misalnya urutan field), tetapi beberapa opsi (terutama email dan placeholder) masih terbatas.
Prasyarat
- Plugin WPBisnis - IndoOngkir For WooCommerce terpasang dan lisensi valid
- WooCommerce 3.0 atau lebih baru
- Halaman checkout dapat diakses untuk uji frontend
- Disarankan: baca Classic vs Block Cart/Checkout
Cara membuka pengaturan
- Login ke WordPress Admin.
- Buka WooCommerce → Pengaturan → IndoOngkir → IndoCheckout.
- Centang Status, atur tabel field, lalu Simpan perubahan.
Opsi yang tersedia
Pengaturan modul
| Label | Jenis | Default | Fungsi |
|---|---|---|---|
| Status | Checkbox | yes |
Mengaktifkan IndoCheckout. Nonaktifkan jika Anda memakai plugin checkout fields lain |
Tabel field (muncul saat Status aktif)
Setiap tabel punya kolom:
| Kolom | Fungsi |
|---|---|
| ID | Identitas field WooCommerce |
| Show | yes / no (tampilkan/sembunyikan field) |
| Required | yes / no (wajib diisi atau tidak) |
| Label | Teks label kustom (kosong = default Indonesia plugin) |
| Placeholder | Teks placeholder (terbatas di Classic Checkout untuk beberapa field) |
| Type | Tipe input jika didukung (misalnya address_1: text atau textarea) |
Tabel yang ditampilkan:
| Section di admin | Field utama |
|---|---|
| Address Fields | address_1, address_2, country, state, city, postcode, phone (WC 10.8.0+) |
| Billing & Shipping Fields | first_name, last_name, company, address, email, phone (jika belum dipindah ke address) |
| Additional Fields | order_comments (catatan pesanan) |
Catatan: Secara default plugin memakai mode single fields (use_single_fields): billing dan shipping dikelola dalam satu tabel Billing & Shipping Fields. Tabel Shipping terpisah tidak ditampilkan di admin.
Peringatan Billing Email (Classic Checkout)
Jika billing_email diset Show = no, plugin menampilkan peringatan:
- Guest Checkout otomatis dipaksa aktif
- Create an account during checkout otomatis dipaksa nonaktif
Langkah-langkah setup
1. Aktifkan modul
- Buka WooCommerce → Pengaturan → IndoOngkir → IndoCheckout.
- Pastikan Status dicentang.
- Simpan.
2. Atur Address Fields
- Di tabel Address Fields, seret baris (kolom sort) untuk mengubah urutan relatif field yang bisa diurutkan.
- Set Show/Required untuk
address_1,postcode, dan field lain yang editable. - Untuk
address_1, pilih Typetextareajika alamat panjang lebih nyaman. - Simpan.
3. Atur Billing & Shipping Fields
- Di tabel Billing & Shipping Fields, atur nama, email, telepon, perusahaan.
- Perhatikan catatan footer tabel (email dan placeholder khusus Classic Checkout).
- Simpan.
4. Atur Additional Fields
- Di Additional Fields, atur visibilitas order_comments.
- Simpan.
5. Verifikasi di checkout
- Buka halaman checkout di frontend.
- Bandingkan urutan dan label field dengan pengaturan admin.
- Coba submit dengan field wajib kosong untuk memastikan validasi berjalan.
Cara memastikan berhasil
- Field yang diset
Show = notidak muncul di Classic Checkout - Label Indonesia (misalnya Alamat Lengkap, No HP / Whatsapp) tampil jika label kustom kosong
- Urutan field mengikuti drag-sort di admin (dengan batasan hierarki, lihat tutorial Address Fields)
- Jika IndoOngkir aktif: provinsi, kota, kelurahan/kecamatan muncul otomatis setelah negara
Catatan dan troubleshooting
Perubahan tidak terlihat di Checkout Block
- Beberapa opsi (placeholder, sembunyikan email) hanya penuh di Classic Checkout
- Block Checkout memakai skrip
wcindocheckout-blockterbatas saat IndoOngkir nonaktif; dengan IndoOngkir aktif, field wilayah dikelola plugin ongkir
last_name tidak bisa disembunyikan di Block
- Catatan admin: last_name selalu tampil di Checkout Block meski diset hidden
Konflik plugin checkout lain
- Nonaktifkan Status IndoCheckout jika memakai plugin form checkout pihak ketiga
- IndoCheckout memfilter
woocommerce_billing_fields,woocommerce_shipping_fields, danwoocommerce_checkout_fieldsdengan prioritas sangat tinggi
Customizer WooCommerce
- IndoCheckout menghapus kontrol Customizer untuk company, address_2, dan phone supaya tidak bentrok dengan tabel admin