Optional scheduled aggregate reports through Bale and\/or Telegram Bot APIs.<\/li>\n<\/ul>\n\nExternal Service<\/h3>\n\n
The optional messenger integrations connect only after an administrator enables them and enters bot tokens plus destination chat IDs.<\/p>\n\n
Bale<\/strong><\/p>\n\nWhen Bale reporting is enabled, ForooshNegar connects to https:\/\/tapi.bale.ai<\/code> and sends:<\/p>\n\n\n- Order and customer counts.<\/li>\n
- Revenue, shipping, discount, and wallet totals.<\/li>\n
- Payment gateway titles and totals.<\/li>\n
- Names and quantities of up to three top-selling products.<\/li>\n
- Month-to-date sales summary.<\/li>\n<\/ul>\n\n
Bale service use is subject to its terms and privacy policy: https:\/\/bale.ai\/terms<\/p>\n\n
Telegram<\/strong><\/p>\n\nWhen Telegram reporting is enabled, ForooshNegar connects to https:\/\/api.telegram.org<\/code> (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.<\/p>\n\nTelegram service use is subject to its terms and privacy policy: https:\/\/telegram.org\/privacy<\/p>\n\n
You can enable Bale only, Telegram only, or both at the same time.<\/p>\n\n
Customer names, email addresses, phone numbers, and addresses are never sent.<\/p>\n\n\n
\n- Upload the
forooshnegar<\/code> folder to \/wp-content\/plugins\/<\/code>, or install the ZIP through Plugins > Add New > Upload Plugin.<\/li>\n- Activate ForooshNegar.<\/li>\n
- Ensure WooCommerce is installed and active.<\/li>\n
- Open WooCommerce > ForooshNegar.<\/li>\n
- Configure optional Bale and\/or Telegram reports only if you intend to use them.<\/li>\n<\/ol>\n\n\n
\nDoes ForooshNegar support HPOS?<\/h3><\/dt>\nYes. It declares compatibility with WooCommerce High-Performance Order Storage and uses WooCommerce order APIs.<\/p><\/dd>\n
How do I connect Telegram if my server is hosted in Iran?<\/h3><\/dt>\nYou can either enter a custom reverse proxy URL (e.g. A Cloudflare Worker or private proxy endpoint) in the \"Custom API base URL\" field, or configure an HTTP or SOCKS5 proxy under WooCommerce > ForooshNegar > Messenger settings. Use the \"Test Telegram connection\" button to verify immediately.<\/p><\/dd>\n
Does the plugin send customer data to Bale or Telegram?<\/h3><\/dt>\nNo. The optional integrations send only aggregate metrics, payment gateway titles, and top-product names and quantities.<\/p><\/dd>\n
Can I use Bale and Telegram together?<\/h3><\/dt>\nYes. Enable one or both messengers in WooCommerce > ForooshNegar > Messenger settings.<\/p><\/dd>\n
Can I view sales stats on the main WordPress admin dashboard?<\/h3><\/dt>\nYes. ForooshNegar automatically adds an overview widget to the main WordPress dashboard (Dashboard > Home) showing today's, yesterday's, and monthly sales with a 10-minute cache to keep dashboard load times blazing fast.<\/p><\/dd>\n
Why might scheduled reports run late?<\/h3><\/dt>\nWordPress WP-Cron runs on site traffic. Configure a real server cron for predictable execution times.<\/p><\/dd>\n
How are plugin strings translated?<\/h3><\/dt>\nAll user-facing strings use the forooshnegar<\/code> text domain and can be translated on https:\/\/translate.wordpress.org\/<\/p><\/dd>\n\n<\/dl>\n\n\n1.3.0<\/h4>\n\n\n- Added: Interactive Jalali Datepicker popover with year, month, and day selection.<\/li>\n
- Added: Quick date range preset buttons (Today, Yesterday, Last 7\/30 days, This month, Last month, This year).<\/li>\n
- Added: Collapsible accordion sections for all reports with a jump-to-section dropdown and expand\/collapse all buttons.<\/li>\n
- Added: WordPress dashboard overview widget (
wp_dashboard_setup<\/code>) displaying today, yesterday, and monthly sales.<\/li>\n- Added: Telegram reverse proxy custom API endpoint and HTTP\/SOCKS5 proxy settings for Iranian servers.<\/li>\n
- Added: Instant connection test buttons for Telegram and Bale.<\/li>\n
- Added: Shipping method title, customer postal address, postal code, customer note, and summary totals row to the Orders CSV export.<\/li>\n
- Added: Summary totals row to Products, Customers, and Geography CSV exports.<\/li>\n
- Added: \"Select all\" and \"Clear all\" shortcut controls for order statuses and payment gateways.<\/li>\n
- Improved: Persian RTL styling, typography, and responsive layout across desktop and mobile screens.<\/li>\n<\/ul>\n\n
1.2.0<\/h4>\n\n\n- Fixed: disabling the daily report could be ignored when Bale remained enabled.<\/li>\n
- Fixed: gateway totals now show the exact paid amount per gateway (shipping is no longer subtracted).<\/li>\n
- Fixed: an empty order-status selection no longer returns every order.<\/li>\n
- Fixed: long messenger messages are split to respect Bot API limits.<\/li>\n
- Added: daily net-revenue and top-products charts on the reports screen.<\/li>\n<\/ul>\n\n
1.1.0<\/h4>\n\n\n- Added Telegram Bot API support alongside Bale.<\/li>\n
- Redesigned daily report message with month-to-date summary.<\/li>\n
- Fixed cron scheduling reliability and API response validation.<\/li>\n
- Improved send-time UI with hour\/minute labels and WordPress timezone notice.<\/li>\n
- Tested up to WordPress 7.1.<\/li>\n<\/ul>\n\n
1.0.1<\/h4>\n\n\n- Removed bundled translation files for WordPress.org translation system compatibility.<\/li>\n
- Removed Domain Path header.<\/li>\n<\/ul>\n\n
1.0.0<\/h4>\n\n\n- Initial public release.<\/li>\n<\/ul>","raw_excerpt":"Professional WooCommerce reporting with Jalali dates, customer and product insights, geographic analysis, and safe CSV exports.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/ar.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/355159","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/ar.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/ar.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/ar.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=355159"}],"author":[{"embeddable":true,"href":"https:\/\/ar.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/mrhamidreza"}],"wp:attachment":[{"href":"https:\/\/ar.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=355159"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/ar.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=355159"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/ar.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=355159"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/ar.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=355159"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/ar.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=355159"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/ar.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=355159"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}