Directory / plugin

ForooshNegar – Advanced Sales Reports

v1.3.0 · by Hamidreza Moghaddam

Professional WooCommerce reporting with Jalali dates, customer and product insights, geographic analysis, and safe CSV exports.

About this plugin

ForooshNegar adds a fast, Persian-friendly reporting screen to WooCommerce. It uses WooCommerce order APIs, supports both legacy order storage and High-Performance Order Storage (HPOS), and processes report data in bounded batches to keep the WordPress admin responsive.

Features include:

  • Jalali date-range filtering with interactive calendar popover and one-click quick presets (Today, Yesterday, Last 7/30 days, This month, Last month, This year).
  • Collapsible accordion report sections with a quick-jump selector to review specific areas with maximum readability.
  • WordPress main dashboard widget displaying today’s, yesterday’s, and monthly sales overview at a glance.
  • Enhanced Telegram integration with support for custom reverse proxy base URLs and HTTP/SOCKS5 proxies for servers in Iran.
  • Instant test-connection buttons for Telegram and Bale to verify configuration immediately.
  • Enhanced CSV exports: includes shipping method title, customer postal address, postal code, customer note, and summary totals row.
  • Quick “Select all” and “Clear all” buttons for order statuses and payment gateways.
  • Sales, shipping, refund, net-revenue, daily-sales, and referral reports.
  • Product performance, best-selling variations, discounts, products without sales, and stock insights.
  • Customer analysis for new, returning, registered, and guest customers.
  • Geographic analysis by province or state.
  • UTF-8 CSV exports for orders, products, customers, and geographic data.
  • Protection against spreadsheet-formula injection in CSV fields.
  • A responsive RTL-ready WordPress admin interface.
  • Optional scheduled aggregate reports through Bale and/or Telegram Bot APIs.

External Service

The optional messenger integrations connect only after an administrator enables them and enters bot tokens plus destination chat IDs.

Bale

When Bale reporting is enabled, ForooshNegar connects to https://tapi.bale.ai and sends:

  • Order and customer counts.
  • Revenue, shipping, discount, and wallet totals.
  • Payment gateway titles and totals.
  • Names and quantities of up to three top-selling products.
  • Month-to-date sales summary.

Bale service use is subject to its terms and privacy policy: https://bale.ai/terms

Telegram

When Telegram reporting is enabled, ForooshNegar connects to https://api.telegram.org (or an administrator-configured reverse proxy URL) and sends the same aggregate information listed above. An optional HTTP or SOCKS5 proxy server can also be configured.

Telegram service use is subject to its terms and privacy policy: https://telegram.org/privacy

You can enable Bale only, Telegram only, or both at the same time.

Customer names, email addresses, phone numbers, and addresses are never sent.

Plugin tags