=== Beat Aware™ Visitor Intelligence ===
Contributors: beataware
Tags: analytics, visitor analytics, engagement, real-time analytics, content analytics
Requires at least: 5.3
Tested up to: 7.1
Requires PHP: 7.1
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Real-time attention analytics for visitor engagement. Privacy-conscious by design.

== Description ==

Beat Aware™ Visitor Intelligence is a real-time visitor engagement intelligence system built for WordPress. It helps website owners see how visitors interact with content while that interaction is happening.

= Real-Time Visitor Engagement Intelligence =

It monitors engagement on posts and pages and can help you observe:

* Page and content activity
* Active engagement time
* Scroll milestones (25%, 50%, 75%, 100%)
* Return visitor activity
* Engagement percentage
* Live interaction signals

= Privacy-Conscious by Design =

* Engagement analytics are stored in the site’s own WordPress installation
* The plugin does not include coded runtime transmission of engagement analytics to Beat Aware™ servers
* No analytics cookies are set by this plugin
* localStorage is used for simple per-content return-visit detection
* Raw IP addresses are not stored by the presence/rate-limit features
* An IP address may be used as input to a salted HMAC pseudonymous technical identifier for short-lived technical functions
* Website owners retain direct access to their own analytics inside WordPress

== Free Edition Features ==

* Real-time visitor engagement intelligence
* Active engagement measurement
* Scroll milestones: 25%, 50%, 75%, 100%
* Return visit tracking
* Engagement percentage
* Content engagement reports
* CSV export (Today, 7-Day, 30-Day)
* Visible Live Intelligence
* WordPress-based analytics access
* Privacy-conscious design

== CSV Report Export ==

CSV exports for Today, Last 7 Days, and Last 30 Days can include content viewed, views, active engagement time, scroll progress, return visits, and engagement percentage.

== Beat Aware™ Visible Live Intelligence Technology ==

Visible Live Intelligence can show selected engagement signals on the live website through the shortcode. The public panel can display aggregate viewer count, recent public content activity, and live engagement behavior. It does not expose visitor identities.

== Free Edition Purpose ==

The Free Edition is a working visitor engagement intelligence system. It is not a limited trial. Free Edition features are intended for ongoing use.

== Beat Aware™ Visitor Intelligence — Full Version ==

Beat Aware™ Visitor Intelligence — Full Version is a separate expanded product hosted elsewhere. Capabilities that are **not included** in the Free Edition include:

* Visitor Origin Intelligence
* Traffic Source Intelligence
* Advanced Content Intelligence
* CTA / Conversion Intelligence
* Expanded Reporting

These are part of the separate Full Version product. They are not locked Free Edition features waiting to be unlocked inside this plugin.

== Free Edition vs Full Version ==

Free Edition includes real-time visitor engagement, active engagement time, scroll milestones, return visits, engagement percentage, content engagement reports, CSV export, and Visible Live Intelligence.

Full Version adds Visitor Origin Intelligence, Traffic Source Intelligence, Advanced Content Intelligence, CTA / Conversion Intelligence, and expanded reporting.

== Installation ==

1. Upload the `beat-aware-visitor-intelligence` folder to `/wp-content/plugins/`, or install the plugin ZIP through WordPress.
2. Activate Beat Aware™ Visitor Intelligence from the Plugins screen.
3. Open the Beat Aware™ Visitor Intelligence analytics area in WordPress.
4. Optionally add the Visible Live Intelligence shortcode `[beat_aware_visitor_intelligence_panel]`.
5. Begin measuring visitor engagement.

== Frequently Asked Questions ==

= Is the Free Edition really free? =

Yes. It is a working Free Edition and does not expire.

= Does Beat Aware™ Visitor Intelligence send my engagement analytics to Beat Aware™ servers? =

Based on the current plugin code, engagement analytics are processed and stored inside the site’s WordPress installation. The plugin does not include coded runtime calls that transmit visitor engagement analytics to Beat Aware™ servers.

= Does the plugin use cookies? =

No analytics cookies are set by this plugin.

= Does it use browser storage? =

Yes. localStorage is used for a simple per-content return-visit flag.

= Does it store raw visitor IP addresses? =

No. Raw IP addresses are not stored by the presence/rate-limit features. An IP address may be used as input to a salted HMAC pseudonymous technical identifier.

= What is Visible Live Intelligence? =

It is the public-facing layer that can show selected aggregate engagement activity on the website while interaction is happening.

= Can I export my reports? =

Yes. CSV exports are available for Today, Last 7 Days, and Last 30 Days.

= What happens to analytics data if I deactivate the plugin? =

Deactivation preserves analytics data.

= What happens if I delete the plugin? =

The plugin uninstall process removes plugin-owned server-side analytics data.

= Does the Free Edition include Visitor Origin Intelligence? =

No. Visitor Origin Intelligence and the other advanced capabilities listed for the Full Version are not included in the Free Edition.

== Privacy ==

* Engagement analytics are stored locally in the WordPress installation
* There is no coded outbound transmission of engagement analytics to Beat Aware™ servers
* No analytics cookies are used
* localStorage may store a simple per-content return-visit flag
* A salted HMAC pseudonymous technical identifier may be created for short-lived presence and rate-limit functions
* Raw IP addresses are not stored by those functions
* Daily rollup analytics are retained for approximately 90 days
* Recent activity is limited to the latest 25 events
* Presence and rate-limit data are stored in short-lived transients
* Aggregate counters in post meta remain until reset by an administrator or removed on uninstall
* Visible Live Intelligence may publicly display aggregate viewer count and recent public content activity when the panel is placed on a page

Suggested privacy-policy text is also available through the WordPress Privacy Policy guide when the plugin is active.

== Screenshots ==

1. Beat Aware™ Visitor Intelligence analytics dashboard.
2. Real-time visitor engagement reporting.
3. Scroll milestone and active engagement intelligence.
4. CSV report export options.
5. Beat Aware™ Visible Live Intelligence on a live page.

== Changelog ==

= 1.0.0 =
* Initial public release.
* Real-time visitor engagement intelligence.
* Active engagement time and scroll milestone tracking.
* Return visit tracking and engagement percentage.
* CSV report export and Visible Live Intelligence.
* Privacy-conscious local WordPress analytics architecture.

== Human-readable JavaScript source ==

Human-readable JavaScript source is included in the plugin package:

* `assets/js/baci-content-tracker.js`
* `assets/js/visitor-presence-baci.js`
* `assets/js/baci-content-panel.js`

Production minified counterparts currently enqueued by the plugin:

* `assets/js/baci-content-tracker.min.js`
* `assets/js/visitor-presence-baci.min.js`
* `assets/js/baci-content-panel.min.js`

The minified JavaScript files are generated/minified using Terser. Readable and minified files are maintained together in this package.

== Upgrade Notice ==

= 1.0.0 =
Initial public release of Beat Aware™ Visitor Intelligence.
