Global Sales Map

=== We Make Things: Global Sales Map ===
Contributors: wemakethings
Tags: woocommerce, analytics, heatmap, sales, world map
Requires at least: 6.9
Tested up to: 6.9
Requires PHP: 7.4
Stable tag: 1.3.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

A privacy-first, interactive world heatmap for WooCommerce sales analytics.

== Description ==

Visualize your global sales impact with the **We Make Things: Global Sales Map**. This plugin provides a high-performance, interactive world map that instantly shows you where your orders and revenue are coming from.

Unlike complex analytics suites, this plugin is designed to be **Privacy-First**. It aggregates your sales data locally on your server and visualizes it using a lightweight SVG, ensuring no customer data ever leaves your site.

= Key Features =
*   **Interactive Heatmap:** Beautiful, responsive SVG map that scales to any screen.
*   **Order & Revenue Modes:** Switch between total order counts or total revenue visualization.
*   **Smart Auto-Scaling:** Automatically adjusts categories based on your store size (works for 10 sales or 10,000).
*   **Custom Branding:** Choose a custom base color to match your store's identity.
*   **Detailed Tooltips:** Hover over any country to see exact sales and revenue figures.
*   **High Performance:** Built using the WordPress Interactivity API for a smooth, app-like experience.

== Installation ==

1. Upload the `wmt-global-sales-map` folder to the `/wp-content/plugins/` directory, or install the .zip file via the WordPress admin.
2. Activate the plugin through the 'Plugins' menu in WordPress.
3. Access your map via **Analytics -> World Map** or find the settings under **WooCommerce -> Sales Map Settings**.

== Frequently Asked Questions ==

= Does this plugin track my customers? =
No. All data is aggregated locally on your server using your existing WooCommerce database. No external tracking is involved.

= Can I use my own brand colors? =
Yes! You can choose any base color in the settings, and the plugin will automatically generate a matching 4-tier heatmap.

== Screenshots ==

1. The main interactive world map with the heat-scaled visualization.
2. Detailed tooltips showing sales and revenue on hover.
3. The settings page allowing for metric and color customization.

== Changelog ==

= 1.3.1 =
*   First public release.
*   Implemented Intelligent Quantile Scaling for balanced visualization.
*   Added custom brand color support.
*   Added "Total Regions Reached" summary performance indicator.