WP Manifestindependent plugin directory
manifest / ecommerce / vig-woo-vn-address

VIG Woo VN Address (hành chính 2025)

Địa chỉ giao hàng chuẩn Việt Nam theo hành chính MỚI 2025 (2 cấp: Tỉnh/Thành → Phường/Xã, bỏ Quận/Huyện). Tỉnh = field state, Phường/Xã = field city (select động cascade), + ô "Địa chỉ đầy đủ" tự ghép. Cho WooCommerce classic checkout.

by VIG Digital · github.com/vigdigital/vig-woo-vn-address · website

★ 0stars
3release downloads
v0.2.0latest · 1mo ago

Install

Download vig-woo-vn-address.zip From the v0.2.0 release on GitHub, Aug 20, 2026

Upload it under Plugins → Add New Plugin → Upload Plugin, then activate.

Install straight from GitHub with WP-CLI:

wp plugin install https://github.com/vigdigital/vig-woo-vn-address/releases/download/v0.2.0/vig-woo-vn-address.zip
Updates itself. It ships its own updater (Plugin Update Checker), so new versions appear under Dashboard → Updates.
Readme github.com/vigdigital/vig-woo-vn-address ↗

Địa chỉ giao hàng chuẩn Việt Nam theo hành chính MỚI 2025 cho WooCommerce (classic checkout). Bỏ cấp Quận/Huyện → 2 cấp: Tỉnh/Thành → Phường/Xã. Thay cho plugin vietnam-checkout (devvn) đã lỗi thời.

Làm gì

Yêu cầu Cách làm
Chọn Tỉnh/Thành (34 tỉnh mới) Ghi đè field state của WC cho VN (filter woocommerce_states)
Chọn Phường/Xã (theo tỉnh) Field city → select động, cascade từ tỉnh qua REST
Số nhà + tên đường Field address_1 (WC xử lý sẵn)
Địa chỉ đầy đủ tự ghép Ô chỉ-đọc, JS tự ghép live "{đường}, {Phường/Xã} {tên}, {Tỉnh}" + lưu vào đơn

Dữ liệu

  • 34 tỉnh · 3320 phường/xã — nguồn zuydd/vn-geo (MIT), theo Nghị quyết sáp nhập 2025.
  • Bundle sẵn data/vn-tree.json (~104KB) — không phụ thuộc mạng ngoài lúc chạy.
  • REST GET /wp-json/vig-vnaddr/v1/wards/{mã_tỉnh} → danh sách phường/xã (cascade).

Cài & dùng

  1. Upload vig-woo-vn-address.zip → Activate. Cần WooCommerce đang bật.
  2. Tắt plugin địa chỉ VN cũ (vd vietnam-checkout của devvn) để tránh xung đột field state/city.
  3. Đặt quốc gia mặc định = Việt Nam (WooCommerce → Settings → General).
  4. Ra trang Checkout: Tỉnh/Thành + Phường/Xã cascade, ô "Địa chỉ đầy đủ" tự ghép.

Kiến trúc

vig-woo-vn-address.php   # states VN, city→select, checkout fields, REST wards, save order
data/vn-tree.json        # 34 tỉnh + wards (n=tên, t=Phường|Xã)
assets/cascade.js        # cascade tỉnh→phường (REST) + tự ghép "Địa chỉ đầy đủ", bám updated_checkout
assets/cascade.css       # style ô chỉ-đọc
  • billing_city/shipping_city lưu tên phường/xã; billing_state/shipping_state lưu mã tỉnh (WC map ra tên). Địa chỉ format của WC (email/vận đơn) tự hiện đúng.
  • Ô "Địa chỉ đầy đủ" lưu ở meta _billing_vn_full / _shipping_vn_full, hiện trong trang đơn admin.

Ghi chú / TODO

  • Chỉ hỗ trợ classic checkout (hook woocommerce_checkout_fields). Block checkout chưa hỗ trợ.
  • Select phường/xã hiện là dropdown thường (168 mục ở tỉnh lớn) — có thể nâng cấp select2 tìm-kiếm sau.
  • Định dạng "Địa chỉ đầy đủ" dùng tên tỉnh đầy đủ (vd "Hồ Chí Minh"); muốn viết tắt "Tp.HCM" thì chỉnh compose() trong cascade.js.
  • Cập nhật dữ liệu khi có thay đổi hành chính: thay data/vn-tree.json (giữ format {code,name,full,wards:[{n,t}]}).

Releases

1 release. Each count is every asset in that release; expand a row for the breakdown.

Tag
Published
Assets
Downloads
v0.2.0 latest
Aug 20, 2026 1mo ago
vig-woo-vn-address.zip
3