=== Guest Order Assigner ===
Contributors: kazverse
Tags: woocommerce, orders, guest checkout, assign orders
Requires at least: 5.0
Tested up to: 6.8.5
Requires PHP: 7.2
Stable tag: 1.0.3.7
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Automatically attaches WooCommerce guest orders to matching existing user accounts by billing email.

== Description ==

When a customer checks out as a guest in WooCommerce, this plugin will look for a user account with the same billing email and, if found, reassign the order to that user.

Key benefits:

- 🔗 **Instant Assignment** – New guest orders with a matching email are immediately linked to the customer’s account.
- 🔄 **Historic Back-fill** – On user registration or login, all past guest orders with that billing email are attached.
- ⚡ **Zero Configuration** – Works right out of the box; no settings to tweak.
- 🛠 **Developer Hooks** – Extend or customize via actions before/after assignment.

== Features ==

1. **Automatic Order Assignment**  
   Guest orders are automatically reassigned to an existing user account when the billing email matches.

2. **Historical Order Recovery**  
   On account creation or login, all previous guest orders for that email are back-filled.

3. **Real-time Processing**  
   Both guest and logged-in checkouts are processed instantly during the WooCommerce checkout flow.

4. **Secure & Reliable**  
   Built on WordPress and WooCommerce best practices to ensure data integrity.

5. **Developer Hooks**
   - `goa_before_attach_order`
   - `goa_after_attach_order`

== Requirements ==

- WordPress 5.0 or higher
- WooCommerce 3.0 or higher
- PHP 7.2 or higher

== Installation ==

There are three easy ways to install and get started with Guest Order Assigner:

1. **From the WordPress Admin Dashboard**  
   a. Go to **Plugins → Add New**.

   b. Search for **Guest Order Assigner**.

   c. Click **Install Now**, then **Activate**.

   ![install zip file](../assets/install.gif)

2. Activate **Guest Order Assigner** in Plugins

   ![activate gif file](../assets/activate.gif)

=== Verifying It’s Working ===

1. Create a **WooCommerce Product**.

   ![create wooCommerce prdouct gif file](../assets/create-wooCommerce-product.gif)

2. Create a **Guest Order** and then check the order created.

   ![create guest order gif file](../assets/guest-order.gif)

3. Create a **Order** after logging in or create accout at checkout time.

   ![create guest order gif file](../assets/logged-in-product.gif)

4. Check a **WooCommerce Order Listing**.

   ![create guest order gif file](../assets/wooCommerce-orders-listing.gif)

_No further settings are required—once activated, Guest Order Assigner will automatically handle all future and past guest orders for matching emails._

== Frequently Asked Questions ==

= Will this modify past orders? =  
Yes. After a customer registers or logs in with the same billing email, any previous guest orders will be reassigned to their user account.

= What if two users share the same email? =  
WordPress prevents duplicate user emails by default. Only the first matching user will be used.

== Screenshots ==

1. n/a

== Changelog ==

= 1.0.3.7 =
* Updated plugin metadata for WordPress compatibility and PHP requirements.
* Refreshed release package to ensure WordPress.org update checks detect the latest version.

= 1.0.3.6 =
* Fixed promo notice dismissal so it stays hidden after closing on supported admin pages.

= 1.0.3.5 =
* Improved deactivation workflow with better state handling and clearer feedback.

= 1.0.3.4 =
* Enhanced deactivation workflow with functional updates for a smoother experience and clearer feedback.

= 1.0.3.3 =
* Added deactivation survey to gather feedback on deactivation reasons.
* Added dismissible notification on settings page and post-activation, offering WordPress design/development hiring options.

= 1.0.3.2 =
* Fixed a critical error on login by adding proper guard checks for missing or invalid data..
* Added guards to ensure compatibility.
* Minor code improvements and bug fixes.

= 1.0.3.1 =
* Fixed fatal error on activation caused by strict type hinting.
* Added guards to ensure compatibility.
* Minor code improvements and bug fixes.

= 1.0.3 =
* Added assets folder and other updates.

= 1.0.2 =
Maintenance release: cleaned up tags, contributors fixed.

= 1.0.1 =
Bumped version to 1.0.1 for ownership verification.
Added live Plugin URI to documentation.

= 1.0.0 =
Initial release.

== License ==

This plugin is licensed under the GPLv2 or later.