=== StatJolt Analytics ===
Contributors: mitrillhu
Tags: analytics, website analytics, gdpr, insights, stats
Requires at least: 4.7
Tested up to: 7.0
Requires PHP: 7.0
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

The simplest Google Analytics alternative for WordPress. Lightweight, GDPR compliant & cookieless visitor insights. Paste a snippet and done!

== Description ==

= WordPress analytics that respects your visitors. And your time. =

StatJolt Analytics is a lightweight, cookie free alternative to Google Analytics for WordPress. It answers the questions you actually ask. Who visited, where they came from, what they read and whether your site was fast enough to keep them.

This plugin connects your WordPress site to StatJolt. You paste your code into one field. The plugin decides where it belongs, puts it on every page and clears your cache so the change reaches visitors immediately.

No consent banner. No personal data. No dashboard you need to study for.

= Google Analytics gives you data. StatJolt gives you answers. =

Setting up GA4 is a project. You create a property, wire up a data stream, learn what an engagement event is, then add a cookie banner because you now need consent. Weeks later you are still hunting for the number you wanted on day one.

StatJolt skips all of it. One snippet, real numbers, no sampling and no waiting for reports to process.

Because StatJolt sets no cookies and collects no personal data, most sites need no consent banner at all. That is one less legal headache and one less thing to maintain.

= Why not a stats plugin that stores everything in your database? =

Self hosted analytics plugins write a row to your WordPress database on every single page view. On a quiet blog you will never notice. On a busy site those tables grow into the millions, your queries slow down, your backups swell and your host starts asking questions.

StatJolt keeps none of it in WordPress. Your database stays exactly the size it was. Your server does not spend a single query on tracking.

You still own your numbers and your visitors still stay anonymous. The work simply happens somewhere that is built for it.

= Set up in one paste =

* **One field.** Paste the whole snippet.
* **Placed for you.** The code goes before the closing body tag and it still works on themes that never call `wp_footer`. There is nothing to configure and no compatibility mode to find.
* **Cache cleared automatically.** WP Rocket, LiteSpeed, W3 Total Cache, WP Super Cache, Super Page Cache, WP Fastest Cache, SiteGround Optimizer, Hummingbird, Breeze, Cache Enabler, Autoptimize and WP Engine are all handled. If you use something else, the plugin says so plainly and keeps saying it until data arrives.
* **Honest status.** The settings screen tells you whether StatJolt is genuinely receiving data from this site, not merely that a code is saved.
* **Safe to paste twice.** StatJolt runs once per page, so you cannot accidentally double count.

= What you see =

* Unique visitors and pageviews, as a trend rather than noise
* Where traffic comes from: search, social, direct and UTM campaigns
* Which pages people actually read
* Devices, browsers and countries
* Live visitors, right now, with no report processing delay

= More than pageviews =

Most analytics tools keep their best features for the priciest tier or expect you to bolt on a second product. StatJolt includes them from the start.

**Core Web Vitals.** LCP, INP, CLS, FCP and TTFB are tracked beside your traffic, automatically. These are the numbers Google uses to rank you. StatJolt does not only tell you who visited, it tells you whether your site was quick enough to keep them.

**User journeys.** See the real paths through your site, such as Home to Pricing to Signup, as a flow you can read at a glance.

**Funnels, found automatically.** Want to know where people give up before checkout or signup? Funnel analysis is locked behind expensive plans almost everywhere else. Here it is included and it recognises many platforms on its own.

**JavaScript errors.** Broken scripts cost you conversions silently. StatJolt reports the errors your visitors hit, so you find out before your customers tell you.

= Privacy by design, not by policy =

* No cookies. StatJolt does not need them, so it does not use them.
* No consent banner required in most countries.
* No personal data collected. You get the insight, your visitors keep their privacy.
* Nothing to configure to stay compliant.

= Who it is for =

* **Bloggers and creators** who want to know which posts landed, without a course in analytics.
* **Small business owners** who need answers this afternoon, not a certification.
* **Agencies and freelancers** running many sites. One StatJolt account covers all of them and the same snippet works on every one.
* **Anyone tired of cookie banners** who would rather not ask every visitor for consent to count them.

= How StatJolt compares =

**Google Analytics and GA4.** Powerful and built for advertisers rather than site owners. It samples your data, thresholds your reports and needs a consent banner in most of Europe. StatJolt shows real numbers with none of the setup.

