=== Customer Event Sync for Casa Signals ===
Contributors: codecasastudios
Tags: analytics, woocommerce, customer data, sms, cart abandonment
Requires at least: 6.2
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Casa Signals tracks WooCommerce activity, customers & revenue. Send Email & SMS flows & marketing for any scenario in one dashboard. Act faster, smarter & recover sales.


== Description ==

Customer Event Sync for Casa Signals and WooCommerce connects your WordPress/WooCommerce store to Casa Signals, giving you live customer activity tracking, analytics, customer timelines, product insights, attribution, flow automation, broadcasts, and revenue recovery reporting.

After you add your Casa Signals API key and explicitly enable tracking, the plugin queues supported store events locally and sends them to Casa Signals in background batches. It can track WooCommerce and WordPress signals such as registrations, logins, logouts, account updates, product views, cart activity, checkout progress, orders placed, payment successes, payment failures, refunds, cancellations, coupons, form submissions, attribution data, customer details, product details, and site health signals.

Casa Signals then turns those events into a site-by-site dashboard where store owners can understand customer behavior, diagnose checkout/payment problems, build SMS and email flows, send broadcasts, view customer timelines, and measure recovered revenue.

== External services ==

This plugin connects to Casa Signals, a hosted analytics and automation service provided by Code Casa Studios. The service is required to receive WordPress and WooCommerce events, link them to the configured store domain, display analytics, build customer timelines, and trigger configured SMS or email flows inside the Casa Signals dashboard.

When event tracking is enabled by an administrator, the plugin queues events locally and sends them to the Casa Signals events API at `https://casasignals.com/api/wordpress/events` in background WP-Cron batches. The request includes the configured API key, the configured site domain, plugin version, and the queued event payload.

Depending on the event, the payload can include event type, time, page URL/path/title/referrer, visitor/session identifiers from first-party cookies, WordPress user profile fields, WooCommerce billing and shipping fields, cart details, product details, order totals, order status, payment failure details, coupon details, checkout field progress, attribution query parameters/referrers, form provider metadata, and site health metadata such as WordPress version, locale, timezone, and plugin context.

Data is sent when a supported store action happens, such as user login/logout/registration/password reset/account update, product view/search, cart view/change/add/remove, checkout start/progress, order placed, payment success/failure, refund/cancellation, subscription events, coupon events, supported form submissions, and periodic site health reporting. Data is sent only when tracking is enabled and an API key is configured.

Casa Signals Terms of Service: https://casasignals.com/terms

Casa Signals Privacy Policy: https://casasignals.com/privacy

== Installation ==

1. Upload the `customer-event-sync-casa-signals` folder to `/wp-content/plugins/`.
2. Activate `Customer Event Sync for Casa Signals and WooCommerce` from the Plugins screen.
3. Use the `Settings` link under the plugin name on the Plugins screen.
4. Paste the WordPress API key from Casa Signals.
5. Review the disclosure, then enable event tracking if you want the plugin to send store events to Casa Signals.

== Frequently Asked Questions ==

= Does this slow down checkout or page views? =

Events are queued locally first and sent to Casa Signals in background batches.

= Does the plugin track visitors immediately after activation? =

No. Tracking is off by default. A store administrator must add an API key and enable event tracking in the plugin settings before cookies are set or events are sent.

= Which events are tracked? =

The connector can track user login, logout, registration, reset password, account updates, cart activity, checkout activity, order placed, payment successful, payment failed, refunds, cancellations, subscriptions, product views, product searches, coupons, supported form submissions, and site health signals.

== Changelog ==

= 1.0.0 =

* Initial WordPress.org-ready Customer Event Sync for Casa Signals and WooCommerce release.
