=== Aetos Saudi Checkout Phone ===
Contributors: aetosseo
Tags: woocommerce, checkout, phone validation, saudi arabia, arabic
Requires at least: 6.5
Tested up to: 7.0
Requires PHP: 7.4
Requires Plugins: woocommerce
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Validate and normalize Saudi mobile numbers across WooCommerce classic and block checkout, including Arabic and Persian digits.

== Description ==

Aetos Saudi Checkout Phone helps Saudi WooCommerce stores prevent malformed mobile numbers from reaching new orders.

When a billing or shipping address uses Saudi Arabia as its country, the plugin validates a supplied mobile number and stores accepted values in one consistent form: `+9665XXXXXXXX`.

= Accepted input =

The same Saudi mobile can be entered in common local or international forms:

* `05XXXXXXXX`
* `5XXXXXXXX`
* `9665XXXXXXXX`
* `+9665XXXXXXXX`
* `009665XXXXXXXX`

Spaces, hyphens, periods, and parentheses are accepted. Western digits, Arabic-Indic digits, and Eastern Arabic/Persian digits are supported.

Validation follows the current Saudi mobile network-code structure published by the Communications, Space & Technology Commission. It checks format and current mobile prefixes, not number ownership or service status.

= Focused behavior =

* Works with WooCommerce classic checkout.
* Works with WooCommerce Checkout Blocks and the Store API.
* Normalizes billing and shipping mobile values before WooCommerce saves them.
* Leaves non-Saudi addresses unchanged.
* Leaves an empty optional phone field empty, so WooCommerce keeps control of required or optional field behavior.
* Adds no checkout JavaScript, settings screen, database table, cookie, analytics, or external request.

This plugin validates Saudi mobile-number format only. It does not send an OTP, verify ownership, confirm that a line is active, identify a carrier, or validate landline numbers.

== Installation ==

1. Install and activate WooCommerce 8.9 or newer.
2. Install and activate Aetos Saudi Checkout Phone.
3. Use the classic or block WooCommerce checkout normally. There are no settings to configure.

== Frequently Asked Questions ==

= Does the plugin make the phone field required? =

No. It respects WooCommerce's existing required, optional, or hidden setting. A non-empty Saudi phone value is validated; an empty optional value remains empty.

= Does it verify that the number belongs to the shopper? =

No. It checks format locally. It does not send an OTP or contact a telephone service.

= Does it support Arabic numbers? =

Yes. Arabic-Indic and Eastern Arabic/Persian digits are converted safely before validation.

= Does it support Checkout Blocks? =

Yes. Version 1.0.0 validates Checkout Block and Store API addresses as well as classic checkout.

= Does it change phone numbers for other countries? =

No. It only acts when the related billing or shipping country is Saudi Arabia (`SA`).

= Does it send data to Aetos or another service? =

No. Validation and normalization happen on your WordPress server. The plugin makes no external request.

== Privacy ==

The plugin does not collect, transmit, or separately store personal data. It only validates and normalizes phone values that WooCommerce is already processing for checkout.

== Screenshots ==

1. A clear validation message for an invalid Saudi mobile number at checkout.
2. A valid Saudi mobile number normalized consistently in the WooCommerce order.

== Changelog ==

= 1.0.0 =

* Initial release.
* Added Saudi mobile validation and normalization for classic checkout.
* Added Checkout Block and Store API support.
* Added Western, Arabic-Indic, and Eastern Arabic/Persian digit support.