=== WEBFUL Analytics ===
Contributors: webfulchris
Donate link: https://webful.fr
Tags: analytics, statistics, tracking, webful, privacy
Requires at least: 5.0
Tested up to: 6.9
Requires PHP: 7.4
Stable tag: 2.5.3
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Ultra-lightweight and privacy-friendly traffic analytics system for your WordPress site.

== Description ==

WEBFUL Analytics is a WordPress plugin that allows you to easily track your website statistics without slowing down your pages.

= Key Features =

* **Ultra-lightweight**: Tracking script under 1 KB, no impact on your site speed
* **Privacy-friendly**: No cookies, GDPR compliant by design
* **Simple installation**: Connect with your WEBFUL credentials and you're done!
* **Complete dashboard**: Access all your statistics from your WEBFUL account
* **Quota management**: Automatic verification of your page views quota
* **Flexible configuration**: Enable/disable tracking with one click

= Tracking Features =

* Page views tracking
* Unique visitors analysis
* Time spent calculation on each page
* Traffic sources detection (referrers)
* **Automatic conversion tracking** (phone clicks, email clicks, form submissions)
* **Conversion pages detection** (contact, thank you, confirmation)
* Real-time statistics
* Detailed reports by day, week, month

= Advanced WEBFUL Platform Features =

* **Evolution Score**: Track your site's progression with a score out of 100 (7d, 30d, 365d)
* **SEO Analysis**: Analyze your pages with 16 SEO criteria and get personalized recommendations (paid accounts)
* **PDF Export**: Download your statistics as professional PDF with logo and charts
* **Public sharing**: Generate secure sharing links to show your stats to clients
* **Interactive charts**: Zoom and navigate through your traffic history
* **Automatic alerts**: Receive notifications for traffic drops or inactivity
* **Multi-sites**: Manage multiple sites from a single account (depending on your plan)

= Why Choose WEBFUL? =

* **Performance**: No slowdown of your site
* **Simplicity**: 2-minute installation
* **Reliability**: Robust and secure infrastructure
* **Support**: Responsive French team

= Requirements =

* A WEBFUL account (free or paid)
* WordPress 5.0 or higher
* PHP 7.4 or higher

== Installation ==

= Automatic Installation =

1. Log in to your WordPress admin panel
2. Go to "Plugins" > "Add New"
3. Search for "WEBFUL Analytics"
4. Click "Install Now"
5. Activate the plugin

= Manual Installation =

1. Download the plugin ZIP file
2. Log in to your WordPress admin panel
3. Go to "Plugins" > "Add New" > "Upload Plugin"
4. Select the ZIP file and click "Install Now"
5. Activate the plugin

= Configuration =

1. Go to the "WEBFUL" menu in your WordPress admin
2. Enter your WEBFUL credentials (email and password)
3. Click "Connect my site"
4. Done! Tracking is now active

If you don't have a WEBFUL account yet, create one for free at [webful.fr](https://webful.fr).

== Frequently Asked Questions ==

= Do I need a WEBFUL account to use this plugin? =

