=== Tinybird Analytics by Volade ===
Contributors: volade
Tags: analytics, tinybird, realtime, events, tracking
Requires at least: 6.0
Tested up to: 6.8
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later

Stream WordPress events to Tinybird Events API — server ingest, optional pipe dashboard, 4 presets and free JSON export.

== Description ==

Tinybird Analytics by Volade connects your WordPress site to [Tinybird](https://www.tinybird.co) for realtime event streaming and pipe-powered dashboards.

* Masked auth token — or override via `TBA_TOKEN` / `TINYBIRD_TOKEN` in wp-config.php (no secrets in repo)
* Event stream — `wp_remote_post` to Tinybird Events API (`/v0/events?name=…`)
* Server-side page views (preferred) — optional frontend beacon lite via REST when server page views are off
* Admin dashboard — connection test, recent events log, optional pipe query table (configurable pipe name)
* Form hooks lite — Contact Form 7 and Gravity Forms submissions
* 4 presets: Realtime Content, WooCommerce Stream, Agency Dashboard, Privacy Minimal
* Site Health test, REST `tba/v1`, WP-CLI `wp tba`, free JSON export

Works without a Volade account. Connect for REST automation. V+ for advanced pipe features and multisite.

== Installation ==

1. Upload the ZIP via Plugins → Add New → Upload
2. Activate Tinybird Analytics by Volade
3. Add your Tinybird token and events datasource name
4. Enable server stream, then run connection test and stream a test event

Optional in wp-config.php:

`define( 'TBA_TOKEN', 'your-token' );`

== Frequently Asked Questions ==

= Does this work without WooCommerce? =

Yes. WooCommerce stream hooks apply only when WooCommerce is active and the option or preset is enabled.

= How do I track custom events from PHP? =

`do_action( 'tba_track', 'my_event', array( 'foo' => 'bar' ) );`

= What does Privacy Minimal do? =

Disables auto page views, enables Do Not Track respect, keeps manual events via `tba_track` only.

== Changelog ==

= 1.0.0 =
* Initial release — settings, event stream, pipe dashboard lite, event log, presets, export, REST and WP-CLI.
