=== WPFIA QuickCart for WooCommerce ===
Contributors: tofayelamin, freemius
Tags: woocommerce, cart drawer, side cart, express checkout, whatsapp order
Requires at least: 6.0
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Lightweight slide-in cart drawer, multi-tier rewards progress bar, in-drawer express checkout, and WhatsApp order recovery for WooCommerce.

== Description ==

**WPFIA QuickCart for WooCommerce** provides a lightweight, modern slide-in cart drawer and direct checkout experience for WooCommerce stores. Built with clean Vanilla JavaScript and CSS hardware acceleration, QuickCart helps merchants improve shopping experiences and checkout efficiency without external JavaScript libraries.

### Key Features & Capabilities

1. **Slide In-Drawer Express Checkout:** Allows customers to enter delivery details and submit Cash on Delivery (COD) or standard orders directly inside the cart drawer.
2. **Multi-Tier Gamified Rewards Engine:** Configure up to 3 milestone goals for customer rewards:
   - **Tier 1 (e.g. $50):** Free Shipping progress indicator.
   - **Tier 2 (e.g. $100):** Automatic discount coupon application.
   - **Tier 3 (e.g. $150):** Free Gift product reward.
3. **Cart Reservation Countdown Timer:** Displays a live countdown notice to inform customers about cart reservation duration and reduce abandonment.
4. **WhatsApp Cart Save & Direct Messaging:** Allows shoppers to send their cart contents and product links directly to the merchant's WhatsApp support number.
5. **High-Performance Architecture:** Pure Vanilla JavaScript (no jQuery dependency), lightweight asset footprint, and full compatibility with WooCommerce High-Performance Order Storage (HPOS) and Cart/Checkout Blocks.

### Additional Built-in Features
* **Smart In-Cart Cross-Sells:** Recommended add-on products dynamically displayed inside the cart drawer.
* **Instant Quantity Steppers:** Increment, decrement, and remove items with responsive live subtotal recalculation.
* **In-Drawer Coupon Application:** Promo code entry field with instant validation feedback.
* **Native Settings Dashboard:** Clean settings management interface within WooCommerce.

== Installation ==

1. Upload the `wpfia-quickcart` folder to the `/wp-content/plugins/` directory, or install directly through the WordPress Plugins dashboard (`Plugins > Add New > Upload Plugin`).
2. Activate the plugin through the 'Plugins' menu in WordPress.
3. Ensure WooCommerce is active.
4. Navigate to **WooCommerce > QuickCart** to customize drawer settings, rewards, and checkout options.

== Frequently Asked Questions ==

= Does WPFIA QuickCart work with WooCommerce HPOS? =
Yes. QuickCart supports WooCommerce High-Performance Order Storage (HPOS) and WooCommerce Cart & Checkout Blocks.

= Does in-drawer express checkout require complex configuration? =
No. It works out-of-the-box with Cash on Delivery (COD) and standard WooCommerce checkout methods.

= Does it affect site performance or PageSpeed? =
QuickCart uses native Vanilla JavaScript with zero third-party dependencies and is optimized for optimal Core Web Vitals (LCP, INP, and CLS).

= Can I customize the reward milestones and thresholds? =
Yes. In the admin settings, you can adjust the monetary goals for Free Shipping, automatic discount coupon, and free gift product picker.

== Screenshots ==

1. Lightweight slide-in cart drawer with gamified multi-tier rewards progress bar, urgency countdown timer, and dynamic cross-sells.
2. 1-Step in-drawer express checkout with real-time total payable and customer shipping fields.
3. Express checkout with Cash on Delivery reassurance notice, 1-click order bump, and 256-Bit SSL trust badges strip.
4. Native WooCommerce admin settings dashboard with real-time conversion telemetry and suite controls.

== Changelog ==

= 1.0.0 =
* Initial production release of WPFIA QuickCart for WooCommerce.
* Smart 1-Step Checkout Form & Field Customizer (full control to Show, Hide, or Require individual checkout fields).
* Security Proof & Trust Badges Strip (256-Bit SSL, Fast Delivery, Guarantee) & Customizable Payment Badges Strip with Brand SVGs.
* Shopify-Style Sticky "Quick Buy" Bar on Single Product Pages for Simple & Variable products.
* Floating Direct Checkout Launcher Button with pulse animation and auto-hide when empty.
* Standalone 1-Click Buy Shortcode [wpfia_buy_button id="..."] and Inline Cart Trigger [wpfia_cart_trigger].
* Direct 1-Click Buy Links for Meta/TikTok/Google Ads & Email campaigns (?wpfia_quick_buy=1).
* Multi-Currency Compatibility Layer (WOOCS, CURCY, WPML) and Smart Geo-Aware Cash on Delivery availability notices.
* Multi-Tier Gamified Rewards Engine with 3 milestone pins (Shipping, Discount, Free Gift).
* Cart Reservation Countdown Timer with persistent session storage.
* 1-Click In-Cart Order Bump and Tiered Volume Discounts.
* WhatsApp 1-Click Cart Save and direct customer support ordering.
* Pure Vanilla JavaScript (< 12KB bundle), 0 jQuery, and 100% HPOS compliance.
