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