Title: ForooshNegar – Advanced Sales Reports
Author: Hamidreza Moghaddam
Published: <strong>August 29, 2026</strong>
Last modified: September 2, 2026

---

Search plugins

![](https://ps.w.org/forooshnegar/assets/banner-772x250.jpg?rev=3671407)

![](https://ps.w.org/forooshnegar/assets/icon-256x256.jpg?rev=3671407)

# ForooshNegar – Advanced Sales Reports

 By [Hamidreza Moghaddam](https://profiles.wordpress.org/mrhamidreza/)

[Download](https://downloads.wordpress.org/plugin/forooshnegar.1.1.0.zip)

 * [Details](https://wordpress.org/plugins/forooshnegar/#description)
 * [Reviews](https://wordpress.org/plugins/forooshnegar/#reviews)
 *  [Installation](https://wordpress.org/plugins/forooshnegar/#installation)
 * [Development](https://wordpress.org/plugins/forooshnegar/#developers)

 [Support](https://wordpress.org/support/plugin/forooshnegar/)

## Description

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 order-status and payment-gateway filters.
 * 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` and sends the same aggregate information listed above.

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.

## Installation

 1. Upload the `forooshnegar` folder to `/wp-content/plugins/`, or install the ZIP 
    through Plugins > Add New > Upload Plugin.
 2. Activate ForooshNegar.
 3. Ensure WooCommerce is installed and active.
 4. Open WooCommerce > ForooshNegar.
 5. Configure optional Bale and/or Telegram reports only if you intend to use them.

## FAQ

### Does ForooshNegar support HPOS?

Yes. It declares compatibility with WooCommerce High-Performance Order Storage and
uses WooCommerce order APIs.

### Does the plugin send customer data to Bale or Telegram?

No. The optional integrations send only aggregate metrics, payment gateway titles,
and top-product names and quantities.

### Can I use Bale and Telegram together?

Yes. Enable one or both messengers in WooCommerce > ForooshNegar > Messenger settings.

### Why might scheduled reports run late?

WordPress WP-Cron runs on site traffic. Configure a real server cron for predictable
execution times.

### How are plugin strings translated?

All user-facing strings use the `forooshnegar` text domain and can be translated
on https://translate.wordpress.org/

## Reviews

There are no reviews for this plugin.

## Contributors & Developers

“ForooshNegar – Advanced Sales Reports” is open source software. The following people
have contributed to this plugin.

Contributors

 *   [ Hamidreza Moghaddam ](https://profiles.wordpress.org/mrhamidreza/)

“ForooshNegar – Advanced Sales Reports” has been translated into 1 locale. Thank
you to [the translators](https://translate.wordpress.org/projects/wp-plugins/forooshnegar/contributors)
for their contributions.

[Translate “ForooshNegar – Advanced Sales Reports” into your language.](https://translate.wordpress.org/projects/wp-plugins/forooshnegar)

### Interested in development?

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

## Changelog

#### 1.1.0

 * Added Telegram Bot API support alongside Bale.
 * Redesigned daily report message with month-to-date summary.
 * Fixed cron scheduling reliability and API response validation.
 * Improved send-time UI with hour/minute labels and WordPress timezone notice.
 * Tested up to WordPress 7.1.

#### 1.0.1

 * Removed bundled translation files for WordPress.org translation system compatibility.
 * Removed Domain Path header.

#### 1.0.0

 * Initial public release.

## Meta

 *  Version **1.1.0**
 *  Last updated **17 hours ago**
 *  Active installations **Fewer than 10**
 *  WordPress version ** 6.5 or higher **
 *  Tested up to **7.1**
 *  PHP version ** 7.4 or higher **
 *  Languages
 * [English (US)](https://wordpress.org/plugins/forooshnegar/) and [Persian](https://fa.wordpress.org/plugins/forooshnegar/).
 *  [Translate into your language](https://translate.wordpress.org/projects/wp-plugins/forooshnegar)
 * Tags
 * [analytics](https://wordpress.org/plugins/tags/analytics/)[csv](https://wordpress.org/plugins/tags/csv/)
   [reports](https://wordpress.org/plugins/tags/reports/)[sales](https://wordpress.org/plugins/tags/sales/)
   [woocommerce](https://wordpress.org/plugins/tags/woocommerce/)
 *  [Advanced View](https://wordpress.org/plugins/forooshnegar/advanced/)

## Ratings

No reviews have been submitted yet.

[Your review](https://wordpress.org/support/plugin/forooshnegar/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/forooshnegar/reviews/)

## Contributors

 *   [ Hamidreza Moghaddam ](https://profiles.wordpress.org/mrhamidreza/)

## Support

Got something to say? Need help?

 [View support forum](https://wordpress.org/support/plugin/forooshnegar/)

## Donate

Would you like to support the advancement of this plugin?

 [ Donate to this plugin ](https://hamidrezamoghaddam.ir/)