=== CartLane - AJAX Side Cart, Funnel, Checkout Booster & Order Bumps for WooCommerce ===
Contributors: tophive
Tags: woocommerce, side cart, order bump, abandoned cart, checkout booster
Requires at least: 6.3
Tested up to: 7.0
Requires PHP: 8.0
WC requires at least: 7.0
WC tested up to: 9.0
Stable tag: 1.1.1
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Boost WooCommerce sales with AJAX side cart, checkout optimization, funnel, order bumps, abandoned cart recovery, analytics, and HPOS support.

== Description ==

Are you losing sales at the checkout line?

[CartLane](https://cartlane.tophivetheme.com/) is the ultimate performance-first conversion toolkit for WooCommerce. It helps store owners reduce cart abandonment, increase Average Order Value (AOV), and build a frictionless shopping experience—without installing 4 or 5 different heavy plugins that slow down your website.

If customers add products to their cart but leave before paying, CartLane provides the exact tools you need to bring them back and seamlessly guide them through the purchase journey.

For full features, tutorials, and guides, visit the official CartLane Documentation.

= 🚀 Why Use CartLane? =

Most WooCommerce store owners install a messy combination of different plugins to optimize their store: one for a side cart, one for checkout editing, one for order bumps, and one for abandoned carts.

This causes massive plugin bloat, code conflicts, and slow page load times.

CartLane replaces them all. We engineered a single, unified conversion toolkit from the ground up using modern technology. With Zero jQuery on the frontend and a blazing-fast React 18 Single Page Application (SPA) in the admin backend, CartLane gives you premium features without the performance penalty.

= 💡 Core Benefits =

Frictionless Shopping: Keep users on the product page with a modern slide-out cart.

Instant AOV Boost: Add highly relevant "Amazon-style" order bumps right at checkout.

Recover Lost Revenue: Automatically email shoppers who abandon their carts.

Lightning Fast: Say goodbye to legacy code. We use 100% Vanilla JavaScript on the frontend.

Future-Proof: Fully compatible with WooCommerce High-Performance Order Storage (HPOS).

= 🛒 Complete Feature Breakdown =

1. WooCommerce AJAX Side Cart (Slide-Out Cart)
Replace the clunky default cart page with a modern, high-converting drawer.

AJAX-powered: Update quantities or remove items without page reloads.

Apply coupon codes directly inside the drawer.

Gamified "Free Shipping" progress bar to encourage higher spending.

Real-time cart subtotal and discount calculations.

Beautiful, mobile-friendly UI that works on all devices.

2. Checkout Optimization & Trust Signals
Reduce checkout friction and anxiety to get more completed orders.

Checkout layout and behavior controls.

Trust badge rows (secure checkout, money-back guarantees).

Scarcity and urgency countdown timers.

Clean, distraction-free checkout experience.

3. 1-Click Order Bumps (Checkout Upsells)
The fastest way to increase your Average Order Value (AOV).

Offer a complementary product right before the "Place Order" button.

1-Click "Add to Order" experience via AJAX.

Multiple high-converting design templates (Classic, Highlight, Minimal).

Smart targeting (Target bumps by specific products, categories, or cart totals).

CartLane Free includes 1 active order bump limit.

4. Automated Abandoned Cart Recovery
Your 24/7 automated sales assistant.

Automatically captures guest emails seamlessly during the checkout process.

Triggers a highly optimized 3-part email recovery sequence (e.g., 1 hour, 24 hours, 72 hours).

One-click "Restore Cart" links included in the emails.

Track exactly how much revenue your emails are recovering.

5. In-Depth Analytics Dashboard
Understand what is actually working in your store.

Track overall revenue, order bump conversions, and recovered abandoned carts.

7-day visual reporting dashboard.

Event tracking for detailed checkout behavior.

= 👑 Advanced Features (CartLane Pro) =

Need more power? CartLane Pro unlocks enterprise-grade features with no yearly SaaS lock-in.

Visual Funnel Builder: Drag-and-drop React Flow canvas to map customer journeys.

Post-Purchase Upsells: 1-Click upsell offers after payment but before the Thank You page.

A/B Split Testing: Test order bumps and checkout designs to find the winner.

Dynamic Pricing & BOGO: Create complex pricing rules, role-based wholesale pricing, and Buy-One-Get-One deals.

Unlimited Order Bumps: Run as many active checkout offers as you want.

Extended Analytics: 30, 90, and 365-day reporting ranges.

= 🤝 Integrations =

CartLane is designed to play nicely with your existing WooCommerce stack:

Payment Gateways: WooCommerce Stripe, WooCommerce Payments, PayPal, and offline gateways (COD/Bank Transfer).

Page Builders: Compatible with Elementor, Divi, Blocksy, Astra, and native Gutenberg block themes.

= 🏢 Real-World Use Cases =

Fashion Brands: Use the Free Shipping Progress Bar in the Side Cart to push customers to add "just one more item."

Electronics Stores: Use Order Bumps at checkout to sell extended warranties or batteries.

Digital Creators: Use an optimized checkout to remove unnecessary address fields for digital downloads.

High-Ticket Stores: Use Abandoned Cart recovery emails to follow up with hesitant buyers who need more time.

= 🎯 Who Is This Plugin For? =

Store Owners: Increase your revenue instantly without spending more on Facebook or Google Ads.

Freelancers & Agencies: Build beautiful, high-performing checkout flows for clients in half the time.

Developers: Finally, a WooCommerce plugin with a modern, predictable, and clean architecture.

= ⚡ Performance Advantages =

We take performance seriously. CartLane operates on strict performance budgets:

Zero jQuery: Absolutely no legacy jQuery scripts are loaded on the frontend.

Conditional Asset Loading: JS and CSS are only enqueued exactly where they are needed.

HPOS Ready: 100% compatible with custom order tables. We use our own custom tables (wcf_order_bumps, wcf_analytics) so your wp_postmeta stays clean.

Gzip Budgeting: Production bundles are heavily optimized and chunked.

= 🧑‍💻 Developer-Friendly Features =

Extensible REST API: Fully documented /cartlane/v1 namespace for headless integrations.

React 18 Admin: The backend is a decoupled Single Page Application.

Custom Hooks: Dozens of well-documented action and filter hooks.

= ♿ Accessibility Features =

ARIA labels integrated into the Side Cart drawer.

Keyboard navigation support for cart item removal and quantity updates.

Screen-reader friendly checkout trust badges.

= 🛡️ Security Notes =

Security is our top priority. CartLane enforces strict engineering standards:

Nonce verification on every single AJAX and REST request.

Strict WordPress capability checks (manage_woocommerce) for all sensitive actions.

Prepared SQL queries ($wpdb->prepare) for all database interactions.

Full sanitization of inputs and strict escaping of all outputs.

== Installation ==

= Getting Started Guide =

Option 1: Install from WordPress Admin

Go to Plugins > Add New in your WordPress dashboard.

Search for CartLane.

Click Install Now, then click Activate.

A new CartLane menu will appear in your WordPress sidebar.

Option 2: Manual Installation

Download the plugin ZIP file from WordPress.org.

Go to Plugins > Add New > Upload Plugin and select the ZIP file.

Click Install Now and then Activate.

Initial Setup:

Navigate to CartLane > Dashboard in your admin sidebar.

You will be greeted by the React-powered interface.

Navigate to Side Cart, Checkout, or Order Bumps to toggle modules on/off and configure your settings.

For deeper configuration, visit the CartLane [Documentation](https://cartlane.tophivetheme.com/docs/).

== Frequently Asked Questions ==

= 1. What exactly is CartLane? =
CartLane is an all-in-one WooCommerce conversion toolkit. It combines an AJAX side cart, checkout customizer, order bumps, and abandoned cart recovery into one lightweight plugin.

= 2. Do I need coding skills to use CartLane? =
No coding skills are required! The plugin features an incredibly intuitive, React-based visual dashboard where you can manage everything with toggles and simple settings.

= 3. Does it replace my default WooCommerce cart page? =
Yes, if you enable the AJAX Side Cart module, users will be able to review their items, update quantities, and apply coupons directly from a slide-out drawer without having to visit the traditional /cart page.

= 4. Will CartLane slow down my website? =
Absolutely not. CartLane was engineered specifically to fix the bloat caused by other plugins. We use Zero jQuery on the frontend, relying entirely on lightweight Vanilla JS. Assets are only loaded when required.

= 5. Is CartLane compatible with WooCommerce HPOS? =
Yes, CartLane is 100% compatible with WooCommerce High-Performance Order Storage (HPOS).

= 6. What is an Order Bump? =
An Order Bump is an exclusive, highly relevant product offer displayed right on the checkout page (e.g., offering a $10 phone case when they are buying a phone). Customers can add it to their order with a single click.

= 7. How many Order Bumps can I create for free? =
The free version of CartLane allows you to create and display 1 active Order Bump. If you need unlimited bumps, dynamic targeting, and A/B testing, you can upgrade to CartLane Pro.

= 8. How does Abandoned Cart Recovery work? =
If a user enters their email address at checkout but leaves without paying, CartLane securely captures the cart data. After a set time (e.g., 30 minutes), it triggers an automated email sequence containing a link to restore their exact cart.

= 9. Can I customize the design of the checkout page? =
Yes, CartLane provides tools to optimize the checkout layout, add trust badges, insert countdown timers, and manage checkout fields.

= 10. Do customers need to reload the page to apply coupons? =
No. The CartLane Side Cart utilizes AJAX, meaning coupons are applied, validated, and totals are recalculated instantly without any page reloads.

= 11. Why does the admin panel feel so fast? =
Unlike traditional WordPress plugins that require a full page reload for every settings change, the CartLane admin panel is built as a React 18 Single Page Application (SPA). It feels like a modern SaaS app.

= 12. Does it work with Elementor or block themes? =
Yes, CartLane hooks into standard WooCommerce templates and is fully compatible with block themes, Elementor, Divi, and other major page builders.

= 13. How does the Free Shipping progress bar work? =
You set a target amount (e.g., $100) in the settings. As the user adds items to the Side Cart, a visual progress bar updates in real-time, showing them exactly how much more they need to spend to unlock free shipping.

= 14. Can I translate the plugin into my language? =
Yes, CartLane is fully localization-ready. It uses the cartlane text domain and can be easily translated using tools like Loco Translate.

= 15. Are my store's data and analytics secure? =
Yes. All analytics and tracking data are stored locally in your own WordPress database using custom tables (wp_wcf_analytics). We do not send your data to external third-party servers.

= 16. Does the plugin work with Stripe and PayPal? =
Yes, CartLane works perfectly alongside official payment gateways like WooCommerce Stripe, WooCommerce Payments, and PayPal, especially for checkout and upcoming Post-Purchase Upsell features.

= 17. What happens to my data if I uninstall the plugin? =
By default, deactivating the plugin leaves your data intact. If you fully uninstall the plugin, it will clean up its custom database tables and options to keep your database light, unless you toggle the "Keep Data" setting.

= 18. Can I see analytics for my Order Bumps? =
Yes, the free version includes a 7-day dashboard where you can see your total revenue, AOV (Average Order Value), and specific conversion rates for your active order bumps.

= 19. How do I get support? =
For support with the free version, you can open a thread in the WordPress.org support forum. For priority assistance, visit [CartLane Support](https://cartlane.tophivetheme.com/docs/).

= 20. Where can I find documentation? =
Detailed documentation, hook references, and setup guides are available at the [CartLane Documentation](https://cartlane.tophivetheme.com/docs/) Site.

== Screenshots ==

Dashboard Overview: The React-powered CartLane dashboard showing real-time WooCommerce revenue, AOV, and conversion analytics.

AJAX Side Cart Drawer: The slide-out cart in action featuring quantity controls, coupon input, subtotal, and the gamified Free Shipping goal bar.

Checkout Order Bump: A high-converting 1-click Order Bump offer displayed natively inside the WooCommerce checkout flow.

Abandoned Cart Recovery: The email recovery editor showing automated sequence timelines, recovery links, and recovered revenue tracking.

Checkout Optimization: The checkout customizer featuring trust badges, urgency countdown timers, and field management.

Performance Settings: Clean settings panel showing asset optimization toggles and integration configurations.

== Changelog ==

= 1.1.1 =

Added: Getting Started, Core Modules, Advanced, Developers, and Resources documentation groups.

Added: docs for AJAX Side Cart, Optimized Checkout, Order Bumps, Abandoned Cart, and Pro conversion modules.

Added: REST API, Hooks & Filters, HPOS Integration, FAQ, Troubleshooting, License & Updates, and Support pages.

Added: Side Cart visibility controls for store pages only or all public pages, while keeping cart, checkout, and account pages excluded.

Tweak: Modernized the CartLane admin sidebar collapse behavior, mobile drawer layout, and Pro roadmap iconography.

Tweak: Improved Side Cart control cards with clearer SVG icons, aligned alert messaging, and restored self-colored accent button choices.

Tweak: Refined checkout Order Bump templates so Minimal, Classic, and Highlight now have distinct visual treatments.

Tweak: Updated checkout trust badges to render as lightweight colored pills without a surrounding box.

Tweak: Polished Order Bump CTA, badge, spacing, and responsive behavior to reduce checkout clutter.

Tweak: Matched the admin Order Bump live preview to the frontend checkout template styles.

Tweak: Enabled the Order Bump Display Order control to reorder headline, product summary, description, and CTA content.

Tweak: Polished the admin Order Bump editor controls so select carets stay inside fields and the active-toggle row avoids double borders.

Tweak: Added per-bump offer timer controls with independent duration and expiry behavior.

Tweak: Added an Order Bump timer source option for no timer, Checkout Manager timer, or custom bump timer.

Tweak: Added a checkout color preset setting for customer-facing checkout accents.

Tweak: Added Free/Pro gating for checkout color presets so Sky and Emerald remain free while premium presets route to the upgrade flow.

Tweak: Added Free/Pro gating for Order Bump templates so Classic and Minimal remain free while Highlight is shown as a Pro upgrade.

Tweak: Locked per-bump Order Bump timer source controls and Display Order customization behind Pro, with Free fallback enforcement.

Tweak: Updated the Checkout Manager live preview to reflect the selected checkout color preset.

Tweak: Polished the Checkout Manager mobile preview to match the Side Cart device mockup style.

Tweak: Standardized Checkout and Side Cart mobile previews as standalone mockups without card wrappers or heavy shadows.

Tweak: Aligned Checkout and Side Cart settings pages to use the same two-column preview grid.

Tweak: Made Checkout and Side Cart live previews sticky and removed the redundant Checkout Enabled Modules panel.

Tweak: Removed extra helper copy below Checkout and Side Cart mockups for a cleaner live preview.

Tweak: Added subtle device-base details to Checkout and Side Cart live previews for a more premium mockup finish.

Fix: Improved Order Bump add-to-order handling for variation-backed products.

Fix: Made Order Bump CTA text, headline, and product image clicks toggle the bump checkbox consistently.

Fix: Stopped the global checkout countdown from hiding only the first visible Order Bump.

Fix: Kept per-bump timer expiry labels hidden until the individual bump timer actually expires.

Fix: Expired Order Bumps that are configured to follow the Checkout Manager timer when the global checkout timer ends.

Fix: Replaced hardcoded checkout Order Bump accent colors with checkout preset tokens.

Fix: Prevented Pro-only checkout color presets from applying on the free frontend or through settings saves.

= 1.1.0 =

Feature: Added release asset hygiene and performance budget checks.

Feature: Added "Keep Data on Uninstall" setting for safer migrations.

Tweak: Improved admin visual presets and Tailwind UI components.

Tweak: Improved conditional frontend asset loading for faster page speeds.

Fix: Hardened uninstall cleanup coverage.

Fix: Improved Free vs Pro gating accuracy in the REST API.

= 1.0.9 =

Fix: Removed auth-related session token usage from analytics session tracking.

Tweak: Slimmed down the release package by excluding vendor and Composer lock artifacts.

= 1.0.8 =

Security: Hardened cart REST API permissions specifically for guest cart ownership validation.

Fix: Improved product search stability and sorting within the Order Bump editor component.

Tweak: Applied several Admin UX and accessibility updates.

= 1.0.7 =

Tweak: Review compliance updates for script enqueues and review tooling alignment.

= 1.0.6 =

Security: Hardening applied for Side Cart redirect handling and nonce validation.

Tweak: WordPress repository review compliance updates.

= 1.0.5 =

Fix: Resolved an issue with recovery link nonce verification on mobile devices.

= 1.0.0 =

Initial Release!

Added AJAX Side Cart with free shipping bar.

Added Smart Checkout optimization tools.

Added Order Bump checkout offer system.

Added Abandoned Cart Recovery email sequences.

Added 7-day Analytics dashboard.

Added React 18 powered admin Single Page Application.

== Upgrade Notice ==

= 1.1.0 =
This is a highly recommended update. It includes improved frontend performance through stricter asset loading, updated uninstall controls to protect your data, and stronger REST API security gating. Please update to ensure optimal store speed.

== Development / Source Code ==

CartLane includes compiled production files and human-readable source code.

Compiled production files:

* `/assets/`

Source files:

* `/src/`

To rebuild assets from source:

1. Run `npm install`
2. Run `npm run build`
