=== Apex View Insights ===
Contributors: apexdigital, mixtapepsds
Tags: analytics, woocommerce, ecommerce, conversion tracking, reports
Requires at least: 6.0
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

Local commerce analytics for WordPress and WooCommerce stores.

== Description ==

Apex View Insights is a lightweight commerce intelligence dashboard for WordPress and WooCommerce.

It tracks product, page, post, and archive attention using first-party aggregate counters, then turns those signals into executive metrics, top content tables, device breakdowns, opportunity cards, and WooCommerce conversion insights.

The plugin is designed for stores that need fast local analytics without external analytics dependencies, raw access-log processing, or heavy database writes.

= Highlights =

* Executive dashboard with Visitors Online, Active Pages, Active Sessions, Unique Visitors, Sessions, and Page Views.
* Page view ranges for Today, Yesterday, 7 Days, 30 Days, and All Time.
* Top Products, Top Pages, and Top Posts modules with trend and growth indicators.
* Device Breakdown with Desktop, Mobile, and Tablet counts and percentages.
* WooCommerce Commerce Intelligence view with Product Views, Units Sold, Revenue, and Conversion Percentage.
* Opportunity cards for fast-rising products, high-view/low-sale products, and hidden conversion opportunities.
* Cache-compatible first-party beacon tracking with live visitor heartbeat.
* Aggregate-first storage model with no raw pageview logs.
* CSV export for reporting workflows.
* HPOS and block checkout compatibility declarations.

= Privacy-first local analytics =

Apex View Insights stores aggregate analytics in your WordPress database. It does not send analytics data to an external service and does not require Google Analytics, Google Tag Manager, or any SaaS analytics account.

Visitor and session identifiers are stored as salted hashes for aggregate analytics only.

== Installation ==

1. Upload the `apex-view-insights` folder to `/wp-content/plugins/`.
2. Activate Apex View Insights from the WordPress Plugins screen.
3. Open Apex Views in the WordPress admin menu.
4. Go to Settings and choose the tracked content types.
5. Use Beacon Tracking mode for cached WooCommerce stores.

== Frequently Asked Questions ==

= Does Apex View Insights require WooCommerce? =

No. The plugin can track posts and pages on a standard WordPress site. WooCommerce unlocks commerce-specific product analytics, sales matching, and conversion reporting.

= Does it store raw visitor logs? =

No. Apex View Insights uses aggregate counters and anonymous hashed visitor/session identifiers. It does not store raw access logs.

= Does it send analytics to Apex Digital or another third-party service? =

No. Version 1.0.0 does not send analytics data to external services.

= Will this work with WP Rocket or full-page caching? =

Yes. Beacon Tracking mode is the default for cached stores. The beacon is a small first-party script that posts aggregate view events and presence heartbeats back to WordPress.

= Is it compatible with WooCommerce HPOS? =

Yes. Apex View Insights declares compatibility with WooCommerce High-Performance Order Storage and uses WooCommerce-aware order table logic.

= Is it compatible with block checkout? =

Yes. Apex View Insights declares block checkout compatibility and tracks checkout/order events through WooCommerce hooks.

= Does the plugin collect personal data? =

The plugin does not collect names, email addresses, addresses, payment data, or raw IP addresses. It stores anonymous hashed visitor/session identifiers, aggregate page/product metrics, device category, referrer/source category, and optional country-level signals when provided by the host.

== Screenshots ==

1. Executive dashboard with branded status badges and commerce analytics KPIs.
2. Attention Momentum SVG chart and opportunity cards.
3. Top Products, Top Pages, Top Posts, and Device Breakdown modules.
4. Tracking settings with beacon mode, exclusions, retention, and dashboard appearance controls.
5. WooCommerce conversion and Views vs Sales reporting.
6. Mobile responsive dashboard layout.

== Privacy ==

Apex View Insights stores analytics locally in the WordPress database. It does not transmit analytics data to Apex Digital or external analytics services.

Data stored by the plugin may include:

* Aggregate post, page, and product view counts.
* Anonymous salted visitor and session hashes.
* Device category such as desktop, mobile, or tablet.
* Referrer/source category such as direct, Google, Bing, Facebook, Instagram, or unknown.
* Country code/name when supplied by infrastructure headers such as Cloudflare country headers.
* WooCommerce conversion events such as product view, add to cart, checkout start, and order count.

Data not stored by the plugin:

* Raw access logs.
* Raw IP addresses.
* Customer names.
* Customer email addresses.
* Billing or shipping addresses.
* Payment data.

== External Services ==

Apex View Insights 1.0.0 does not connect to external services.

== Changelog ==

= 1.0.0 =
* Promoted Apex View Insights to final commercial release packaging.
* Added branded Apex View Insights dashboard header with logo and platform status badges.
* Renamed the commerce dashboard presentation to Apex View Insights Commerce Intelligence Platform.
* Added a first-party presence heartbeat so Visitors Online stays current while tabs remain active.
* Separated presence refreshes from page-view recording so heartbeat activity does not inflate view totals.
* Expanded beacon/PHP page-view analytics to include home, blog, archive, category, shop, product category, search, and tag views.
* Fixed beacon-mode active session URLs so live analytics store the viewed page URL instead of the AJAX endpoint.
* Fixed dashboard view-total cache invalidation so refreshes and navigation update counters immediately.
* Made cache-compatible beacon tracking the default for new installs.
* Added nonce protection to first-party beacon tracking requests.
* Hardened settings sanitization for WordPress.org compliance.
* Added GPL metadata, documentation, marketplace assets, and reviewer-ready packaging.
* Confirmed WooCommerce HPOS and block checkout compatibility declarations.
* Removed dormant dashboard modules and settings from the shipped UI.
* Refreshed the Apex View Insights logo for a cleaner dark-dashboard presentation.

= 0.3.1-rc1 =
* Polished dashboard UI to align with Apex SEO Intelligence visual style.
* Unified dark SaaS backgrounds, cards, spacing, borders, shadows, and typography.
* Improved executive cards, chart shell, chart gradients, hover states, tables, opportunity cards, device bars, and analytics module cards.
* Kept vanilla JavaScript and SVG/native chart rendering only.
* Declared WooCommerce HPOS and block checkout compatibility for the RC deployment.

= 0.3.0 =
* Added Executive Analytics visitor section with online visitors, active pages, active sessions, unique visitors, sessions, and page views.
* Added page-view KPI ranges for today, yesterday, 7 days, 30 days, and all time.
* Added Top Posts, Top Pages, and Device Breakdown widgets.
* Added aggregate visitor/session/device/source/country tables.
* Added aggregate source, country, social, and conversion table foundations.
* Added WooCommerce aggregate conversion counters for product views, add to cart, checkout starts, and orders.

= 0.2.0 =
* Added Phase 2 dashboard UI.

= 0.1.0 =
* Initial local aggregate view tracking release.

== Upgrade Notice ==

= 1.0.0 =
Initial public WordPress.org release with local analytics, WooCommerce conversion reporting, beacon tracking, exports, and polished Apex Digital branding.
