=== StorePinger – Live Visitors & Ecommerce Analytics ===
Contributors: storepinger
Tags: analytics, live visitors, real-time, woocommerce, statistics
Requires at least: 6.2
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.3.7
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

See who is on your store right now: live visitors on a world map, their countries and today's visitors. Private, cookie-free and stored in your own database.

== Description ==

**See every visitor. Feel every sale.**

StorePinger shows you, live, who is on your WordPress or WooCommerce store, the way a shop owner sees the shop floor. No Google account, no code, nothing to configure.

= What you get, free =

* **Live visitors**, updated every 10 seconds.
* **World map** that lights up the countries your live visitors are in.
* **Visitors by country**, today.
* **Today's visitors, page views and pages per visit.**
* **Dashboard widget** with live visitors and today's numbers.

= Private and light =

* No cookies. A random visitor id is kept in the browser's local storage so returning visitors are not counted twice; it can be cleared in the browser at any time.
* IP addresses are never stored. They are only used, for a moment, to look up the country.
* Data stays in your own WordPress database. Visits older than 48 hours are deleted automatically.
* One small script (under 2 KB) that loads after the page, so it does not slow your store down.
* Your own visits as an administrator are not counted (you can change this).

= StorePinger Pro =

Want to know which ads and cities bring the money, and win back shoppers who left a cart? [StorePinger Pro](https://storepinger.com/pricing.html?utm_source=wordpress.org&utm_medium=readme) adds the pages people visit, where every visitor came from (Google, Meta ads, ChatGPT, email), city and area of every visitor, abandoned cart recovery, sales by source, session recordings, a conversion funnel, email marketing, reports and alerts, 90 days of history, and a mobile app for iPhone and Android.

== Privacy ==

StorePinger sets no cookies, stores no IP addresses, sends nothing to StorePinger and deletes visits after 48 hours. Full notice: [StorePinger plugin privacy notice](https://storepinger.com/privacy-plugin.html).

== External services ==

This plugin can connect to one external service, and only when you click the button for it:

* **DB-IP Lite country database** (download.db-ip.com). When you click "Download country database" (or "Update country database") on the StorePinger page, the plugin downloads the free DB-IP Lite country database once and stores it in your uploads folder. Visitor IP addresses are then looked up locally on your own server and are never sent anywhere. No data about your site or visitors is sent to DB-IP. The database is provided by DB-IP under the Creative Commons Attribution 4.0 license: [DB-IP Lite](https://db-ip.com/db/lite.php), [terms](https://db-ip.com/legal/terms-of-use), [privacy policy](https://db-ip.com/legal/privacy-policy). IP geolocation by DB-IP (https://db-ip.com).

If your site runs behind Cloudflare, the country can come from Cloudflare's own header instead, and no download is needed.

== Credits ==

* World map country shapes: [world-atlas](https://github.com/topojson/world-atlas) (ISC license), made from [Natural Earth](https://www.naturalearthdata.com/) data (public domain).
* Country lookup: DB-IP Lite (CC BY 4.0), downloaded only when you click the button.

== Installation ==

1. In WordPress, go to Plugins → Add New and search for "StorePinger", or upload the zip file.
2. Activate the plugin.
3. Open **StorePinger** in the menu. Visitors appear within minutes.
4. Optional: click **Download country database** to see visitors' countries.

== Frequently Asked Questions ==

= Do I need Google Analytics or an account? =

No. StorePinger works on its own, inside WordPress.

= Does it work with WooCommerce? =

Yes. It works on any WordPress site, and StorePinger Pro adds store features like abandoned cart recovery and sales by source.

= Does it use cookies? Do I need a cookie banner for it? =

StorePinger sets no cookies and stores no IP addresses. Whether you need consent depends on the laws that apply to your site; please check with your own advisor.

= Will it slow down my site? =

No. The tracking script is tiny, loads deferred, and sends a small request in the background.

= Why are my own visits not counted? =

Administrators are not counted by default, so your testing does not change your numbers. Turn it on in StorePinger → Settings.

== Screenshots ==

1. Live visitors on a world map.
2. Today's visitors and countries.
3. Dashboard widget.

== Changelog ==

= 1.3.7 =
* Every update is now digitally signed and checked before it installs.

= 1.3.6 =
* Safer upgrades and fewer fake visits from scripts; visits from one person in several tabs show once.

= 1.3.5 =
* First public release: live visitors, world map, visitors by country, today's visitors and page views, and a dashboard widget.
