# Saudi Address Pro — WooCommerce Plugin

**Version:** 1.0.5  
**Requires WordPress:** 6.0+  
**Tested up to:** WordPress 7.0  
**Requires WooCommerce:** 5.0+  
**Tested up to WooCommerce:** 9.9  
**Requires PHP:** 7.4+  
**License:** GPL v2 or later

---

## What it does

Adds a Saudi National Address (SPL) autocomplete widget to your WooCommerce checkout. Customers type an 8-character short code (e.g. `RCTB4359`) and the plugin instantly auto-fills all address fields with the verified SPL address — no typos, no invalid addresses.

Built for the **TGA January 2026 mandate** requiring valid Saudi National Addresses on all parcel deliveries in Saudi Arabia.

---

## Compatibility

| Platform | Status |
|---|---|
| WordPress 7.0 | ✅ Tested & compatible |
| WordPress 6.x | ✅ Fully supported |
| WooCommerce 9.9 | ✅ Tested & compatible |
| WooCommerce Classic Checkout | ✅ Supported |
| WooCommerce Block Checkout | ✅ Supported |
| HPOS (High-Performance Order Storage) | ✅ Declared compatible |
| PHP 7.4 – 8.3 | ✅ Supported |

---

## Installation

1. Download the plugin zip from [WordPress.org](https://wordpress.org/plugins/saudi-address-pro/) or this repository
2. In your WordPress admin go to **Plugins → Add New → Upload Plugin**
3. Upload the zip and click **Activate**
4. Go to **Saudi Address Pro** in the sidebar and enter your API key
5. Get a free API key at [saudiaddresspro.com](https://saudiaddresspro.com)

---

## Changelog

### 1.0.5 — May 2026
- Declared compatibility with WordPress 7.0
- Updated tested-up-to for WooCommerce 9.9
- Added missing `Tested up to` header (removes WordPress.org "not tested" warning)
- Updated minimum WordPress requirement to 6.0

### 1.0.4
- Settings prefix migration for existing installations
- HPOS compatibility declaration

### 1.0.3
- Block checkout support
- Arabic RTL layout

### 1.0.0
- Initial release