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.6
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.
*   **Shortcode Support:** Display your sales map anywhere on your site using the `		

			

			

				


			
			
			

				

				

					
Total Sales: 
					
Revenue: 
				
			
			
			

				
 0
				
 
				
 
				
 
				
 
			

			

				

					Total Regions Reached: 32				
				

					
						
						Support this plugin					
				
			

			
			
		
		` shortcode.

== 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.6 =
* Update: Enhanced security by adding late escaping to all HTML and SVG outputs, conforming to official WordPress.org guidelines.
* Update: Refactored internal codebase to use the unique `wmt_gsm` prefix, preventing conflicts with other plugins.
* Update: The display shortcode has been updated to `		

			

			

				


			
			
			

				

				

					
Total Sales: 
					
Revenue: 
				
			
			
			

				
 0
				
 
				
 
				
 
				
 
			

			

				

					Total Regions Reached: 32				
				

					
						
						Support this plugin					
				
			

			
			
		
		`.
* Fix: Resolved an issue where admin scripts and styles were occasionally not enqueued correctly.

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