Yes, you need to create a WEBFUL account (free or paid) at [webful.fr](https://webful.fr) to use this plugin.

= Does the plugin slow down my site? =

No! The tracking script is less than 1 KB and loads asynchronously. It has no noticeable impact on your site speed.

= Is the plugin GDPR compliant? =

Yes, WEBFUL does not use cookies and does not collect any personally identifiable data. The plugin is designed to be GDPR compliant.

= How do I view my statistics? =

Click "View my statistics" on the plugin configuration page, or log in directly to your WEBFUL account.

= Can I temporarily disable tracking? =

Yes, simply uncheck the "Enable tracking on this site" option in the plugin settings.

= Can I exclude my own visits from statistics? =

Yes, enable the "Exclude logged-in administrators" option in the plugin settings. Your visits will no longer be counted while you're logged in to WordPress.

= What happens if I reach my page views quota? =

Tracking automatically stops when your monthly quota is reached. You can upgrade your plan to increase your quota.

= Does the plugin work with multilingual sites? =

Yes, the plugin is compatible with all WordPress sites, including multilingual sites.

= Can I use WEBFUL with Google Analytics? =

Yes, WEBFUL can be used alongside Google Analytics or other analytics tools.

== Screenshots ==

1. Simple connection form - Connect your WordPress site to WEBFUL in seconds with just your email and password
2. Dashboard with unlimited plan - Track your usage at a glance with clear quota display and quick access to detailed statistics
3. Privacy & Data Protection features - GDPR compliant analytics with no cookies, no personal data collection, and French hosting
4. Full analytics dashboard - Access detailed traffic statistics with interactive graphs and comprehensive insights

== Changelog ==

= 2.5.2 - 2026-03-07 =
* **FIX**: Scroll depth now reliably captured using sendBeacon (beforeunload fix)
* **FIX**: Short pages that fit in viewport now correctly report 100% scroll depth
* **IMPROVEMENT**: Tracking data sent every 15s instead of only on page exit
* **IMPROVEMENT**: Initial pageview sent immediately on load (was deferred to exit)

= 2.5.1 - 2026-03-07 =
* **FIX**: Corrected plugin version reporting to WEBFUL dashboard
* **FIX**: Dashboard now properly detects outdated plugin versions via API

= 2.5.0 - 2026-03-07 =
* **NEW**: Scroll depth tracking per page (0-100%)
* **NEW**: Screen resolution collection for device analytics
* **NEW**: Outbound link click tracking (external links)
* **NEW**: File download tracking (PDF, DOC, ZIP, etc.)
* **NEW**: JavaScript error monitoring (window.onerror)
* **NEW**: Real User Monitoring (LCP, FCP, CLS, TTFB, page load)
* **IMPROVEMENT**: Enhanced tracking script with 6 new data points
* **COMPATIBILITY**: Fully backward compatible - old plugin versions continue to work

= 2.4.0 - 2025-12-03 =
* **NEW**: Weekly stats display (7 days) instead of daily stats
* **NEW**: Comparison with previous week (+/- percentage)
* **NEW**: Adaptive period for new sites (shows stats since registration with notice)
* **IMPROVEMENT**: More relevant statistics for tracking site performance
* **UX**: Clear indication when stats cover less than 7 days

= 2.3.0 - 2025-12-03 =
* **NEW**: Mini-dashboard with today's stats (visitors, pageviews, avg time)
* **NEW**: Quick stats API endpoint for real-time data
* **NEW**: Evolution indicator vs yesterday (+/- percentage)
* **IMPROVEMENT**: Replaced quota display with more relevant daily statistics
* **IMPROVEMENT**: Direct link to full dashboard from stats card
* **PERFORMANCE**: Stats cached for 5 minutes to reduce API calls

= 2.2.0 - 2025-12-03 =
* **NEW**: Improved onboarding flow with two clear options: "I have an account" / "Create an account"
* **NEW**: Pre-filled registration form when coming from WordPress plugin (site URL, site name, integration type)
* **IMPROVEMENT**: Clearer user interface for first-time setup
* **IMPROVEMENT**: Step-by-step instructions for new users
* **UX**: Added "Back" navigation for better flow
* **UX**: Direct link to password reset from login form

= 2.1.2 - 2025-11-16 =
* **CRITICAL FIX**: Badge now respects user preference in all cases
* **IMPROVEMENT**: Simplified badge logic - removed API dependency for better reliability
* **FIX**: Badge display honors checkbox setting regardless of plan type
* **PERFORMANCE**: Removed external API call for plan detection (faster page loads)
* **DESIGN**: Improved badge styling with dark background harmonization

= 2.1.1 - 2025-11-16 =
* **FIX**: Badge configuration improvements
* **FIX**: Cache busting for WordPress sites with aggressive caching
* Version bump to force plugin refresh

= 2.1.0 - 2025-11-15 =
* **NEW**: Search trends tracking - Multi-source keyword analysis (Bing, Yahoo, DuckDuckGo, Ecosia, Qwant)
* **NEW**: Page title tracking for better keyword inference
* **NEW**: UTM parameters tracking (utm_source, utm_medium, utm_campaign, utm_term, utm_content)
* **NEW**: "Powered by WEBFUL" badge with user control
* **FEATURE**: Dashboard shows top 20 search terms that attract visitors
* **FEATURE**: 3-source keyword analysis (direct queries, UTM campaigns, NLP from titles)
* **IMPROVEMENT**: Enhanced tracking script with URL parameter parsing

= 2.0.0 - 2025-10-29 =
* **MAJOR NEW FEATURE**: Automatic conversion tracking (phone clicks, email clicks, form submissions)
* **NEW**: Automatic detection of conversion pages (contact, thank you, confirmation)
* **NEW**: Automatic plugin version reporting to dashboard for update detection
* **IMPROVEMENT**: Optimized tracking script performance
* **IMPROVEMENT**: Better user session management with sessionStorage
* **IMPORTANT**: After update, visit your site in private browsing to register the new version in your WEBFUL dashboard

= 1.2.1 - 2025-10-24 =
* **NEW**: GDPR consent screen on first activation
* Full compliance with WordPress.org and GDPR requirements
* User must explicitly accept data sending before tracking activation
* Documentation improvements
* Added advanced WEBFUL platform features to description
* Added FAQ about administrator exclusion

= 1.2.0 - 2025-10-24 =
* **CRITICAL FIX**: Protection against Cloudflare Rocket Loader
* Added `data-cfasync="false"` attribute to tracking script
* Ensures proper functioning on sites using Cloudflare
* Improved CDN compatibility

= 1.1.0 - 2025-10-19 =
* Improved API error handling
* Quota cache optimization
* Added `data-base-url` support for remote sites

= 1.0.0 - 2025-01-19 =
* Initial release
* Automatic WEBFUL API connection
* Ultra-lightweight tracking (< 1 KB)
* Quota verification
* Complete admin interface
* Configuration settings

== Upgrade Notice ==

= 2.5.2 =
Fix: scroll depth tracking now works reliably. Data sent via sendBeacon on page exit and every 15 seconds. Short pages correctly report 100%.

= 2.5.1 =
Fix: corrected version reporting to WEBFUL dashboard. Update recommended for accurate version detection.

= 2.5.0 =
Enhanced tracking with scroll depth, screen resolution, outbound clicks, file downloads, JS error monitoring and Real User Monitoring (Core Web Vitals). Fully backward compatible.

= 2.0.0 =
**MAJOR VERSION**: Automatic conversion tracking! After updating, you MUST visit your site in private browsing mode (CTRL+SHIFT+N) to register the new version in your WEBFUL dashboard. Without this visit, the update alert will continue to display.

= 1.2.1 =
**NEW FEATURE**: WordPress.org compliant GDPR consent screen. If you've already installed the plugin, no action required - your consent is already registered.

= 1.2.0 =
**IMPORTANT UPDATE**: Fixes a critical issue with Cloudflare Rocket Loader. If your site uses Cloudflare and tracking doesn't work, this update solves the problem.

= 1.1.0 =
Error handling and compatibility improvements.

= 1.0.0 =
First version of WEBFUL Analytics plugin. Install it to start tracking your statistics!

== Support ==

For any questions or issues:

* Visit [webful.fr](https://webful.fr)
* Send an email to support@webful.fr
* Check the documentation at [webful.fr/documentation](https://webful.fr/documentation.php)

== Development ==

This plugin is developed and maintained by the WEBFUL team.

Source code: [GitHub](https://github.com/webful/wordpress-plugin)

== Privacy Policy ==

WEBFUL Analytics respects your privacy and your visitors' privacy:

* No cookies are used
* No personally identifiable data is collected
* IP addresses are irreversibly hashed
* GDPR compliant by design
* Data stored in France

For more information, see our [privacy policy](https://webful.fr/politique-confidentialite).
