=== Gattsuri PV Dashboard ===
Contributors: satohata
Tags: analytics, dashboard, page views, engagement, behavior
Requires at least: 6.0
Tested up to: 7.0
Requires PHP: 8.0
Stable tag: 1.1.5
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html
Plugin URI: https://satoruhatano.xsrv.jp/gattsuri-pv-dashboard/

Behavior analytics and page view tracking dashboard for WordPress that visualizes user engagement and on-site navigation.

== Description ==

Gattsuri PV Dashboard is a lightweight behavior analytics plugin for WordPress that tracks session-based page views and visualizes user engagement directly within the admin dashboard. Unlike traditional analytics, this plugin focuses on on-site behavior — helping site owners understand how deeply visitors navigate and interact with content.

== Features ==

* **Session-based Tracking**: Tracks how users move through your site.
* **Engagement Visualization**: See how many pages users view per session.
* **Real-time Dashboard**: View active visitors and today's stats.
* **Privacy-Friendly**: Local data storage with no PII collection.
* **Bot Filtering**: Filters out common crawlers and logged-in users.

== Dashboard Overview ==

= Today's Activity =
Displays active visitors, total page views, and referrer types in real-time.

= Engagement Depth Distribution =
Visitors are grouped by session page views (1, 2, 3-4, 5+ PVs). This serves as a behavioral indicator for engagement.

== Data Storage & Privacy ==

All tracking data is stored locally in your WordPress database. No personal data (PII) is transmitted externally by default. If a Measurement ID is configured, data is sent to Google Analytics.

== Pro Version ==

The Pro extension includes advanced features:

* Week-over-week comparison (▲▼)
* Historical data selection
* Per-page engagement analysis
* Behavioral commentary per page

== Installation ==

1. Upload the plugin files to the `/wp-content/plugins/gattsuri-pv-dashboard` directory.
2. Activate the plugin through the 'Plugins' screen in WordPress.
3. Dashboard widgets will appear automatically.

== FAQ ==

= Does this plugin collect personal data? =
No. The plugin stores only anonymous session-based behavioral metrics.

= Will it affect my site's performance? =
Minimal impact. The plugin is intentionally lightweight and stores data locally with no external requests unless Google Analytics integration is configured.

== Screenshots ==

1. Today's activity widget
2. Pro: Weekly stats comparison
3. Pro: Page-level behavior analysis

== Changelog ==

= 1.1.5 =
* Fix: Prevent bot overcounting — removed timestamp suffix from fingerprint session ID so repeated cookie-less access is recorded as a single session
* Fix: Expanded bot UA filter to include Google-InspectionTool, Googlebot-Image, Google-Read-Aloud, AdsBot, and Mediapartners
* Fix: Corrected cron hook names in full cleanup (gattpvd_daily_cleanup / gattpvd_daily_summary)

= 1.1.4 =
* Removed: Bundled language files removed; translations are now served via WordPress.org.

= 1.1.3 =
* Fix: Corrected broken promotional link on the settings page.

= 1.1.2 =
* Improved: Added Plugin URI to link to the official plugin page.

= 1.1.1 =
* Improved: Plugin promotion section now displays actual plugin icons when available, with Dashicons as fallback.

= 1.1.0 =
* Tested: Confirmed compatibility with WordPress 7.0.
* Improved: Moved admin menu item under the Settings menu.

= 1.0.7 =
* Fixed: Missing translations added for 2 files.

= 1.0.6 =
* Fixed: Visitor Page Views Ranking now correctly handles tied rankings (e.g., 1st, 2nd, 3rd, 4th×2, 6th).
* Fixed: Replaced hardcoded strings with i18n functions in data tools page.
* Improved: Translation file cleanup — removed obsolete entries and corrected language settings.
* Fixed: Admin CSS now loads correctly on the plugins list page.

= 1.0.5 =
fix: v1.0.5 - fix tied ranking display and clean up translation file

= 1.0.4 =
* Added: Backfill rebuild button to data tools page.

= 1.0.3 =
* Added: Pro version integration.

= 1.0.0 =
* Initial release.