=== CartLane - AJAX Side Cart, Funnel, Checkout Booster & Order Bumps for WooCommerce ===
Contributors: tophive
Tags: woocommerce, side cart, order bump, abandoned cart, upsell
Requires at least: 6.3
Tested up to: 7.0
Requires PHP: 8.0
WC requires at least: 7.0
WC tested up to: 10.9
Stable tag: 1.1.4
License: GPL-2.0-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 [**CartLane Documentation**](https://cartlane.tophivetheme.com/docs/).

= 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 how much more they need to spend to qualify for 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.4 =

**Event Intelligence and analytics accuracy**
- Add the Event Intelligence panel with bounded journey, session, similar-session, related-object, investigation, and revenue context.
- Record checkout-created orders as placed and reserve completed revenue for authoritative payment, processing, or completed states.
- Add visit-level CartLane analytics session IDs that remain stable through guest-to-login checkout while separating later WooCommerce visits.
- Route abandoned-cart recovery clicks and recovered-order revenue through the shared analytics recorder and canonical event registry.
- Attribute each paid order to one most-relevant recovery cart to prevent duplicated recovered revenue.
- Prevent pending, failed, cancelled, and on-hold orders from being counted as completed revenue.

**Performance and scale**
- Replace analytics transient deletion scans with a request-coalesced, versioned cache namespace.
- Deduplicate repeated Smart Offer impressions by visit, campaign, product, placement, and recommendation type.
- Add 100,000-row production-shape journey, similar-session, and analytics write-path benchmarks.
- Split the Event Intelligence table and drawer into focused, reusable components while preserving keyboard and focus behavior.

**Release quality**
- Expand PHP and JavaScript regression coverage for lifecycle, revenue, session identity, cache invalidation, and recovery contracts.
- Keep production bundles within the enforced gzip budgets and strengthen deterministic release and public-source audits.

= 1.1.3 =

**Security and stability**
- Require valid CartLane Pro access for every Funnel REST action.
- Prevent Funnel storefront runtime from booting without an active Pro entitlement.
- Replace native PHP funnel sessions with the WooCommerce session layer.
- Harden Side Cart coupon input sanitization.
- Guard unavailable WooCommerce gateway services to prevent runtime errors.
- Fix the Abandoned Cart “Send a test” loading and mutation state.
- Add the Smart Offers campaign table to uninstall cleanup when data retention is disabled.

**Free and Pro architecture**
- Move Funnel backend and runtime ownership from CartLane Free to CartLane Pro.
- Move Upsell, Pricing, and Recommendations backend ownership to CartLane Pro.
- Load Pro admin routes through the extension runtime instead of shipping Pro route ownership in Free.
- Retain a read-only integrations compatibility bridge in CartLane Free.
- Align the public source archive with the distributed Free plugin package.

**Admin and storefront**
- Rebuild the Upgrade to Pro experience with a modern responsive layout.
- Reorder the Upgrade navigation item for a clearer sidebar hierarchy.
- Refresh shared admin components and Dashboard chart presentation.
- Improve the Free Integrations status UI and connection terminology.
- Add a Browse products action to the empty Side Cart state.
- Add a dedicated SVG illustration to the empty Side Cart state.

**Compatibility and release quality**
- Certify compatibility with WooCommerce 10.9.
- Align PHP code quality checks with WordPress Coding Standards.
- Add SonarQube coverage reporting and an enforced passing Quality Gate.
- Harden WordPress.org marketplace compliance and deterministic release validation.
- Improve the versioned public source archive index and integrity metadata.

= 1.1.2 =

**Changed**
- License system : Pro/Free License Foundation*
- Derive sidebar Pro access from live license query state.
- Update license query cache after activate, deactivate, and recheck actions.
- Sync runtime Pro entitlement state without forcing a browser reload.
- Enable direct URL access and page refreshes for `/order-bumps/:id`.
- Update route state dynamically when navigating between list and editor.
- Add 260ms debounce and stale response guard to product search to prevent race conditions.
- Enrich single bump REST API responses with product details (name, price, image) via `enrich_bump_response()`.
- Add missing i18n wrappers to order bump default strings.
- Fix dashboard i18n translator-comment warnings.
- Repair scheduled recovery cron during upgrades.
- Rename revenue metric to store revenue.
- Split bump accepted and paid conversion metrics.
- Add bump revenue and recovery performance signals.
- Add dashboard system status and recent events.
- Mini footer stats : Peak day , Average/day , Total orders.
- Global cartlane-type-number utility.
- hartHighlight component- added primary tone support.
- Conversion health card- tooltip.
- Dynamic/prefix-aware slug resolution.
- Explicit hash present - bootstrap and parent route overwrite.
- sidebar nav- `Integrations` align.
- `Upgrade` WordPress submenu slug register.
- Shared route writer helper use `Checkout`, `Order Bumps`, `ErrorBoundary` recovery and more.

New: Shared-primitives UI foundation.
- Tokenize shared admin UI primitive colors.
- Remove hardcoded slate, gray, white, and forced override styles.
- Normalize buttons, inputs, cards, badges, tabs, tables, dialogs, and empty states.
- Preserve legacy primitive exports for backward compatibility.
- Convert badge CSS to CartLane design tokens.

New: Dynamic shipping row to side cart summary.
New: New app style - full UI map.

Update: Free Order Bump core.
Update: Edit layout root change- container scroll.
Update: Improve side cart accessibility and refine free shipping UI.
Tweak: Webpack emits separate route CSS chunks for all major admin routes.
Tweak: Conditionally hide gateway diagnostics card on zero failures.

Fix: Global numeric value nodes.
Fix: Normalize side cart product metadata.
Fix: Improve dashboard analytics accuracy.
Fix: Resolve dynamic SQL warnings in Cart and Upsell Modules.
Fix: Global color route.
Fix: ProUpsells edit page scroll.
Fix: Clean global leftover hint/warning.

= 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 =

Security: Hardened cart REST API permissions specifically for guest cart ownership validation.
Security: Hardening applied for Side Cart redirect handling and nonce validation.

Fix: Removed auth-related session token usage from analytics session tracking.
Fix: Improved product search stability and sorting within the Order Bump editor component.
Fix: Resolved an issue with recovery link nonce verification on mobile devices.

Tweak: Slimmed down the release package by excluding vendor and Composer lock artifacts.
Tweak: Applied several Admin UX and accessibility updates.
Tweak: WordPress repository review compliance updates.
Tweak: Review compliance updates for script enqueues and review tooling alignment.

= 1.0.0 =

Initial Release!


== Upgrade Notice ==

= 1.1.4 =
This update corrects paid-order and recovered-revenue attribution, introduces visit-level analytics sessions, and removes high-cost analytics cache deletion scans. CartLane Pro must be updated to a version that requires CartLane 1.1.4 or newer.

= 1.1.3 =
This update completes the CartLane Free and Pro ownership split, strengthens Funnel and Side Cart security, improves the admin and empty-cart experience, and certifies compatibility with WooCommerce 10.9.

= 1.1.2 =
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 distributes compiled production assets in the installable plugin package.

The matching human-readable source code and build instructions for each release are published at:

[**View CartLane source code and build instructions**](https://cartlane.tophivetheme.com/source/)

For every CartLane release, the source page publishes a versioned source archive, its SHA-256 checksum, matching build instructions, and historical source versions.

The public source archive includes the React, JavaScript, CSS, PHP, dependency lockfiles, and build configuration used to generate the distributed production assets. Rebuild the production assets from an extracted archive with:

`npm ci`

`npm run build:assets`

CartLane Pro source, licensing-server source, private planning, credentials, and deployment configuration are not included in the public Free-source archive.

