=== EffortLess Landing Page Tracking for Matomo ===
Contributors: domclic
Tags: matomo, analytics, tracking, statistics, graph
Requires at least: 6.2
Tested up to: 7.0
Stable tag:        1.4.11
Requires PHP: 7.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Seamless Matomo analytics integration with beautiful visit graphs on your dashboard and via shortcode. Lightweight, privacy-friendly, multisite-ready.

== Description ==

**Effortless Landing Page Tracking for Matomo** brings your Matomo analytics directly into WordPress — without compromising privacy or performance.

This plugin automatically injects the official Matomo tracking code on every page and gives you instant visual feedback with **real-time visit graphs** directly on your WordPress dashboard and anywhere using a simple shortcode.

Perfect for bloggers, agencies, and multisite networks who want full control over their analytics without relying on Google.

= Key Features =
* One-click Matomo integration (just add your URL + Site ID)
* Secure API token handling (never exposed in URLs)
* Beautiful **daily / monthly / yearly** line charts
* Dashboard widget with live stats
* Shortcode `[matomo_visits]` works in posts, pages, widgets, Elementor, Gutenberg — everywhere
* Fully compatible with **WordPress Multisite** (network-wide settings)
* Automatic migration from older versions
* Local Chart.js (no external dependencies)
* 100% self-hosted, privacy-first analytics
* Clean, fast, and built with WordPress coding standards

No bloat. No tracking of you. Just your data, your way.

== Installation ==

1. Upload the `effortless-landing-page-tracking-for-matomo` folder to `/wp-content/plugins/`
2. Activate the plugin through the **Plugins** menu in WordPress
3. Go to **Settings → Matomo Tracking** (or **Network Admin → Settings → Matomo Tracking** in multisite)
4. Enter your Matomo URL (e.g. `https://stats.yourdomain.com/`) and Site ID
5. Add your API token (required for graphs)
6. Save — tracking + graphs appear instantly!

== Frequently Asked Questions ==

= Do I need a Matomo server? =
Yes. This plugin connects to your **self-hosted or Matomo Cloud** instance. You need the URL, Site ID, and an API token with **view** permission.

= Why not just use the official Matomo plugin? =
This plugin is lighter, faster, and focused: perfect tracking + beautiful graphs with zero configuration hassle.

= Are graphs cached? =
Yes! Data is cached for 24 hours and refreshed automatically.

= Does it work in widgets or page builders? =
Yes! Use `[matomo_visits]` anywhere — Gutenberg, Elementor, Classic Editor, text widgets — it just works.

= Is the API token secure? =
Yes. The token is sent via **POST** and never appears in logs or browser history.

== Screenshots ==

1. Clean settings page with wp-config.php or manual setup
2. Live visit graph on the WordPress dashboard
3. Shortcode graph embedded in a post or page

== Changelog ==

= 1.4.11 =
* Refactor: donate notice file kept as includes/class-donate-notice.php (preserves SVN file history); class remains Effortless_Donate_Notice.


= 1.4.10 =
* Fix: donate notice now correctly displays on Network Admin pages — screen ID normalization strips WordPress's -network/-user suffix before matching.


= 1.4.9 =
* Refactor: donate notice class renamed Donate_Notice → Effortless_Donate_Notice (WP-standard prefix); file renamed to class-effortless-donate-notice.php. No phpcs:ignore needed anywhere.


= 1.4.8 =
* Fix: donate notice now uses current_screen hook for reliable screen detection on single-site and multisite Network Admin pages.


= 1.4.7 =
* Improvement: added dismissible donate notice on the plugin settings screen.
* Improvement: added Donate link header field and includes/class-donate-notice.php.


= 1.4.5 =
* Fixed: Minor bugs

= 1.4.4 =
* Fixed: Use secure POST requests for Matomo API (token never exposed)
* Improved error handling and debugging

= 1.4.3 =
* Added automatic migration from very old versions (`ellpt_` options)
* Better multisite compatibility

= 1.4.2 =
* Fixed dashboard widget styling
* Updated translation template (.pot)

= 1.4.1 =
* Security and code quality improvements

= 1.4.0 =
* Added beautiful visit graphs (daily/monthly/yearly)
* Dashboard widget + `[matomo_visits]` shortcode

= 1.3.9 to 1.0.0 =
See full history at: https://plugins.trac.wordpress.org/log/effortless-landing-page-tracking-for-matomo/

== Upgrade Notice ==

= 1.4.5 =
* Fixed: Minor bugs

== Donate ==
Coming soon

Thank you for choosing privacy-first analytics!
