Paypal Tracking Automator

=== We Make Things: PayPal Tracking Automator ===
Contributors: wemakethings
Tags: woocommerce, paypal, tracking, automated, shipping
Requires at least: 6.0
Tested up to: 7.1
Requires PHP: 7.4
WC requires at least: 8.0
WC tested up to: 9.0
Stable tag: 1.0.5
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Automatically extracts tracking numbers from order notes and pushes them to PayPal for orders paid via PayPal Payments.

== Description ==

**We Make Things: PayPal Tracking Automator** is a utility for WooCommerce stores that use the "PayPal Payments" (PPCP) plugin. It automatically detects tracking numbers added to order notes (such as notes generated by fulfillment software or shipping couriers) and syncs them directly to the PayPal transaction using PayPal's official Shipping Trackers REST API.

Keeping your PayPal transaction tracking up to date helps reduce payment disputes, protect against chargebacks, and speed up the release of pending funds.

= Key Features =
* **Automatic Detection:** Scans order notes for tracking references (e.g. Royal Mail, DPD, Evri) and extracts numbers automatically.
* **Direct REST API Push:** Sends tracking numbers and delivery carrier details directly to PayPal.
* **HPOS Compatible:** Fully compatible with WooCommerce High-Performance Order Storage (custom order tables).
* **Manual Resync Action:** Trigger on-demand tracking rescanning directly from the single order actions menu.
* **Developer Friendly:** Gated debug logging available in WooCommerce General Settings.

== Installation ==

1. Upload the `wmt-paypal-tracking-automator` folder to the `/wp-content/plugins/` directory, or install the .zip file via the WordPress admin.
2. Activate the plugin through the 'Plugins' menu in WordPress.
3. Ensure the official "WooCommerce PayPal Payments" plugin is active and connected.
4. (Optional) Enable Debug Mode under **WooCommerce -> Settings -> General**.

== Frequently Asked Questions ==

= Does this work with other PayPal plugins? =
It is specifically designed to work alongside the official "WooCommerce PayPal Payments" (PPCP) plugin, reading API credentials securely from its configuration.

= How does it detect tracking numbers in notes? =
It looks for common patterns like "Your tracking number is [NUMBER]" commonly posted by fulfillment providers and couriers.

= Is WooCommerce HPOS supported? =
Yes! The plugin fully declares and supports High-Performance Order Storage (custom order tables) using WooCommerce CRUD methods.

== Screenshots ==

1. PayPal Tracking Automator debug settings in WooCommerce General Settings.
2. Order note log indicating successful synchronization with the PayPal API.

== Changelog ==

= 1.0.5 =
* Full compliance update for WordPress.org directory submission.
* Added High-Performance Order Storage (HPOS) compatibility.
* Switched to pure WooCommerce CRUD for order metadata.
* Removed non-compliant external module dependencies.
* Added dynamic carrier detection support.

= 1.0.0 =
* Initial release.