=== WD Smart Shipping ===
Contributors: webdeveloperid
Tags: woocommerce, ongkir, shipping, jne, gosend
Requires at least: 6.4
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 0.5.7
License: Proprietary

Ongkir otomatis multi-kurir untuk WooCommerce lewat WD Shipping Gateway milik WebDeveloper.id.

== Description ==

* Kurir reguler, ekonomi, ekspres, dan kargo: JNE, J&T, SiCepat, AnterAja, Pos Indonesia, TIKI, Ninja Xpress, ID Express, Lion Parcel, dan lainnya.
* Kurir instan dan same day: GoSend, GrabExpress, Lalamove (tarif per jarak; pembeli memasang pin di peta checkout).
* Markup nominal atau persen dengan batas minimum/maksimum, biaya penanganan, pembulatan, dan promo gratis ongkir minimal belanja.
* Asuransi pengiriman opsional: pembeli mencentang "Asuransikan paket" di checkout, biaya asuransi dari kurir ditambahkan ke ongkir.
* Jam operasional kurir instan/same day (WIB), plus jam pesan toko sendiri.
* Pesan yang jelas bila ongkir tidak tersedia (kode pos belum diisi, pin belum dipasang, di luar jam operasional, kurir tidak melayani alamat, gangguan sementara); checkout tidak menunggu lama saat gateway bermasalah.
* Tab Status menampilkan kuota request harian dan peringatan saat hampir habis.
* Tidak ada API key agregator di website: plugin hanya menyimpan site token (terenkripsi).
* Lacak resi: isi nomor resi di pesanan, pembeli melihat status pengiriman; opsional pesanan otomatis Selesai saat paket terkirim.
* Buat resi otomatis (bila diaktifkan WebDeveloper.id untuk toko Anda): kurir pilihan pembeli dipesan dari halaman pesanan, dengan jadwal jemput atau antar ke agen; status resi diperbarui otomatis.
* Cetak label pengiriman 100×150 mm dengan barcode resi, satu per satu atau banyak pesanan sekaligus.
* Multi-gudang: produk memilih gudang asalnya; keranjang dari beberapa gudang dihitung ongkirnya per gudang.
* Saldo dan biaya resi bulan ini tampil di tab Status (untuk toko dengan deposit resi).
* Bila gateway atau kurir sedang bermasalah, plugin tidak menampilkan tarif palsu.

== Installation ==

1. WordPress → Plugin → Tambah Baru → Unggah Plugin, pilih `wd-smart-shipping-<versi>.zip`, pasang, lalu aktifkan
   (atau salin folder `wd-smart-shipping` ke `wp-content/plugins/`).
2. Buka WooCommerce → WD Smart Shipping → Status, isi site token dari WebDeveloper.id, simpan.
3. Tab Pengiriman: isi kode pos asal dan koordinat gudang (koordinat wajib untuk kurir instan).
4. Tab Kurir dan Harga: pilih kurir, atur markup.
5. WooCommerce → Pengaturan → Pengiriman: tambahkan metode "WD Smart Shipping" ke zona Indonesia.

== Compatibility ==

* WordPress 6.4 atau lebih baru (diuji sampai 7.1), PHP 7.4 atau lebih baru (diuji sampai 8.5).
* WooCommerce 8.0 atau lebih baru (diuji sampai 11.2). Checkout Blocks: WooCommerce 8.3 atau lebih baru
  (sebelum 8.3 WooCommerce memakai checkout klasik).
* HPOS (High-Performance Order Storage) maupun penyimpanan pesanan lama (posts): didukung.
* Checkout klasik (shortcode) dan Checkout Blocks: semua fitur, termasuk peta pin untuk kurir instan,
  pesan saat ongkir kosong, dan centang asuransi.

Diuji otomatis (WordPress Playground, uji PHP + browser sampai pesanan dibuat) pada:

* WordPress 6.4 · WooCommerce 8.0 · PHP 7.4 (checkout klasik)
* WordPress 6.4 · WooCommerce 8.3 · PHP 7.4
* WordPress 6.6 · WooCommerce 9.4 · PHP 8.1
* WordPress 6.8 · WooCommerce 10.2 · PHP 8.2 · HPOS
* WordPress 7.1 · WooCommerce 11.2 · PHP 8.5 · HPOS

== Changelog ==

= 0.5.7 =
* Berat bawaan (untuk produk tanpa berat) kini juga tersimpan di gateway, sehingga bisa diubah dari dashboard WD Smart Shipping tanpa membuka WordPress. Tab Pengiriman menampilkan nilai yang sama. Pengaturan ongkir lain (kurir, harga, promo, asuransi, jam pesan) sudah bisa diubah di dashboard dan dipakai langsung oleh plugin.

