# Coolbird Vietnam Address for WooCommerce

<div align="right">
  <a href="README.vi.md">🇻🇳 Tiếng Việt</a>
</div>

[![WordPress Version](https://img.shields.io/badge/WordPress-5.0%2B-blue)](https://wordpress.org)
[![WooCommerce Version](https://img.shields.io/badge/WooCommerce-8.0%2B-purple)](https://woocommerce.com)
[![PHP Version](https://img.shields.io/badge/PHP-7.4%2B-777BB4)](https://www.php.net)
[![License](https://img.shields.io/badge/License-GPLv3-green.svg)](https://www.gnu.org/licenses/gpl-3.0)

Woocommerce plugin optimized for the Vietnamese market with Province/City, District, and Ward/Commune selection system.

<div align="center">
  <img src="screenshot1.png" alt="Checkout" width="600">
  <img src="screenshot2.png" alt="Settings" width="600">
</div>

---

## Features

- ✅ Dropdown to select **63 Provinces/Cities**
- ✅ Dropdown to select **Districts** based on province
- ✅ Dropdown to select **Wards/Communes** based on district
- ✅ Latest Vietnamese administrative data (2024)
- ✅ Combine "First name & Last name" → "Full name"
- ✅ Add recipient phone field
- ✅ Convert ₫ → VND, PayPal support
- ✅ Shipping rates by zone, weight, order total
- ✅ Woo Blocks Checkout & HPOS compatible

---

## Installation

1. WordPress Admin → Plugins → Add New
2. Search "Coolbird Vietnam Address"
3. Install → Activate
4. Go to **Woo → Settings → Vietnam Address** to configure

---

## Requirements

| Software    | Version |
| ----------- | ------- |
| WordPress   | 5.0+    |
| WooCommerce | 8.0+    |
| PHP         | 7.4+    |

---

## License

GPLv3 - Copyright (C) 2026 Nguyen Tan Hung

---

<div align="center">
  Made with ❤️ in Vietnam
</div>