Title: Naqshino Sales Map for WooCommerce
Author: kianimr
Published: <strong>September 17, 2026</strong>
Last modified: September 17, 2026

---

Search plugins

![](https://ps.w.org/naqshino-sales-map-for-woocommerce/assets/banner-772x250.png?
rev=3700106)

![](https://ps.w.org/naqshino-sales-map-for-woocommerce/assets/icon-256x256.png?
rev=3700106)

# Naqshino Sales Map for WooCommerce

 By [kianimr](https://profiles.wordpress.org/kianimr/)

[Download](https://downloads.wordpress.org/plugin/naqshino-sales-map-for-woocommerce.1.0.0.zip)

 * [Details](https://wordpress.org/plugins/naqshino-sales-map-for-woocommerce/#description)
 * [Reviews](https://wordpress.org/plugins/naqshino-sales-map-for-woocommerce/#reviews)
 *  [Installation](https://wordpress.org/plugins/naqshino-sales-map-for-woocommerce/#installation)
 * [Development](https://wordpress.org/plugins/naqshino-sales-map-for-woocommerce/#developers)

 [Support](https://wordpress.org/support/plugin/naqshino-sales-map-for-woocommerce/)

## Description

Naqshino Sales Map adds a report to WooCommerce that shows which provinces and cities
of Iran your orders come from.

 * An interactive map of all 31 provinces, colored by revenue, number of orders,
   unique customers or average order value.
 * A circle on each city, sized by the same metric.
 * Click a province to zoom into it and list all of its cities in a sortable table.
 * Click a city to open its customer list: name, phone, number of orders, total 
   spent, last order date and a link to the order.
 * Date range filter with a Persian (Jalali) calendar, and a choice of which order
   statuses are counted.
 * An Unmatched Cities screen for city names that could not be placed on the map.
   Link each one to the right city or dismiss it; existing orders are updated immediately.
 * CSV export of whatever the table is showing.

The report is only available to users who can manage WooCommerce. Nothing is added
to the front end of your store.

#### توضیحات فارسی

نقشه فروش نقشینو نشان می‌دهد سفارش‌های فروشگاه ووکامرسی شما از کدام استان‌ها و شهرهای
ایران آمده است. بعد از نصب، در منوی «ووکامرس» دو صفحهٔ «نقشه فروش» و «شهرهای ناشناخته»
اضافه می‌شود.

 * نقشهٔ تعاملی هر ۳۱ استان، رنگ‌آمیزی‌شده بر اساس مبلغ فروش، تعداد سفارش، تعداد
   مشتری یکتا یا میانگین ارزش سفارش
 * دایره روی هر شهر که اندازه‌اش با همان معیار تغییر می‌کند
 * با کلیک روی هر استان، نقشه روی آن استان بزرگ می‌شود و همهٔ شهرهایش در جدول کنار
   نقشه می‌آید
 * با کلیک روی هر شهر، فهرست مشتریان همان شهر باز می‌شود: نام، موبایل، تعداد سفارش،
   مجموع خرید، تاریخ آخرین سفارش و لینک سفارش
 * فیلتر بازهٔ زمانی با تقویم شمسی و انتخاب وضعیت سفارش‌هایی که حساب شوند
 * صفحهٔ «شهرهای ناشناخته» برای نام‌هایی که به شهر مشخصی وصل نشده‌اند؛ هر کدام را
   به شهر درست وصل کنید تا سفارش‌های قبلی هم فوراً اصلاح شوند
 * خروجی CSV از همان چیزی که در جدول می‌بینید

**بدون درخواست خارجی:** نقشه، مختصات شهرها و فونت وزیرمتن داخل خود افزونه است؛ به
گوگل‌مپ، گوگل‌فونت یا هیچ سرویس خارجی وصل نمی‌شود و روی هاست‌های داخل ایران بدون
مشکل کار می‌کند.

**سبک و سریع:** در بخش کاربری سایت هیچ فایلی بارگذاری نمی‌شود و گزارش‌ها روی یک 
جدول کوچک و ایندکس‌دار اجرا می‌شوند، پس تعداد زیاد سفارش سرعت پیشخوان را کم نمی‌کند.
با HPOS ووکامرس و حالت قدیمی ذخیره‌سازی سفارش‌ها و با افزونه‌های فارسی‌ساز سازگار
است.

**شروع کار:** افزونه را نصب و فعال کنید، به «ووکامرس  نقشه فروش» بروید و روی «ساخت
داده‌های نقشه» بزنید. سفارش‌های قبلی در پس‌زمینه پردازش می‌شوند.

ترجمهٔ فارسی رابط افزونه از طریق translate.wordpress.org ارائه می‌شود و پس از تأیید،
خودکار روی سایت‌های فارسی نصب می‌شود. اگر رابط را هنوز انگلیسی می‌بینید، از «پیشخوان
به‌روزرسانی‌ها» ترجمه‌ها را به‌روز کنید.

#### No external requests

The map, city coordinates, the Vazirmatn font and every other asset ship with the
plugin. No request is made to Google Maps, Google Fonts, tile servers or any CDN,
so it works on servers with restricted internet access and on sites with a strict
Content Security Policy.

#### Built for speed

The report does not query the orders table or post meta when the page loads. The
plugin keeps a small side table with one lightweight row per order, updated whenever
an order changes, and runs the report on that indexed table. Customer names and 
phone numbers are not copied into it; they are read from WooCommerce only when you
open a city’s customer list.

Writing that row happens in the background through Action Scheduler, so checkout
is not slowed down. Existing orders are processed in batches after activation.

#### Compatibility

Works with both High-Performance Order Storage (HPOS) and the legacy post storage.
Provinces are matched against the state list of your own store, so it works with
WooCommerce’s built-in Iranian states and with Persian localization plugins that
change them.

City names are normalized (zero-width non-joiners, Arabic Yeh and Kaf, diacritics,
Persian digits) and matched within the order’s province.

### Privacy

The plugin does not send any data outside your site. Customer names, phone numbers
and emails are read from WooCommerce orders and shown only to users who can manage
WooCommerce. The plugin’s own table stores a hashed customer key, never the customer’s
name, email or phone number.

### Credits

 * Province borders: Natural Earth, public domain. https://www.naturalearthdata.
   com
 * City coordinates: GeoNames, licensed under CC BY 4.0. https://www.geonames.org
 * Font: Vazirmatn by Saber Rastikerdar, SIL Open Font License 1.1. https://github.
   com/rastikerdar/vazirmatn

The files in `data/` are generated from these sources. The scripts that build them
are in the `tools/` folder.

## Screenshots

[⌊The sales map: provinces colored by revenue, city circles, summary cards and the
province table. (نقشهٔ فروش با کارت‌های آمار و جدول استان‌ها)⌉⌊The sales map: provinces
colored by revenue, city circles, summary cards and the province table. (نقشهٔ فروش
با کارت‌های آمار و جدول استان‌ها)⌉[

The sales map: provinces colored by revenue, city circles, summary cards and the
province table. (نقشهٔ فروش با کارت‌های آمار و جدول استان‌ها)

[⌊Clicking a province zooms the map in and lists all of its cities. (بزرگ‌نمایی 
روی استان و فهرست شهرهایش)⌉⌊Clicking a province zooms the map in and lists all of
its cities. (بزرگ‌نمایی روی استان و فهرست شهرهایش)⌉[

Clicking a province zooms the map in and lists all of its cities. (بزرگ‌نمایی روی
استان و فهرست شهرهایش)

[⌊The customer list of a city, with orders, total spent, last order date and a link
to the order. (فهرست مشتریان هر شهر)⌉⌊The customer list of a city, with orders, 
total spent, last order date and a link to the order. (فهرست مشتریان هر شهر)⌉[

The customer list of a city, with orders, total spent, last order date and a link
to the order. (فهرست مشتریان هر شهر)

[⌊Date range filter with a Persian (Jalali) calendar. (فیلتر بازهٔ زمانی با تقویم
شمسی)⌉⌊Date range filter with a Persian (Jalali) calendar. (فیلتر بازهٔ زمانی با
تقویم شمسی)⌉[

Date range filter with a Persian (Jalali) calendar. (فیلتر بازهٔ زمانی با تقویم 
شمسی)

[⌊Unmatched Cities: link city names that could not be placed on the map. (صفحهٔ 
شهرهای ناشناخته)⌉⌊Unmatched Cities: link city names that could not be placed on 
the map. (صفحهٔ شهرهای ناشناخته)⌉[

Unmatched Cities: link city names that could not be placed on the map. (صفحهٔ شهرهای
ناشناخته)

[⌊Settings: which address to use and which order statuses to count. (تنظیمات افزونه)⌉⌊
Settings: which address to use and which order statuses to count. (تنظیمات افزونه
)⌉[

Settings: which address to use and which order statuses to count. (تنظیمات افزونه)

## Installation

 1. Install the plugin from the Plugins screen, or upload the plugin folder to `wp-
    content/plugins/`.
 2. Activate it. WooCommerce must be active.
 3. Go to WooCommerce > Sales Map and click “Build map data”. Existing orders are processed
    in the background.

## FAQ

### Does it work with stores outside Iran?

The map and city data cover Iran only. Orders with addresses in other countries 
are not placed on the map.

### Why do some orders show in the province total but have no circle?

Their city name could not be matched to a known city. Open WooCommerce > Unmatched
Cities to link those names to the correct city.

### Which address is used, billing or shipping?

By default the shipping address, falling back to billing when shipping is empty.
You can change this in the settings at the bottom of the Sales Map page.

### Does it slow down my store?

No. Nothing is loaded on the front end, and the per-order update runs in the background.

### What happens to my data if I delete the plugin?

Deleting the plugin removes its side table and all of its options. Your orders are
never modified.

## Reviews

There are no reviews for this plugin.

## Contributors & Developers

“Naqshino Sales Map for WooCommerce” is open source software. The following people
have contributed to this plugin.

Contributors

 *   [ kianimr ](https://profiles.wordpress.org/kianimr/)

[Translate “Naqshino Sales Map for WooCommerce” into your language.](https://translate.wordpress.org/projects/wp-plugins/naqshino-sales-map-for-woocommerce)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/naqshino-sales-map-for-woocommerce/),
check out the [SVN repository](https://plugins.svn.wordpress.org/naqshino-sales-map-for-woocommerce/),
or subscribe to the [development log](https://plugins.trac.wordpress.org/log/naqshino-sales-map-for-woocommerce/)
by [RSS](https://plugins.trac.wordpress.org/log/naqshino-sales-map-for-woocommerce/?limit=100&mode=stop_on_copy&format=rss).

## Changelog

#### 1.0.0

 * First public release.

## Meta

 *  Version **1.0.0**
 *  Last updated **9 hours ago**
 *  Active installations **Fewer than 10**
 *  WordPress version ** 6.5 or higher **
 *  Tested up to **7.1**
 *  PHP version ** 7.4 or higher **
 * Tags
 * [analytics](https://wordpress.org/plugins/tags/analytics/)[Iran](https://wordpress.org/plugins/tags/iran/)
   [map](https://wordpress.org/plugins/tags/map/)[sales report](https://wordpress.org/plugins/tags/sales-report/)
   [woocommerce](https://wordpress.org/plugins/tags/woocommerce/)
 *  [Advanced View](https://wordpress.org/plugins/naqshino-sales-map-for-woocommerce/advanced/)

## Ratings

No reviews have been submitted yet.

[Your review](https://wordpress.org/support/plugin/naqshino-sales-map-for-woocommerce/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/naqshino-sales-map-for-woocommerce/reviews/)

## Contributors

 *   [ kianimr ](https://profiles.wordpress.org/kianimr/)

## Support

Got something to say? Need help?

 [View support forum](https://wordpress.org/support/plugin/naqshino-sales-map-for-woocommerce/)