=== AlphaDevs Stripe Checkout Diagnostics for WooCommerce ===
Contributors: alphadevs
Tags: woocommerce, stripe, checkout, diagnostics, payments
Requires at least: 6.5
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 0.1.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Diagnose common WooCommerce Stripe checkout configuration issues with read-only storefront probes, local webhook self-tests, and actionable findings.

== Description ==

AlphaDevs Stripe Checkout Diagnostics helps WooCommerce merchants and developers identify common WooCommerce Stripe checkout configuration issues before they turn into support incidents or failed conversions.

The plugin runs read-only diagnostics against your WooCommerce and Stripe setup, then shows findings with evidence and suggested fixes.

= Current diagnostic coverage =

* Stripe gateway enabled but active API keys missing
* Stripe webhook signing secret missing for the active mode
* Stripe gateway disabled while UPE or Express Checkout settings remain configured
* Link configured but not active on checkout
* Stripe assets missing from checkout when Stripe should be active
* Express Checkout configured for storefront locations without matching frontend signals
* Local webhook self-test route reachability
* Domain and HTTPS mismatch detection
* Local development environment downgrade for non-production domain warnings

= What the plugin does =

* Collects WooCommerce, Stripe, and site configuration signals
* Probes cart, checkout, and one published product page
* Runs a local webhook self-test using a temporary token
* Stores the latest scan plus lightweight recent scan history
* Displays findings with severity, confidence, evidence, and suggested fixes

= What the plugin does not do =

* It does not place test orders or process real card charges
* It does not automatically modify your Stripe or WooCommerce settings
* It does not send your scan results to a third-party service

= Privacy and remote requests =

This plugin performs read-only HTTP requests back to the same WordPress site in order to:

* Probe cart, checkout, and product pages
* Run a local REST-based webhook self-test

The plugin does not send diagnostics or store data to an external service.

Note: Stripe-related pages on your storefront may themselves load Stripe-hosted JavaScript such as `js.stripe.com` when your checkout configuration enables those features. This is part of your store's Stripe integration, not telemetry added by this plugin.

== Installation ==

1. Upload the plugin files to the `/wp-content/plugins/alphadevs-stripe-checkout-diagnostics` directory, or install the plugin through the WordPress plugins screen.
2. Activate the plugin through the `Plugins` screen in WordPress.
3. Ensure WooCommerce is active.
4. Go to `Checkout Health` in WordPress admin.
5. Run a scan.

== Frequently Asked Questions ==

= Does this plugin change my Stripe settings automatically? =

No. All scans are read-only.

= Why do I see a domain or HTTPS warning on localhost? =

Local development environments such as `localhost`, `127.0.0.1`, `.local`, and `.test` are downgraded to lower-severity informational findings where appropriate. This warning is still useful because wallet flows like Apple Pay and Google Pay require production-like HTTPS environments.

= Does webhook self-test simulate a real Stripe event? =

Not yet. The current version validates that your application can receive and process a local callback round-trip. It is useful for catching route and environment issues, but it is not a full Stripe event signature simulation.

= Does this plugin require WooCommerce Stripe Gateway? =

The plugin is most useful when WooCommerce Stripe Gateway is installed, but it can still report some site and WooCommerce-level findings without it.

== Screenshots ==

1. Latest scan overview with score, diff summary, and probe status
2. Finding detail cards with evidence and suggested fixes
3. Webhook self-test status and recent scan history

== Changelog ==

= 0.1.0 =

* Initial public alpha
* Added read-only checkout, cart, and product probes
* Added Stripe configuration diagnostics
* Added local webhook self-test
* Added findings detail cards and lightweight scan history

== Upgrade Notice ==

= 0.1.0 =

Initial public alpha release.