= 0.5.6 =
* Pilihan alamat di checkout klasik dan Akun saya → Alamat: Kota/Kabupaten, Kecamatan, lalu Kode pos dipilih dari daftar wilayah Indonesia (Kepmendagri 2025), bisa dicari dengan nama kelurahan. Kecamatan tersimpan di pesanan, tampil di alamat, email, resi otomatis, dan label. Alamat tersimpan yang tidak cocok dengan daftar tetap dipakai apa adanya. Bisa dimatikan di tab Pengiriman ("Pilihan alamat") atau oleh tema lewat filter `wdss_address_dropdowns`. Checkout Blocks memakai isian bawaannya.
* Akun saya → Pesanan: kolom Resi (nomor dan status terakhir) di daftar pesanan pembeli.
* Menu "Aksi pesanan" WooCommerce: Buat resi otomatis (jemput secepatnya), Cek nomor resi, Batalkan resi otomatis, dan Perbarui status pelacakan, sama dengan tombol di kotak Resi & pelacakan.

= 0.5.5 =
* Pemasangan lebih mudah: selama toko belum terhubung ada pemberitahuan "Daftar gratis" di layar admin; setelah daftar (atau menempel token pertama kali) metode WD Smart Shipping otomatis dipasang di zona pengiriman Indonesia, lalu toko diarahkan ke tab Pengiriman untuk mengisi kode pos gudang.
* Daftar langkah di tab Status: tombol "Pasang otomatis" untuk metode pengiriman.

= 0.5.4 =
* Pengingat paket: mulai 3 hari sebelum paket Pro/Bisnis berakhir muncul pemberitahuan di WP Admin dan satu email ke admin situs; seminggu setelah berakhir ada pemberitahuan bahwa toko kembali ke Free.
* Paket Bisnis: jatah 500 resi otomatis per bulan (resi batal/gagal tidak dihitung), tampil di tab Status dan kartu paket.

= 0.5.3 =
* Tab Saldo resi yang dibuka di paket Free/Pro tidak lagi diawali kalimat "Isi saldo…", langsung menjelaskan bahwa saldo hanya untuk paket Bisnis.

= 0.5.2 =
* Tab Saldo resi hanya tampil di paket Bisnis (satu-satunya paket yang bisa Buat resi otomatis), supaya toko Free/Pro tidak isi saldo yang tidak terpakai. Saldo yang sudah ada tetap tersimpan.

= 0.5.1 =
* Bila gateway belum mendukung paket, tab Paket dan Daftar gratis memberi tahu dengan jelas (bukan "Jawaban gateway tidak bisa dibaca").

= 0.5.0 =
* Daftar gratis langsung dari plugin (tab Status): toko mendapat site token sendiri dengan paket Free, domain diverifikasi otomatis.
* Tab baru Paket: pilih Pro atau Bisnis, transfer nominal + kode unik, upload bukti; paket aktif 30 hari setelah disetujui dan bisa diperpanjang.
* Paket toko (Free, Pro, Bisnis) tampil di tab Status bersama sisa cek ongkir hari ini. Kurir di luar paket terkunci di tab Kurir, tab Harga memberi tahu bila markup/promo/asuransi belum termasuk paket, dan pesan yang jelas saat resi atau lacak butuh paket Bisnis.

= 0.4.0 =
* Tab baru Saldo resi: toko mengisi saldo resi sendiri lewat transfer bank (nominal + kode unik), upload bukti transfer, lalu disetujui WebDeveloper.id. Riwayat top up dan status tampil di tab yang sama.

= 0.3.9 =
* Logo kurir memakai `class="wdss-logo"` persis seperti badge (tema yang memisahkan logo dari label kembali rapi) dan tidak lagi lazy-load.

= 0.3.8 =
* Logo asli 17 kurir (WebP 120×48, total ±44 KB, dimuat dari toko sendiri) menggantikan badge teks di checkout, keranjang, dan daftar kurir admin. Di sebelah logo hanya nama layanan ("Reguler"), estimasi dan harga tetap. Kurir tanpa file logo tetap memakai badge warna.
* Data internal logo (`_wdss_brand_*`) tidak lagi tampil di baris ongkir pada layar pesanan admin.

= 0.3.7 =
* Nama penyedia tarif tidak lagi tampil di toko: Uji koneksi menampilkan "Server tarif 1, 2, …", teks privasi menyebut "mitra agregator ekspedisi WebDeveloper.id".

= 0.3.6 =
* Catatan resi ke pembeli tidak lagi menyuruh membuka "akun Anda": pembeli tamu mendapat tautan halaman pesanan yang bisa dibuka tanpa login, pembeli berakun tautan pesanan di akunnya. Tautan bisa diganti lewat filter `wdss_tracking_url`.

= 0.3.5 =
* Kupon gratis ongkir WooCommerce kini membuat semua tarif kurir Rp0 (asuransi yang dicentang tetap dibayar); layar pesanan menampilkan kupon & tarif kurir yang ditanggung toko.

= 0.3.4 =
Asuransi pengiriman juga di halaman keranjang.

* Keranjang klasik: kotak "Asuransi pengiriman" tampil di bawah perkiraan ongkir. Dicentang/dilepas → ongkir dihitung
  ulang lewat AJAX (`wc-ajax=wdss_insurance`, nonce) dan pilihan terbawa ke checkout. Keranjang Blocks belum.

= 0.3.3 =
Tampilan asuransi di checkout lebih rapi.