**MonsterInsights.** A connector that pipes your visitors into Google Analytics. If you want your analytics without involving Google at all, StatJolt is a different answer to the same question.

**Burst Statistics, WP Statistics and Independent Analytics.** Good, privacy first plugins that keep data in your WordPress database. That is genuinely appealing and it is also the trade off: every page view becomes a database write on your own server. StatJolt takes that load off your site entirely and adds Core Web Vitals, journeys and funnels without a paid tier.

**Matomo.** Feature rich and self hostable. Also heavier to run. StatJolt is the simpler option when you do not want to operate an analytics server.

= What it costs =

StatJolt is 0 EUR to use until 2027, at any traffic volume. After 2027 analytics stay free for low traffic sites. In exchange it shows a small badge on your site and you choose where it sits or hide it in your account.

= About the badge =

StatJolt displays a small badge on your site. You control it entirely from your StatJolt account: move it, restyle it or switch it off. If your account is set to an in line badge, this plugin asks where you want it and offers your sidebar, any footer widget column, the bottom of the page or the `[statjolt_badge]` shortcode. Pages that do not render your chosen container still get the tracking code, so nothing goes unmeasured.

= Who is not counted =

Logged in users are skipped, which you can turn off with a single checkbox. Feeds, REST responses, previews and the login page are never touched.

== External services ==

This plugin connects to StatJolt at https://statjolt.com, the analytics service the plugin is built for. Two separate connections happen.

**1. Visitor tracking**

On every front end page view, the visitor's browser loads `https://statjolt.com/measure/c.min.js` and that script sends the page view to `https://statjolt.com/measure/counter.php`.

What is sent: your StatJolt ID, the page path, the page title, the referrer, screen width, browser language, UTM campaign parameters, Core Web Vitals timings and uncaught JavaScript errors. No cookies are set.

When: on every front end page view of your site, for every visitor.

**2. Setup check**

When you open the plugin's settings screen, your server calls `https://statjolt.com/pluginstatus.php` and sends your StatJolt ID together with your site's domain name. StatJolt answers whether the ID exists, whether data is arriving and how your badge is configured. The same call runs once when you save a new ID.

When: in the admin area only, at most once every five minutes.

Terms of service: https://statjolt.com/en/page/tos
Privacy policy: https://statjolt.com/en/page/privacy

== Installation ==

1. Install and activate the plugin.
2. The plugin takes you to Settings, StatJolt.
3. Open your StatJolt account, copy your code with the copy button, then paste it into the field and save.
4. Open your site in a private window. The status turns green once the first visit arrives.

== Frequently Asked Questions ==

= I do not have a StatJolt account yet. =

The settings screen has a link that takes you to the sign up page.

= Where exactly does the code go? =

You don't have to worry about that, the plugin handles this. The rule is simple: where it appears the code went there. In case of floating it is before the closing body tag.

= What if my theme does not call wp_footer? =

The code still goes out. The plugin falls back to inserting it before the closing body tag. If the theme does not have one either, the code goes at the very end of the page. This is automatic and there is nothing to switch on.

= Does this work with caching plugins? =

Yes. The code the plugin adds is the same for every visitor, so there is nothing to exclude from the cache. After you save your ID, the plugin clears the cache of WP Rocket, LiteSpeed Cache, W3 Total Cache, WP Super Cache, Super Page Cache, WP Fastest Cache, SiteGround Optimizer, Hummingbird, Breeze, Cache Enabler, Autoptimize and WP Engine, if you use one of them. If it finds none of them, it tells you to clear the cache yourself and keeps saying so until data starts arriving.

= Does it work on multisite? =

Yes. The network settings screen sets one StatJolt ID for every site and each site can override it. StatJolt identifies a site by its domain.

= Can I put the badge somewhere specific? =

Use the `[statjolt_badge]` shortcode. On a block theme, drop the Shortcode block into your footer template part in the Site Editor.

== Screenshots ==

1. The clean and intuitive StatJolt external dashboard showing your real-time website traffic.
2. The ultra-simple WordPress settings page. Just paste your snippet and you are done.

== Changelog ==

= 1.0.0 =
* First release.

== Upgrade Notice ==

= 1.0.0 =
First release.
