=== Globe Visitors Counter ===
Contributors: vectormapper
Tags: analytics, visitors, globe, counter, map
Requires at least: 5.4
Tested up to: 7.1
Stable tag: 1.5.2
Requires PHP: 7.2
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/old-licenses/gpl-2.0.html

Interactive 3D globe that shows your website visitors worldwide in real time and historically, with a fast lightweight Land Cover skin.

== Description ==

**Globe Visitors Counter (Lite)** adds a beautiful, fast, iframe-isolated 3D visitor globe to any WordPress site.  
It instantly shows your audience geography — fully locally, privately, and without any third-party tracking.

This Lite version is designed for **clarity, speed, and instant visual feedback** — especially on landing pages and campaign pages.

---

## Use Case: Instant Visual Feedback for Advertising Campaigns

### The situation
You have a product or a service.  
You launch an advertising campaign:

- Google Ads  
- Facebook / Instagram  
- TikTok  
- banner ads  
- email campaigns  
- any other traffic source  

All traffic is sent to **one landing page**.

Usually what comes next is boring:  
tables, charts, numbers, dashboards, “we’ll analyze it later”.

### The solution
You place **Globe Visitors Counter Lite directly on the landing page**.

No server setup.  
No external analytics.  
No configuration.

And you start **seeing your traffic with your own eyes**.

### How it works (very simple)

1. You launch the ads  
2. Visitors arrive at the page  
3. Each real visitor appears as a dot on the globe — in real time, from their actual location  

The globe comes alive and instantly shows:
- whether people are coming at all  
- which countries and regions react  
- whether the campaign works or misses completely  

No dots — ads don’t work.  
Dots appear — ads are alive.

### Why Lite is perfect for landing pages
Lite is **not deep analytics**.  
It’s a **visual “life indicator”**.

Perfect when you need:
- fast visual feedback  
- immediate confirmation that traffic is real  
- zero setup and zero learning curve  
- a simple “wow effect” for clients, teams, or investors  

You **watch**, not **analyze**.

---

## Key Features
- **Interactive 3D Land-Cover globe** included out of the box  
- **Real-time visitor logging** using a tiny local JSON file  
- **Historical dots** displayed automatically  
- **Zero configuration**, works with all themes & editors  
- **Shortcode-based**, easy placement on any page  
- **No cookies, no remote APIs, GDPR-friendly**  
- **Ultra-fast loading** thanks to iframe sandboxing  

---

## How It Works
When a page with the shortcode is opened, the plugin loads a fully self-contained viewer from:

/wp-content/uploads/visitors-lite-landcover/

Each visit is logged locally as a minimal record (timestamp + coordinates + city + country) into:

visitors.json

Everything stays **on your server**.  
No tracking pixels.  
No third-party analytics.  
No cookies.

---

## Why Use It
- Ideal for landing pages and product launches  
- Visualizes global audience instantly  
- Safe for cached pages and CDNs  
- Works even on heavily optimized sites  

---

## When You May Need the Full Version

Lite is intentionally simple and fast.

If you need:
- long-term statistics  
- multiple pages or sites  
- extended visitor history  
- advanced visual modes and skins  
- more control and customization  

…then the **Full (Pro) version** may be a better fit.

Lite remains perfect for **single pages, launches, tests, and quick visual validation**.

---

## Tester Program (optional)
We are tuning defaults and performance for upcoming builds.  
If you want to enable **advanced features during testing at no cost** (extra visual modes, effects, skins), join via Support:

https://wordpress.org/support/topic/looking-for-testers-free-advanced-features-for-feedback/

== Installation ==

1. Go to **Plugins → Add New**, search for **Globe Visitors Counter**, then **Install → Activate**  
   — or upload the ZIP manually.
2. Insert the shortcode into any page or post:

   `[visitors_globe_lite title="VISITORS" width="100%" height="600"]`
3. Open the page — the 3D globe appears inside an iframe.
4. Visits are logged locally in:

   `/wp-content/uploads/visitors-lite-landcover/visitors.json`

== Usage ==

Shortcode:

[visitors_globe_lite title="VISITORS" width="100%" height="600"]

**Attributes:**
- `title` — optional caption above the globe  
- `width` — iframe width (`100%` or fixed px)  
- `height` — iframe height in px  

Place the shortcode anywhere — Classic or Block editor.

== Frequently Asked Questions ==

= Does it collect personal data? =
No.  
A minimal JSON record is stored locally only to draw the globe.  
Nothing is sent to third-party analytics providers.

= Is it compatible with caching/CDN? =
Yes — the viewer is iframe-isolated.  
If you use aggressive minify/defer, exclude only the page with the globe.

= Will it slow down my theme? =
No.  
The viewer runs inside an iframe, fully detached from your theme and plugins.

== Screenshots ==
1. Land-Cover Globe with HUD and city markers.

== Changelog ==

= 1.5.2 =
* Updated compatibility for WordPress 7.1.
* Updated Pro version links to GlobeVis.

= 1.5.1 =
* New Land-Cover globe viewer (same engine as commercial build)
* Added full PHP visitor logger (`save_visitor.php`)
* Updated seed files (`index.html`, `app.js`, `visitor.js`)
* Atomic JSON writer with rotation for safe logging
* Cleaned up old files and simplified defaults
* Updated documentation and shortcode examples

= 1.2.1 =
* Expanded world cities dataset to 7,342 places (ASCII-only, deduplicated)
* Kept filename (`cities_1000.json`) for compatibility

= 1.1.9 =
* Added community Tester Program
* Improved accessibility defaults
* Better cache-safe behavior

= 1.1.8 =
* Rename to **Globe Visitors Counter**
* Lower “Requires at least” to **5.4**
* Minor text improvements

== Upgrade Notice ==

= 1.5.1 =
This update introduces the improved Land-Cover globe viewer and a local PHP logger.  
Upgrade recommended for better performance, safer logging, and simplified setup.
