Cara Mengatur Urutan Field Alamat di Checkout (IndoOngkir Suite)
Panduan Address Fields IndoCheckout: urutan drag-sort, show/required/label/placeholder/type, batasan hierarki, dan perilaku dengan IndoOngkir aktif.
Field alamat menentukan bagaimana pelanggan mengisi alamat: jalan, wilayah, kode pos, dan (sejak WooCommerce 10.8.0+) nomor telepon. IndoCheckout mengelolanya lewat tabel Address Fields, lengkap dengan kontrol per field dan opsi drag-sort untuk baris yang memang bisa diurutkan.
Saat modul IndoOngkir aktif, beberapa field wilayah dikelola otomatis (provinsi, kota, kelurahan/kecamatan) sehingga tidak semuanya bisa diatur show/required secara terpisah di tabel. Kalau IndoOngkir nonaktif, Anda mengatur state, city, dan address_2 secara manual—dengan aturan hierarki yang tetap.
Prasyarat
- Status IndoCheckout aktif
- Sudah membaca Cara Mengatur IndoCheckout
- Ketahui apakah modul IndoOngkir aktif (mempengaruhi field yang editable)
Cara membuka pengaturan
- Buka WooCommerce → Pengaturan → IndoOngkir → IndoCheckout.
- Scroll ke tabel Address Fields.
- Seret ikon sort di kolom pertama untuk mengubah urutan, lalu simpan.
Field Address Fields
Saat IndoOngkir aktif
| ID di tabel | Show/Required editable? | Label editable? | Keterangan |
|---|---|---|---|
address_1 |
Ya | Ya | Default label: Alamat Lengkap. Type: text atau textarea |
country |
Tidak (tetap yes) | Tidak | Ditampilkan sebagai country/province/city/subdistrict atau country/subdistrict sesuai mode alamat IndoOngkir |
state, city, address_2, postcode |
Diinjeksi otomatis | Sebagian otomatis | Provinsi, Kota, Kelurahan & Kecamatan, Kode pos mengikuti logika IndoOngkir |
phone (WC 10.8.0+) |
Ya | Ya | Telepon dipindah dari billing ke address fields |
Saat IndoOngkir nonaktif
| ID | Show/Required | Label | Catatan hierarki |
|---|---|---|---|
address_1 |
Editable | Editable | Type text/textarea |
address_2 |
Editable | Editable | Selalu di bawah address_1 saat disimpan |
country |
Fixed | - | Negara |
state |
Label/placeholder | Editable label | Selalu di bawah country |
city |
Label/placeholder | Editable label | Selalu di bawah state |
postcode |
Editable | Editable | Default: show yes, required no |
phone (WC 10.8.0+) |
Editable | Editable | Catatan: phone pindah ke address sejak WC 10.8.0+ |
Kolom tabel (semua field yang editable)
| Kolom | Nilai | Fungsi |
|---|---|---|
| Show | yes / no | Menampilkan atau menyembunyikan field |
| Required | yes / no | Wajib diisi sebelum checkout |
| Label | Teks | Mengganti label default (placeholder abu-abu menunjukkan default plugin) |
| Placeholder | Teks | Petunjuk di dalam field |
| Type | text / textarea | Hanya untuk address_1 |
Langkah-langkah
1. Review field default
- Buka tabel Address Fields.
- Perhatikan ID yang bisa diedit vs yang read-only (background abu-abu).
- Baca catatan di bawah tabel tentang hierarki country/state/city atau phone WC 10.8.0+.

2. Atur show dan required
- Set
address_1Required = yes (disarankan untuk pengiriman fisik). - Atur
postcode: banyak toko Indonesia memakai Required = no jika kode pos opsional. - Untuk
phone, set Show = yes dan Required = yes jika CS membutuhkan WhatsApp.

3. Ubah urutan (field yang sortable)
- Seret baris menggunakan handle di kolom sort.
- Ingat batasan otomatis saat simpan:
address_2selalu disimpan setelahaddress_1statedancityselalu setelahcountry(mode tanpa IndoOngkir)
- Klik Simpan perubahan.
4. Uji di checkout
- Buka Classic Checkout.
- Pastikan urutan: nama → alamat → wilayah → telepon sesuai harapan.
- Jika IndoOngkir aktif, pastikan dropdown/autocomplete kelurahan berfungsi.

Cara memastikan berhasil
- Field hidden tidak muncul di form checkout
- Validasi menolak submit jika field required kosong
- Dengan IndoOngkir: ongkir tetap terhitung setelah wilayah lengkap terisi
Catatan dan troubleshooting
Urutan tidak berubah setelah simpan
- Hierarki
country → state → citydanaddress_1 → address_2dipaksa ulang oleh plugin saat save - Urutan relatif field lain (misalnya posisi
postcodevsphone) tetap bisa disesuaikan
Checkout Block: address_2 selalu required
- Plugin memaksa
address_2required di Block Checkout jika field ditampilkan
Label “Kelurahan & Kecamatan” salah ketik di kode
- Label internal plugin untuk
address_2saat IndoOngkir aktif; Anda bisa mengubahnya lewat kolom Label jika field editable.
Telepon tidak ada di Billing Fields
- WooCommerce 10.8.0+: kelola telepon di Address Fields, bukan Billing