=== Visitor Visual ===
Contributors: arisavisuals
Tags: analytics, visitor tracking, live visitors, conversion, ecommerce
Requires at least: 5.8
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Watch your website's visitors move through a live 3D city, in real time — instead of scrolling a spreadsheet.

== Description ==

Visitor Visual turns your website's traffic into a live 3D city. Every page is a building. Every visitor is a person walking your streets in real time. VIPs and returning visitors stand out. A purchase gets a fireworks celebration.

This plugin does exactly one thing: it adds your Visitor Visual tracker script to every page of your site, so you don't have to edit your theme files. Sign up for a free 7-day trial at [visitorvisuals.com](https://www.visitorvisuals.com) to get your Tracking ID, paste it into this plugin's settings page, and you're live.

**What you get:**

* A live 3D visualization of your real visitor traffic
* VIP and returning-visitor detection
* Purchase celebrations (add one line to your checkout confirmation page)
* Funnel visualization drawn spatially between your pages
* Weekly AI-written traffic digest (Pro plan)
* GDPR controls built in on every plan: IP anonymization and one-click visitor data deletion

This plugin does not slow down your site — the tracker script loads asynchronously and never blocks page rendering.

A Visitor Visual account is required (separate signup, separate billing at visitorvisuals.com) — this plugin only handles adding the tracker script to your WordPress site.

== Installation ==

1. Install and activate the plugin through the WordPress Plugins screen, or upload it via Plugins > Add New > Upload Plugin.
2. Sign up for a Visitor Visual account and create a site to get your Tracking ID.
3. Go to Settings > Visitor Visual in your WordPress admin.
4. Paste your Tracking ID and click Save Settings.
5. Visit your site and check your Visitor Visual dashboard — your visit should appear within a few seconds.

== Frequently Asked Questions ==

= Do I need a Visitor Visual account? =

Yes. This plugin only adds the tracker script — the account, dashboard, and billing are all at visitorvisuals.com, separate from WordPress.org.

= Will this slow down my site? =

No. The script is enqueued with `async defer`, so it never blocks your page from rendering.

= Does this work with caching plugins? =

Yes — the tracker script is added directly via `wp_enqueue_scripts` on every request, the same mechanism analytics plugins like Google Analytics use, so standard page-caching plugins don't interfere with it.

= What happens if I deactivate or delete the plugin? =

Deactivating simply stops the script from being added to your pages; your Visitor Visual account and its data are untouched. Deleting the plugin also removes its one saved setting (your Tracking ID) from your WordPress database — your Visitor Visual account itself is managed entirely on visitorvisuals.com and is not affected.

== Screenshots ==

1. The settings page — paste your Tracking ID and save.

== Changelog ==

= 1.0.0 =
* Initial release.