* Checkout klasik: pilihan asuransi kini satu kotak selebar ringkasan pesanan (checkbox, judul "Asuransi pengiriman"
  dan keterangan singkat), tidak lagi terjepit di kolom kanan yang rata kanan pada tema custom.

= 0.3.2 =
Bayar di tempat (COD) yang aman.

* Setiap tarif mencatat apakah kurirnya melayani COD (dari gateway). Bila kurir yang dipilih pembeli tidak menagih
  COD (GoSend, GrabExpress, Lalamove, sebagian layanan reguler), metode "Bayar di tempat" disembunyikan dan checkout
  menjelaskan alasannya. Sebelumnya pembeli bisa memilih COD dengan kurir yang tidak bisa menagih uangnya.
  Filter `wdss_cod_gateways` untuk metode COD dari plugin lain.
* Resi otomatis menolak pesanan COD (nilai tagihan COD belum dikirim ke kurir); buat resi COD lewat aplikasi atau
  agen kurir lalu isi nomor resinya manual.

= 0.3.1 =
Perbaikan dari pemasangan pertama di tema custom (Batik Arkanza).

* Titik peta berlaku untuk kode pos tempat pin dipasang. Bila pembeli mengganti kode pos (kota lain), pin lama tidak
  dipakai lagi untuk ongkir maupun pesanan, dan pembeli diminta menggeser pin. Sebelumnya kurir instan bisa dihitung ke
  titik lama (mis. GrabExpress dalam kota Solo untuk alamat Bandung).
* Tema yang menampilkan checkout klasik (shortcode) di halaman yang masih berisi blok Checkout: peta pin dan centang
  asuransi kini bekerja. Filter baru `wdss_uses_blocks` ( $blocks, 'checkout'|'cart' ) untuk tema seperti itu.

= 0.3.0 =
Melengkapi PRD v1.1 sebelum pilot.

* Tab Kurir dikelompokkan reguler, kargo, same day, instan, dengan saklar per jenis layanan setiap kurir.
* Logo kurir (lencana warna merek) di tab Kurir dan pilihan ongkir di checkout.
* Markup per layanan kurir di tab Harga; aturan volumetrik per kurir dan satuan berat/dimensi di tab Pengiriman.
* Tab Diagnostik: ringkasan error 7 hari terakhir per kode dan jenis permintaan, dengan kemungkinan penyebabnya dan tombol untuk mengosongkan.
* Batas waktu cek ongkir ke gateway 8 detik (sebelumnya 10).

= 0.2.0 =
Versi untuk pilot.

* Buat resi otomatis dari halaman pesanan (kotak Resi & pelacakan): kurir pilihan pembeli dipesan lewat WD Shipping Gateway, nomor resi langsung terisi, bisa dibatalkan selama belum dijemput. Diaktifkan per toko oleh WebDeveloper.id.
* Jadwal penjemputan (secepatnya, tanggal dan jam WIB, atau antar sendiri ke agen).
* Cetak label pengiriman (100×150 mm atau A4, barcode Code 128) dari pesanan atau tindakan massal di daftar pesanan.
* Status resi otomatis diperbarui dari kurir (webhook), tanpa memakai kuota lacak resi.
* Multi-gudang: tabel "Gudang lain" di tab Pengiriman dan "Dikirim dari" di produk; keranjang dari beberapa gudang menjadi satu bagian pengiriman per gudang (hanya di zona yang memakai WD Smart Shipping).
* Tab Status: saldo resi (deposit) dan resi bulan ini; pesan yang jelas saat saldo habis atau batas biaya bulanan tercapai.
* Nama layanan kurir lebih rapi (mis. "GoSend Instant", "JNE Trucking") dan kurir lanjutan baru dari gateway (SAP, RPX, Paxel, Sentral Cargo).
* Perbaikan: pesan "ongkir kosong" mengikuti alamat yang sedang dipakai; centang asuransi tidak tersisa setelah perhitungan gagal; tombol simpan resi manual memeriksa izin `manage_woocommerce`.

= 0.1.0 =
Rilis pertama.

* Ongkir multi-kurir dari WD Shipping Gateway (reguler, ekonomi, ekspres, next day, kargo, same day, instan), diurutkan termurah atau tercepat.
* Peta pin lokasi tujuan di checkout klasik dan Checkout Blocks untuk kurir instan/same day.
* Tab admin: Status (koneksi + kuota harian), Pengiriman (asal, jam pesan same day/instan), Kurir, Harga (markup, biaya penanganan, pembulatan, promo ongkir, asuransi), Diagnostik, Privasi.
* Asuransi pengiriman opsional yang dicentang pembeli; biaya dari kurir, tersimpan di pesanan.
* Pesan yang jelas saat ongkir kosong; gateway yang gagal dijeda 60 detik agar checkout tidak menunggu, dan ongkir dihitung ulang paling lambat 1 menit setelah gangguan.
* Lacak resi di halaman pesanan (admin dan pembeli), opsional pesanan otomatis Selesai saat paket terkirim.
* Kompatibel HPOS; site token disimpan terenkripsi; tidak pernah menampilkan tarif karangan.
* Diuji pada WordPress 6.4–7.1, WooCommerce 8.0–11.2, PHP 7.4–8.5.
