{"id":355159,"date":"2026-08-29T10:06:47","date_gmt":"2026-08-29T10:06:47","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/forooshnegar-advanced-sales-reports\/"},"modified":"2026-09-02T15:47:50","modified_gmt":"2026-09-02T15:47:50","slug":"forooshnegar","status":"publish","type":"plugin","link":"https:\/\/fa.wordpress.org\/plugins\/forooshnegar\/","author":23534883,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"1.1.0","stable_tag":"1.1.0","tested":"7.1","requires":"6.5","requires_php":"7.4","requires_plugins":null,"header_name":"ForooshNegar \u2013 Advanced Sales Reports","header_author":"Hamidreza Moghaddam","header_description":"Professional WooCommerce reports with Jalali dates, CSV exports, customer insights, and inventory analysis.","assets_banners_color":"434b58","last_updated":"2026-09-02 15:47:50","external_support_url":"","external_repository_url":"","donate_link":"https:\/\/hamidrezamoghaddam.ir\/","header_plugin_uri":"https:\/\/hamidrezamoghaddam.ir\/","header_author_uri":"https:\/\/hamidrezamoghaddam.ir\/","rating":0,"author_block_rating":0,"active_installs":0,"downloads":81,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.0.1":{"tag":"1.0.1","author":"mrhamidreza","date":"2026-08-29 11:32:24","revision":3671459},"1.1.0":{"tag":"1.1.0","author":"mrhamidreza","date":"2026-09-02 15:47:50","revision":3678309}},"upgrade_notice":[],"ratings":[],"assets_icons":{"icon-128x128.jpg":{"filename":"icon-128x128.jpg","revision":3671407,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128},"icon-256x256.jpg":{"filename":"icon-256x256.jpg","revision":3671407,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256}},"assets_banners":{"banner-1544x500.jpg":{"filename":"banner-1544x500.jpg","revision":3671407,"resolution":"1544x500","location":"assets","locale":"","width":1544,"height":500},"banner-772x250.jpg":{"filename":"banner-772x250.jpg","revision":3671407,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.0.1","1.1.0"],"block_files":[],"assets_screenshots":[],"screenshots":{"1":"Jalali date filters and sales summary cards.","2":"Product, customer, and geographic reports.","3":"Optional Bale and Telegram integration settings."}},"plugin_section":[],"plugin_tags":[232,567,3654,332,286],"plugin_category":[36,45],"plugin_contributors":[273895],"plugin_business_model":[],"class_list":["post-355159","plugin","type-plugin","status-publish","hentry","plugin_tags-analytics","plugin_tags-csv","plugin_tags-reports","plugin_tags-sales","plugin_tags-woocommerce","plugin_category-analytics","plugin_category-ecommerce","plugin_contributors-mrhamidreza","plugin_committers-mrhamidreza"],"banners":{"banner":"https:\/\/ps.w.org\/forooshnegar\/assets\/banner-772x250.jpg?rev=3671407","banner_2x":"https:\/\/ps.w.org\/forooshnegar\/assets\/banner-1544x500.jpg?rev=3671407","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/forooshnegar\/assets\/icon-128x128.jpg?rev=3671407","icon_2x":"https:\/\/ps.w.org\/forooshnegar\/assets\/icon-256x256.jpg?rev=3671407","generated":false},"screenshots":[],"raw_content":"<!--section=description-->\n<p>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.<\/p>\n\n<p>Features include:<\/p>\n\n<ul>\n<li>Jalali date-range filtering with order-status and payment-gateway filters.<\/li>\n<li>Sales, shipping, refund, net-revenue, daily-sales, and referral reports.<\/li>\n<li>Product performance, best-selling variations, discounts, products without sales, and stock insights.<\/li>\n<li>Customer analysis for new, returning, registered, and guest customers.<\/li>\n<li>Geographic analysis by province or state.<\/li>\n<li>UTF-8 CSV exports for orders, products, customers, and geographic data.<\/li>\n<li>Protection against spreadsheet-formula injection in CSV fields.<\/li>\n<li>A responsive RTL-ready WordPress admin interface.<\/li>\n<li>Optional scheduled aggregate reports through Bale and\/or Telegram Bot APIs.<\/li>\n<\/ul>\n\n<h3>External Service<\/h3>\n\n<p>The optional messenger integrations connect only after an administrator enables them and enters bot tokens plus destination chat IDs.<\/p>\n\n<p><strong>Bale<\/strong><\/p>\n\n<p>When Bale reporting is enabled, ForooshNegar connects to <code>https:\/\/tapi.bale.ai<\/code> and sends:<\/p>\n\n<ul>\n<li>Order and customer counts.<\/li>\n<li>Revenue, shipping, discount, and wallet totals.<\/li>\n<li>Payment gateway titles and totals.<\/li>\n<li>Names and quantities of up to three top-selling products.<\/li>\n<li>Month-to-date sales summary.<\/li>\n<\/ul>\n\n<p>Bale service use is subject to its terms and privacy policy: https:\/\/bale.ai\/terms<\/p>\n\n<p><strong>Telegram<\/strong><\/p>\n\n<p>When Telegram reporting is enabled, ForooshNegar connects to <code>https:\/\/api.telegram.org<\/code> and sends the same aggregate information listed above.<\/p>\n\n<p>Telegram service use is subject to its terms and privacy policy: https:\/\/telegram.org\/privacy<\/p>\n\n<p>You can enable Bale only, Telegram only, or both at the same time.<\/p>\n\n<p>Customer names, email addresses, phone numbers, and addresses are never sent.<\/p>\n\n<!--section=installation-->\n<ol>\n<li>Upload the <code>forooshnegar<\/code> folder to <code>\/wp-content\/plugins\/<\/code>, or install the ZIP through Plugins &gt; Add New &gt; Upload Plugin.<\/li>\n<li>Activate ForooshNegar.<\/li>\n<li>Ensure WooCommerce is installed and active.<\/li>\n<li>Open WooCommerce &gt; ForooshNegar.<\/li>\n<li>Configure optional Bale and\/or Telegram reports only if you intend to use them.<\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt id=\"does%20forooshnegar%20support%20hpos%3F\"><h3>Does ForooshNegar support HPOS?<\/h3><\/dt>\n<dd><p>Yes. It declares compatibility with WooCommerce High-Performance Order Storage and uses WooCommerce order APIs.<\/p><\/dd>\n<dt id=\"does%20the%20plugin%20send%20customer%20data%20to%20bale%20or%20telegram%3F\"><h3>Does the plugin send customer data to Bale or Telegram?<\/h3><\/dt>\n<dd><p>No. The optional integrations send only aggregate metrics, payment gateway titles, and top-product names and quantities.<\/p><\/dd>\n<dt id=\"can%20i%20use%20bale%20and%20telegram%20together%3F\"><h3>Can I use Bale and Telegram together?<\/h3><\/dt>\n<dd><p>Yes. Enable one or both messengers in WooCommerce &gt; ForooshNegar &gt; Messenger settings.<\/p><\/dd>\n<dt id=\"why%20might%20scheduled%20reports%20run%20late%3F\"><h3>Why might scheduled reports run late?<\/h3><\/dt>\n<dd><p>WordPress WP-Cron runs on site traffic. Configure a real server cron for predictable execution times.<\/p><\/dd>\n<dt id=\"how%20are%20plugin%20strings%20translated%3F\"><h3>How are plugin strings translated?<\/h3><\/dt>\n<dd><p>All user-facing strings use the <code>forooshnegar<\/code> text domain and can be translated on https:\/\/translate.wordpress.org\/<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.1.0<\/h4>\n\n<ul>\n<li>Added Telegram Bot API support alongside Bale.<\/li>\n<li>Redesigned daily report message with month-to-date summary.<\/li>\n<li>Fixed cron scheduling reliability and API response validation.<\/li>\n<li>Improved send-time UI with hour\/minute labels and WordPress timezone notice.<\/li>\n<li>Tested up to WordPress 7.1.<\/li>\n<\/ul>\n\n<h4>1.0.1<\/h4>\n\n<ul>\n<li>Removed bundled translation files for WordPress.org translation system compatibility.<\/li>\n<li>Removed Domain Path header.<\/li>\n<\/ul>\n\n<h4>1.0.0<\/h4>\n\n<ul>\n<li>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:\/\/fa.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/355159","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/fa.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/fa.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/fa.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=355159"}],"author":[{"embeddable":true,"href":"https:\/\/fa.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/mrhamidreza"}],"wp:attachment":[{"href":"https:\/\/fa.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=355159"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/fa.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=355159"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/fa.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=355159"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/fa.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=355159"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/fa.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=355159"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/fa.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=355159"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}