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.