=== 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/) ---