=== Datalayer Tracking via DataReshape for WooCommerce ===
Contributors: rwky
Donate link: https://www.paypal.me/eduardvd
Tags: datareshape, first-party-tracking, datalayer-tracking, woocommerce-tracking
Requires at least: 6.0
Tested up to: 6.9
Requires PHP: 7.4
WC requires at least: 8.2
WC tested up to: 10.6
Stable tag: 0.1
Requires Plugins: woocommerce
WC HPOS compatible: yes
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Official WooCommerce integration for DataReshape, enabling structured ecommerce tracking through the DataReshape platform.

== Description ==

DataReshape for WooCommerce integrates seamlessly with your WooCommerce-powered store, providing a structured and reliable way to track ecommerce events using a modern dataLayer approach, built and tested specifically for DataReshape.

This plugin does not replace analytics tools like Google Analytics or Meta Pixel. Instead, it acts as a bridge between WooCommerce and DataReshape, which handles event processing, routing, and deduplication.

An active DataReshape plan is required to use this plugin. All tracking logic, integrations, and event delivery are managed through the DataReshape platform.

It supports browser-side tracking for the full ecommerce funnel, allowing seamless integration with advanced analytics setups.

== Features ==

= Core Features =
- Global enable/disable for the integration
- DataReshape library integration
- Subdomain tracking support
- Fully compatible with WooCommerce HPOS (High-Performance Order Storage)

= Browser Events =
- View Item
- Add to Cart (AJAX + fallback for redirects)
- View Cart
- Remove from Cart
- Begin Checkout
- Purchase
- Google Consent Mode support
- Optional plaintext user data in dataLayer (no encoding)

= Advanced Tracking =
- Full GA4-style ecommerce structure
- Product-level and cart-level data
- Coupon tracking (cart-level injection)
- Tax, discount, and stock status support
- Works with both simple, variable products and bundled products

= Reliability Enhancements =
- Handles non-AJAX add-to-cart flows
- Handles redirect-based add-to-cart (?add-to-cart=)
- Handles WooCommerce notices fallback
- Safe execution timing for low overhead
- Logging support via WooCommerce logger (for debugging enabled flows)

== Installation ==

1. Upload the plugin to the `/wp-content/plugins/` directory
2. Activate the plugin through the 'Plugins' screen in WordPress
3. Ensure WooCommerce is installed and active
4. Go to WooCommerce → Settings → DataReshape (or plugin tab)
5. Configure your integration settings

== Configuration ==

= Integration Setup =
- Enable Integration
- Tracking Subdomain
- Library ID

= Browser Events =
- Enable/disable individual events
- Consent mode configuration
- User data exposure control

== Frequently Asked Questions ==

= Does this plugin support GA4? =
Not quite! The plugin exposes a GA4-compatible ecommerce dataLayer, but actual tracking, routing, and integrations are handled via DataReshape only!

= Does it work without AJAX add-to-cart? =
Yes. It includes fallback mechanisms for redirect-based add-to-cart flows (native WooCommerce redirect to cart after adding a product).

= Does it support server-side tracking? =
Not in this version. Server-side tracking is planned for a future release.

= Will this slow down my website? =
No. The plugin is designed with performance in mind and uses lightweight, conditional execution; if anything, your setup should see a boost in speed compared to clasic integrationg (Meta, TikTok and Google).

= Is deduplication handled? =
Deduplication is handled by DataReshape. The plugin focuses on exposing accurate and complete data for DataReshape to pickup and process onward.

== Screenshots ==

1. Integration settings tab
2. Browser events configuration

== Changelog ==

= 1.0 =
- Initial release
- Browser-side ecommerce tracking
- Add-to-cart fallback handling
- View cart and remove from cart events
- Purchase tracking with order fallback
- WooCommerce logger integration

== Upgrade Notice ==

= 1.0 =
Initial release.