=== CheckFlow – Multi-Step Checkout & Trust Badges for WooCommerce ===
Contributors:      webtendhq,devhasib
Tags:              woocommerce, checkout, multi-step checkout, trust badges, checkout optimizer
Requires at least: 6.0
Tested up to:      7.1
Requires PHP:      8.0
Stable tag:        1.0.0
WC requires at least: 7.0
WC tested up to:      9.9
License:           GPLv2 or later
License URI:       https://www.gnu.org/licenses/gpl-2.0.html

Multi-step checkout and trust badges for WooCommerce. Reduce cart abandonment and improve checkout conversions with zero configuration.

== Description ==

**CheckFlow** is a lightweight WooCommerce checkout optimizer that helps you reduce cart abandonment and improve conversions — with zero configuration required.

= Multi-Step Checkout =

Split the overwhelming single-page WooCommerce checkout into a clean, guided three-step flow:

* **Information** — billing and shipping address
* **Shipping** — shipping method selection
* **Payment** — payment method and place order

Three progress indicator styles included:

* **Step Bubbles** — numbered circles with connector lines
* **Progress Bar** — smooth animated fill bar
* **Minimal** — clean numbered steps only

Each step is validated server-side via AJAX before the customer can advance — no full page reload required.

= Trust Badges =

Display security and guarantee icons directly on the checkout page to reassure hesitant buyers at the most critical conversion moment. Five built-in badges:

* 🔒 Secure Checkout
* 🛡️ SSL Encrypted
* ↩️ Money-Back Guarantee
* 💬 24/7 Support
* 🚚 Fast Shipping

Choose which badges to show and where to display them — below the Place Order button or below the Order Total.

= Why CheckFlow? =

* **No page reload** — AJAX step validation keeps customers in flow
* **Zero config** — works immediately after activation
* **Lightweight** — assets load only on the checkout page
* **Developer-friendly** — filter hooks for every key behaviour
* **Template override** — copy templates to your theme for full customisation
* **WPCS compliant** — follows WordPress coding standards
* **HPOS compatible** — supports WooCommerce High-Performance Order Storage

= Developer Hooks =

**Actions:**
`checkflow_loaded` — fires after plugin initialises
`checkflow_step_validated` — fires after a step passes validation
`checkflow_activated` — fires on plugin activation

**Filters:**
`checkflow_checkout_steps` — modify the step definitions array
`checkflow_progress_style` — override the progress style
`checkflow_step_field_map` — modify required fields per step
`checkflow_trust_badge_definitions` — add or modify trust badges

= Template Overrides =

Copy any template from `wp-content/plugins/checkflow-for-woocommerce/templates/` to `wp-content/themes/your-theme/checkflow/` and modify freely. Plugin updates will never overwrite your copies.

* `checkout/step-nav.php` — step progress indicator
* `checkout/trust-badges.php` — trust badges container

== Installation ==

1. Upload the `checkflow-for-woocommerce` folder to `/wp-content/plugins/` or install via **Plugins → Add New**.
2. Activate the plugin.
3. Go to **Settings → CheckFlow** and enable the modules you want.
4. Visit your checkout page — the changes are live immediately.

== Frequently Asked Questions ==

= Does this work with my theme? =

Yes. CheckFlow uses standard WooCommerce hooks and adds CSS classes that work alongside any theme. If you need to adjust styles, copy the templates to your theme for full control.

= Does it work with the WooCommerce Checkout Block? =

The multi-step module targets the classic WooCommerce checkout shortcode (`[woocommerce_checkout]`). WooCommerce Blocks checkout is not supported in this version.

= Will it conflict with my page builder? =

CheckFlow uses standard WooCommerce hooks and does not modify page builder output. If you use Elementor Pro's Checkout widget, the multi-step module may conflict — disable it from Settings and use trust badges only.

= Is WooCommerce HPOS supported? =

Yes. CheckFlow declares compatibility with WooCommerce High-Performance Order Storage (custom order tables).

= Can I add my own trust badges? =

Yes. Use the `checkflow_trust_badge_definitions` filter:

`add_filter( 'checkflow_trust_badge_definitions', function( $badges ) {
    $badges['my_badge'] = [
        'label' => 'Verified Store',
        'svg'   => '<svg ...>...</svg>',
    ];
    return $badges;
} );`

= What happens to my data if I uninstall the plugin? =

By default, your settings are kept so reinstalling restores them. Enable **Remove Data on Uninstall** in Settings → General before deleting the plugin if you want a completely clean removal.

== Screenshots ==

1. Multi-Step Checkout — step bubbles progress style on the checkout page.
2. Multi-Step Checkout — progress bar style variant.
3. Trust Badges — displayed below the Place Order button.
4. Settings Page — Multi-Step tab with visual style selector.
5. Settings Page — Trust Badges tab.

== Changelog ==

= 1.0.0 =
* Initial release.
* Multi-step checkout with step bubbles, progress bar, and minimal styles.
* Server-side AJAX step validation.
* Trust badges with 5 built-in icons.
* Configurable badge position (below Place Order or below Order Total).
* Developer filter hooks for steps, style, field map, and badge definitions.
* Template override support.
* WooCommerce HPOS compatibility declared.
* Multisite compatible.
* Translation-ready with .pot file.
* Clean uninstall with opt-in data removal.

== Upgrade Notice ==

= 1.0.0 =
Initial release — no upgrade steps required.
