=== Valserv Analytics for SentinelPro ===

Plugin Name: Valserv Analytics for SentinelPro
Plugin URI: https://valserv.com/
Description: Connect your site to SentinelPro Analytics. Includes real-time tracking, post-level metrics, and a privacy-focused dashboard.
Tags: analytics, tracking, statistics, sentinelpro, privacy-first
Author: Valserv Inc
Author URI: https://valserv.com/
Requires at least: 5.0
Tested up to: 6.9
Stable tag: 1.1.0
Version: 1.1.0
Requires PHP: 7.4
Text Domain: valserv-analytics-for-sentinelpro
Domain Path: /languages
License: GPL2
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Connect your site to SentinelPro Analytics with real-time tracking, post-level metrics, and a privacy-focused dashboard.


== Description ==

📊 **Connect your site to SentinelPro Analytics**  
🚀 **Real-time tracking and post-level insights**  
🔒 **Privacy-focused and lightweight**

Valserv Analytics for SentinelPro brings high-performance analytics to your site with a simple setup and zero bloat.

### 🎯 Key Features

* **Instant Integration** – Add your SentinelPro tracking code using a Property ID and API Key.
* **Post-Level Metrics** – View views, sessions, and event data directly in the admin.
* **Custom Tracking Options** – Disable tracking for logged-in users or customize with filters.
* **Performance Focused** – Clean code, fast loading, and compatible with all major caching plugins.
* **Privacy-First** – No personal data is stored or transmitted by the plugin itself.

---

### 🧩 Feature Support

* Real-time analytics dashboard (built-in)
* Per-post views, sessions, and event data
* Works with all major themes and editors
* Developer-friendly filters for extending tracking logic

---

### ⚙️ General Plugin Features

* Lightweight and fast
* Simple, intuitive settings page
* Works with or without Gutenberg
* Compatible with multisite
* Regular updates and active development

---

== Installation ==

1. Upload the `valserv-analytics-for-sentinelpro` folder to the `/wp-content/plugins/` directory.
2. Activate the plugin from the **Plugins** menu.
3. Go to **Dashboard > SentinelPro** and enter your Property ID and API Key.

That's it! Tracking starts immediately.

---

== Usage ==

1. Log in to your SentinelPro Analytics account.
2. Copy your **Account Name**, **Property ID**, and **API Key**.
3. Paste them into the plugin settings.
4. (Optional) Adjust tracking behavior, such as enabling logged-in user tracking.
5. View analytics directly from your admin dashboard or on individual post listings.

---

== Frequently Asked Questions ==

= Do I need a SentinelPro Analytics account? =
Yes. You'll need a SentinelPro account with a valid Property ID and API Key.

= Where can I find my Property ID and API Key? =
Log in to your SentinelPro Analytics dashboard and go to **Property Management** and **Account API** to retrieve them.

= Does it track logged-in users? =
By default, logged-in users are excluded from tracking. You can enable this in the plugin settings.

= Is user data collected? =
No. The plugin itself collects no user data. Analytics is handled securely by SentinelPro servers.

= Can I customize the tracking code? =
Yes. Developers can use filters to extend or alter the output of the tracking script.

= Is it compatible with caching plugins? =
Yes. SentinelPro Analytics is fully compatible with all major caching and optimization plugins.

---

== Screenshots ==

1. SentinelPro Analytics plugin settings page
2. Post-level metrics displayed in the Posts table

---

== Privacy ==

**Tracking Behavior:**

This plugin loads a tracking script from `analytics.sentinelpro.com` when tracking is enabled and properly configured. The plugin itself does **not** collect, store, or transmit any personal user data on your WordPress server.

**What Data is Sent:**

When tracking is active, the SentinelPro tracking script (loaded from `analytics.sentinelpro.com/track.js`) may collect standard web analytics data such as:
* Page views and navigation paths
* Session information
* Browser and device information
* Referrer information
* IP addresses (which may be anonymized based on your SentinelPro account settings)

**Tracking Control:**

* Tracking is **disabled by default** and will not load until you:
  1. Enable tracking in the plugin settings
  2. Configure your Property ID and Account Name
* By default, logged-in users are excluded from tracking (configurable in settings)
* All tracking is handled by SentinelPro servers, not by this plugin

**Privacy Compliance:**

To comply with GDPR, CCPA, or other data regulations:
* Refer to your SentinelPro Analytics account settings for privacy controls such as IP anonymization
* Ensure your site's privacy policy discloses the use of analytics tracking
* Consider implementing a cookie consent mechanism if required by your jurisdiction

**Data Storage:**

This plugin stores only configuration data (Property ID, Account Name, API Key) in your WordPress database. No visitor tracking data is stored locally by this plugin.

---

== Changelog ==

= 1.0.12 =
* Fixed 403 Forbidden error - added missing nonce to API requests
* Both daily and hourly fetch methods now include security nonce

= 1.0.11 =
* Fixed empty cache arrays being treated as valid cache hits
* Now properly fetches fresh data when cache contains empty results

= 1.0.10 =
* Fixed CacheManager initialization - now uses proper storage key
* Added debug logging to trace data fetching flow
* Improved cache cleanup for legacy data

= 1.0.9 =
* Added checkDatabaseStatus() stub method to DataFetcher for API compatibility

= 1.0.8 =
* Fixed JavaScript cache-busting - version number now uses plugin version constant

= 1.0.0 =
* Initial release
* Tracking code injection via Property ID
* Settings page for API Key and tracking options
* Post-level analytics integration
* Real-time dashboard support

---

== Upgrade Notice ==

= 1.0.0 =
Initial release. No upgrade steps required.

---

== Support and Development ==

This plugin is actively developed and maintained by [Valserv Inc](https://valserv.com/).  
For documentation, feature requests, or support, visit: [https://valserv.com/contact](https://valserv.com/contact)

Enjoy using SentinelPro Analytics?  
Please consider [leaving a 5-star review](https://wordpress.org/support/plugin/valserv-analytics-for-sentinelpro/reviews/)

---

