Adds Checkout block support. New addresses store the ward name instead of the ward code.<\/p>"},"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3731796,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3731796,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3731764,"resolution":"1544x500","location":"assets","locale":"","width":1544,"height":500},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3731764,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["0.2.0"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":3731764,"resolution":"1","location":"assets","locale":"","width":1100,"height":1513},"screenshot-2.png":{"filename":"screenshot-2.png","revision":3731764,"resolution":"2","location":"assets","locale":"","width":1100,"height":1513},"screenshot-3.png":{"filename":"screenshot-3.png","revision":3731764,"resolution":"3","location":"assets","locale":"","width":1100,"height":1513}},"screenshots":{"1":"Checkout block: province and ward dropdowns.","2":"Order received page with ward and province names.","3":"Admin order screen: ward dropdown filtered by province."}},"plugin_section":[],"plugin_tags":[3513,3148,2644,39081,286],"plugin_category":[45,49],"plugin_contributors":[284786],"plugin_business_model":[],"class_list":["post-382191","plugin","type-plugin","status-publish","hentry","plugin_tags-address","plugin_tags-checkout","plugin_tags-phone","plugin_tags-vietnam","plugin_tags-woocommerce","plugin_category-ecommerce","plugin_category-maps-and-location","plugin_contributors-vnwooplugins","plugin_committers-vnwooplugins"],"banners":{"banner":"https:\/\/ps.w.org\/vietaddr\/assets\/banner-772x250.png?rev=3731764","banner_2x":"https:\/\/ps.w.org\/vietaddr\/assets\/banner-1544x500.png?rev=3731764","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/vietaddr\/assets\/icon-128x128.png?rev=3731796","icon_2x":"https:\/\/ps.w.org\/vietaddr\/assets\/icon-256x256.png?rev=3731796","generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/vietaddr\/assets\/screenshot-1.png?rev=3731764","caption":"Checkout block: province and ward dropdowns."},{"src":"https:\/\/ps.w.org\/vietaddr\/assets\/screenshot-2.png?rev=3731764","caption":"Order received page with ward and province names."},{"src":"https:\/\/ps.w.org\/vietaddr\/assets\/screenshot-3.png?rev=3731764","caption":"Admin order screen: ward dropdown filtered by province."}],"raw_content":"\n
Since 1 July 2025 Vietnam uses a 2-level administrative system: 34 provinces\/cities and 3,321 wards\/communes\/special zones. VietAddr turns the WooCommerce address form into two dependent dropdowns for Vietnamese addresses:<\/p>\n\n
state<\/code> field: 34 entries.<\/li>\n- Ward<\/strong> (X\u00e3\/Ph\u01b0\u1eddng\/\u0110\u1eb7c khu) uses the core
city<\/code> field, filtered by the selected province. The ward name is stored, so addresses stay readable in emails, exports and other plugins.<\/li>\n- Postcode is hidden for Vietnam.<\/li>\n
- Phone numbers must have 10 digits starting with 0 or +84 (03\/05\/07\/08\/09); they are saved as
0xxxxxxxxx<\/code>.<\/li>\n<\/ul>\n\nWorks with:<\/p>\n\n
\n- the Checkout block and the classic
[woocommerce_checkout]<\/code> shortcode,<\/li>\n- My Account > Addresses,<\/li>\n
- the admin order screen (ward dropdown filtered by province),<\/li>\n
- High-Performance Order Storage (HPOS).<\/li>\n<\/ul>\n\n
Migrating from \"Vietnam Checkout for WooCommerce\"<\/strong> (woo-vietnam-checkout): Tools > \"VietAddr: chuy\u1ec3n \u0111\u1ecba ch\u1ec9\" converts saved customer addresses (old 3-level province\/district\/ward codes, or that plugin's 2-level codes) to the new format. It has a dry-run mode, backs up old values to the user meta _vnck_legacy_address<\/code>, and lists the addresses that need a manual fix (for example, an old ward split between several new wards). WP-CLI: wp vnck migrate-legacy [--apply]<\/code>.<\/p>\n\nTi\u1ebfng Vi\u1ec7t: Plugin thay \u00f4 \u0111\u1ecba ch\u1ec9 c\u1ee7a WooCommerce b\u1eb1ng 2 \u00f4 ch\u1ecdn T\u1ec9nh\/Th\u00e0nh ph\u1ed1 \u2192 X\u00e3\/Ph\u01b0\u1eddng\/\u0110\u1eb7c khu (34 t\u1ec9nh, 3.321 x\u00e3 theo \u0111\u01a1n v\u1ecb h\u00e0nh ch\u00ednh t\u1eeb 01\/07\/2025), \u1ea9n m\u00e3 b\u01b0u ch\u00ednh, ki\u1ec3m s\u1ed1 \u0111i\u1ec7n tho\u1ea1i Vi\u1ec7t Nam. D\u00f9ng \u0111\u01b0\u1ee3c v\u1edbi Checkout Block, checkout c\u1ed5 \u0111i\u1ec3n, T\u00e0i kho\u1ea3n > \u0110\u1ecba ch\u1ec9, m\u00e0n s\u1eeda \u0111\u01a1n trong admin, HPOS.<\/p>\n\n
Data<\/h4>\n\n
Administrative units are bundled in data\/vn-units.json<\/code> (source: provinces.open-api.vn API v2, see data\/SOURCE.md<\/code>). The plugin makes no external requests: the browser loads the JSON file from your own site.<\/p>\n\nCredits and data sources<\/h4>\n\n\n- Administrative units (34 provinces\/cities, 3,321 wards\/communes\/special zones, per the 2025 merger resolutions): source is the Vietnam National Statistics Office (C\u1ee5c Th\u1ed1ng k\u00ea, https:\/\/danhmuchanhchinh.nso.gov.vn\/), downloaded through the API https:\/\/provinces.open-api.vn\/ by Nguy\u1ec5n H\u1ed3ng Qu\u00e2n (https:\/\/github.com\/hongquan\/vn-open-api-provinces), licensed GPL-3.0-or-later. Download date and SHA-256 are in
data\/SOURCE.md<\/code>.<\/li>\n- The old-to-new ward conversion table (
data\/legacy-map.json<\/code>) also uses data from the plugin \"Vietnam Checkout for WooCommerce\" (woo-vietnam-checkout) 2.1.6 (GPL), and the old-ward mapping of the same API.<\/li>\n- This plugin is licensed GPL-3.0-or-later; the full text is in the
LICENSE<\/code> file.<\/li>\n<\/ul>\n\n\n\n- Upload the
vietaddr<\/code> folder to \/wp-content\/plugins\/<\/code> or install the zip from Plugins > Add New.<\/li>\n- Activate the plugin. WooCommerce 8.0 or newer is required.<\/li>\n
- Set the store country to Vietnam if needed. No settings page is required.<\/li>\n<\/ol>\n\n\n
\nDoes it replace the city\/state fields in the Checkout block?<\/h3><\/dt>\nThe block keeps the core fields. Province is the core state dropdown. For the ward, a small script places a dropdown over the core city field and writes the value through the WooCommerce Blocks data store. The server checks again when the order is placed, so an invalid ward or phone is rejected even without JavaScript.<\/p><\/dd>\n
Can I change the phone rule?<\/h3><\/dt>\nYes, with the vnck_phone_pattern<\/code> filter (PHP regular expression applied to the normalized number).<\/p><\/dd>\nWhat happens to addresses saved by version 0.1.0?<\/h3><\/dt>\nVersion 0.1.0 stored ward codes. They are still accepted and shown as ward names; the migration tool converts them to names.<\/p><\/dd>\n
What is removed when I delete the plugin?<\/h3><\/dt>\nThe plugin creates no options or transients. Deleting it from Plugins (uninstall) removes only the user meta _vnck_legacy_address<\/code>, the backup written by the migration tool. Customer and order addresses (WooCommerce billing\/shipping fields) are kept. Deactivating the plugin removes nothing.<\/p><\/dd>\n\n<\/dl>\n\n\n0.2.0<\/h4>\n\n\n- Renamed from \"VN Checkout\" to VietAddr (slug
vietaddr<\/code>).<\/li>\n- Checkout block support (ward dropdown, server-side validation through the Store API).<\/li>\n
- Ward name is stored in the city field (ward codes from 0.1.0 still accepted).<\/li>\n
- Admin order screen: ward dropdown.<\/li>\n
- Migration tool and WP-CLI command for \"Vietnam Checkout for WooCommerce\" addresses.<\/li>\n
- Text domain
vietaddr<\/code>, translation template languages\/vietaddr.pot<\/code>.<\/li>\n- Uninstall removes the migration backup meta
_vnck_legacy_address<\/code>.<\/li>\n- License changed to GPL-3.0-or-later; data credits added.<\/li>\n<\/ul>\n\n
0.1.0<\/h4>\n\n\n- Classic checkout and My Account: province\/ward dropdowns, Vietnamese phone validation, HPOS compatibility.<\/li>\n<\/ul>","raw_excerpt":"2-level Province \u2192 Ward addresses for Vietnam (2025 merger, 34 provinces, no district level) for the Checkout Block and classic checkout.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/tir.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/382191","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/tir.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/tir.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/tir.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=382191"}],"author":[{"embeddable":true,"href":"https:\/\/tir.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/vnwooplugins"}],"wp:attachment":[{"href":"https:\/\/tir.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=382191"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/tir.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=382191"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/tir.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=382191"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/tir.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=382191"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/tir.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=382191"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/tir.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=382191"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}