=== Phone Blacklist (Basic) ===
Contributors: Panagiotis Katopodis
Donate link: https://astartemedia.gr/
Tags: woocommerce, blacklist, phone, fraud, checkout
Requires at least: 5.8
Tested up to: 6.9
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Simple phone-based blacklist for WooCommerce. Block orders at checkout when the billing phone number is in your blacklist.

== Description ==

**Phone Blacklist for WooCommerce (Basic)** is a lightweight solution to block “known bad” customers in WooCommerce based on their phone number.

You maintain a single list of phone numbers in the WooCommerce admin (one per line), and the plugin checks every new order at checkout. If the billing phone matches your blacklist, the order is blocked with a clear error message.

This is a minimal, free anti‑fraud layer designed for stores that use Cash on Delivery (COD) and want to reduce returns and wasted shipping costs.

### Main Features

* Phone blacklist managed from WooCommerce → Phone Blacklist.
* One phone number per line in a simple textarea.
* Basic normalization for Greek phone numbers (e.g. `69...`, `2...`, `+3069...` become a comparable format).
* Automatic checkout validation using official WooCommerce hooks.[web:3]
* No custom database tables – everything stored in a single WordPress option.

### How it Works

1. Install and activate the plugin.
2. Go to **WooCommerce → Phone Blacklist**.
3. Add one phone number per line (e.g. `+3069XXXXXXXX`).
4. When a new order is placed, the plugin compares the billing phone with your blacklist.
5. If there is a match, the order is blocked and the customer sees an error message.

### GDPR

The basic version stores only normalized phone numbers in a single WordPress option.
It does not store names, email addresses, IPs, or any other personal data.

You are responsible for mentioning this simple blacklist usage in your site’s privacy policy.

If you need advanced GDPR features (export/erase integration, anonymization of records, audit logs, per‑customer history, etc.), consider using a more advanced or premium solution.

== Installation ==

1. Upload the plugin folder to the `/wp-content/plugins/` directory, or install it through the WordPress “Add New → Upload Plugin” screen.
2. Activate the plugin through the “Plugins” screen in WordPress.
3. Go to **WooCommerce → Phone Blacklist**.
4. Add one phone number per line and click “Save”.

== Frequently Asked Questions ==

= How should I write the phone numbers? =

Write one phone number per line, for example:

* `+3069XXXXXXXX`
* `69XXXXXXXX`
* `2XXXXXXXXX`

The plugin applies basic normalization (removing spaces and symbols, adding `+30` when needed) so that different formats are comparable.

= Does it block existing orders? =

No. It only checks new orders during checkout. Existing orders are not modified.

= Is this a complete anti‑fraud solution? =

No. It is a simple, phone-based blacklist that adds a basic line of defense.
For advanced fraud scoring, risk analysis, or multi‑criteria blacklists, you should look at more advanced tools or premium plugins.[web:53][web:70]

== Screenshots ==

1. Admin page with the phone blacklist textarea.
2. WooCommerce checkout error message when a phone is blacklisted.

== Changelog ==

= 1.0.0 =
* Initial release.

== Upgrade Notice ==

= 1.0.0 =
First release of the basic phone blacklist for WooCommerce.
