=== Globe Visitors Counter ===
Contributors: vectormapper
Tags: analytics, visitors, globe, counter, map
Requires at least: 5.4
Tested up to: 6.8
Stable tag: 1.5.1
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.

### ✦ Key Features
- **Interactive 3D Land-Cover globe** included out of the box  
- **Real-time visitor logging** with 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 self-contained viewer bundle from:

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


The viewer writes a minimal visit entry (timestamp + coordinates + city + country) to:

visitors.json


Everything is handled locally on your server.  
No tracking pixels, no external analytics, no cookies.

### ✦ Why Use It
- Great for landing pages and stores  
- Shows your global audience in a visual, engaging way  
- Safe for cached pages and CDNs  
- Works even on heavily optimized / minified setups

### ✦ Tester Program (optional)
We are tuning defaults and performance for upcoming builds.  
If you want to enable **advanced features during testing at no cost** (heatmap modes, line-effects, more 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 served from uploads, fully detached from your theme and plugins.

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

== Changelog ==

= 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.