{"id":342405,"date":"2026-07-30T18:25:47","date_gmt":"2026-07-30T18:25:47","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/hamidreza-order-notifier\/"},"modified":"2026-08-09T07:54:45","modified_gmt":"2026-08-09T07:54:45","slug":"hamidreza","status":"publish","type":"plugin","link":"https:\/\/ru.wordpress.org\/plugins\/hamidreza\/","author":23534883,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"1.3.0","stable_tag":"1.3.0","tested":"7.0.3","requires":"6.0","requires_php":"7.4","requires_plugins":null,"header_name":"Hamidreza Order Notifier","header_author":"Hamidreza","header_description":"Sends WooCommerce order notifications to Telegram or Bale.","assets_banners_color":"e5eefc","last_updated":"2026-08-09 07:54:45","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"https:\/\/hamidrezamoghaddam.ir\/","header_author_uri":"https:\/\/hamidrezamoghaddam.ir\/","rating":0,"author_block_rating":0,"active_installs":0,"downloads":127,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.0.8":{"tag":"1.0.8","author":"mrhamidreza","date":"2026-07-30 18:25:23"},"1.1.0":{"tag":"1.1.0","author":"mrhamidreza","date":"2026-08-08 16:58:19"},"1.2.0":{"tag":"1.2.0","author":"mrhamidreza","date":"2026-08-08 16:58:19"},"1.3.0":{"tag":"1.3.0","author":"mrhamidreza","date":"2026-08-09 07:54:45"}},"upgrade_notice":{"1.3.0":"<p>Improves compatibility, privacy disclosure, background delivery reliability, accessibility, and the WooCommerce settings experience.<\/p>","1.2.0":"<p>Improved settings UI, test message, background delivery, and Markdown notifications for Telegram and Bale. Existing credentials are kept.<\/p>"},"ratings":{"1":0,"2":0,"3":0,"4":0,"5":0},"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3629045,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3629032,"resolution":"256x256","location":"assets","locale":"","width":1254,"height":1254}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3629032,"resolution":"1544x500","location":"assets","locale":"","width":1983,"height":793},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3629045,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.0.8","1.1.0","1.2.0","1.3.0"],"block_files":[],"assets_screenshots":[],"screenshots":{"1":"Plugin settings page under WooCommerce menu","2":"Example order notification message"}},"plugin_section":[],"plugin_tags":[273281,1159,1896,9171,286],"plugin_category":[45],"plugin_contributors":[273895],"plugin_business_model":[],"class_list":["post-342405","plugin","type-plugin","status-publish","hentry","plugin_tags-bale","plugin_tags-notification","plugin_tags-order","plugin_tags-telegram","plugin_tags-woocommerce","plugin_category-ecommerce","plugin_contributors-mrhamidreza","plugin_committers-mrhamidreza"],"banners":{"banner":"https:\/\/ps.w.org\/hamidreza\/assets\/banner-772x250.png?rev=3629045","banner_2x":"https:\/\/ps.w.org\/hamidreza\/assets\/banner-1544x500.png?rev=3629032","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/hamidreza\/assets\/icon-128x128.png?rev=3629045","icon_2x":"https:\/\/ps.w.org\/hamidreza\/assets\/icon-256x256.png?rev=3629032","generated":false},"screenshots":[],"raw_content":"<!--section=description-->\n<p>Hamidreza Order Notifier sends WooCommerce order status notifications directly to your Telegram or Bale bot chat.<\/p>\n\n<p>Features:\n- Send notifications for selected WooCommerce order statuses\n- Support for Telegram and Bale (Markdown formatting)\n- Test connection button on the settings page\n- Background delivery so checkout is not blocked\n- Settings page under WooCommerce admin menu\n- Translation-ready and RTL-friendly\n- Requires WooCommerce as a hard dependency<\/p>\n\n<h3>External services<\/h3>\n\n<p>This plugin connects to third-party messaging APIs to deliver WooCommerce order notifications to a chat configured by the site administrator.<\/p>\n\n<h4>Telegram Bot API<\/h4>\n\n<p>When Telegram is selected in the plugin settings, the plugin sends an HTTP POST request to the Telegram Bot API (<code>https:\/\/api.telegram.org\/bot<\/code>) each time a WooCommerce order reaches one of the enabled order statuses.<\/p>\n\n<p>The request includes the bot token and chat ID configured in the plugin settings, along with a notification message containing order details such as order number, status, customer name, phone number, payment method, order total, date, purchased items, and an admin order link.<\/p>\n\n<p>This service is provided by Telegram: <a href=\"https:\/\/telegram.org\/tos\">Terms of Service<\/a>, <a href=\"https:\/\/telegram.org\/privacy\">Privacy Policy<\/a>.<\/p>\n\n<h4>Bale Bot API<\/h4>\n\n<p>When Bale is selected in the plugin settings, the plugin sends an HTTP POST request to the Bale Bot API (<code>https:\/\/tapi.bale.ai\/bot<\/code>) each time a WooCommerce order reaches one of the enabled order statuses.<\/p>\n\n<p>The request includes the bot token and chat ID configured in the plugin settings, along with a notification message containing order details such as order number, status, customer name, phone number, payment method, order total, date, purchased items, and an admin order link.<\/p>\n\n<p>This service is provided by Bale: <a href=\"https:\/\/bale.ai\/terms\">Terms of Service<\/a>, <a href=\"https:\/\/bale.ai\/terms#s9\">Privacy Policy<\/a>.<\/p>\n\n<!--section=installation-->\n<ol>\n<li>Upload the plugin folder to the <code>\/wp-content\/plugins\/<\/code> directory, or install through the WordPress admin Plugins screen.<\/li>\n<li>Make sure WooCommerce is installed and active.<\/li>\n<li>Activate the plugin through the \"Plugins\" menu in WordPress.<\/li>\n<li>Go to <code>WooCommerce &gt; Order Notifier<\/code>.<\/li>\n<li>Choose Telegram or Bale, then enter your bot token and chat ID.<\/li>\n<li>Click \"Send test message\" to verify the connection.<\/li>\n<li>Enable notifications and choose the order statuses you want.<\/li>\n<li>Click \"Save settings\".<\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt id=\"does%20this%20plugin%20require%20woocommerce%3F\"><h3>Does this plugin require WooCommerce?<\/h3><\/dt>\n<dd><p>Yes. WooCommerce must be installed and active. The plugin will not activate without WooCommerce.<\/p><\/dd>\n<dt id=\"where%20is%20the%20settings%20page%3F\"><h3>Where is the settings page?<\/h3><\/dt>\n<dd><p>The settings page is available under <strong>WooCommerce &gt; Order Notifier<\/strong>. A Settings link is also shown on the Plugins screen.<\/p><\/dd>\n<dt id=\"does%20it%20support%20bale%3F\"><h3>Does it support Bale?<\/h3><\/dt>\n<dd><p>Yes. You can choose Telegram or Bale from the plugin settings.<\/p><\/dd>\n<dt id=\"where%20do%20i%20find%20my%20telegram%20bot%20token%3F\"><h3>Where do I find my Telegram bot token?<\/h3><\/dt>\n<dd><p>Create a bot using @BotFather in Telegram. BotFather will give you an authentication token.<\/p><\/dd>\n<dt id=\"where%20do%20i%20find%20my%20chat%20id%3F\"><h3>Where do I find my chat ID?<\/h3><\/dt>\n<dd><p>Message your bot, then read the chat ID from <code>getUpdates<\/code>, or use a helper bot such as @userinfobot. Group chat IDs are often negative. For Bale, use <code>getUpdates<\/code> on <code>tapi.bale.ai<\/code>.<\/p><\/dd>\n<dt id=\"how%20can%20i%20check%20that%20it%20works%3F\"><h3>How can I check that it works?<\/h3><\/dt>\n<dd><p>Use <strong>Send test message<\/strong> on the settings page. If the message arrives in your chat, live order notifications are ready.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.3.0<\/h4>\n\n<ul>\n<li>Refined the dedicated WooCommerce settings page with a responsive two-column layout and configuration summary<\/li>\n<li>Added suggested privacy policy text for order data sent to Telegram or Bale<\/li>\n<li>Improved accessibility for test results and selected order status controls<\/li>\n<li>Prevented stale and duplicate background notification jobs<\/li>\n<li>Clear pending notification jobs when the plugin is deactivated<\/li>\n<li>Hardened bot token and chat ID sanitization<\/li>\n<li>Declared compatibility with WordPress 7.0 and WooCommerce 11.0<\/li>\n<\/ul>\n\n<h4>1.2.0<\/h4>\n\n<ul>\n<li>Redesigned settings page with status badge, platform cards, and clearer grouping<\/li>\n<li>Added Send test message to verify Telegram or Bale credentials<\/li>\n<li>Bot token field is now hidden by default, with a show\/hide toggle<\/li>\n<li>Notifications are queued in the background so checkout is not delayed<\/li>\n<li>Failed deliveries retry automatically and add an order note<\/li>\n<li>Telegram and Bale messages now use Markdown (with plain-text fallback)<\/li>\n<li>Message includes order number, payment method, and admin order link<\/li>\n<li>Removed API error log setting<\/li>\n<li>Shop managers with manage_woocommerce can open the settings page<\/li>\n<li>Added Settings link on the Plugins screen<\/li>\n<li>Validate credentials before notifications can be enabled<\/li>\n<\/ul>\n\n<h4>1.1.0<\/h4>\n\n<ul>\n<li>Refactored codebase into modular class-based architecture<\/li>\n<li>Settings page moved to WooCommerce submenu (WooCommerce &gt; Order Notifier)<\/li>\n<li>WooCommerce is now a hard dependency - plugin will not activate without it<\/li>\n<li>Added dedicated admin CSS for cleaner settings page<\/li>\n<li>Error logging now works when WP_DEBUG is enabled<\/li>\n<li>Updated WordPress and WooCommerce compatibility headers<\/li>\n<li>Improved code organization following WordPress coding standards<\/li>\n<\/ul>\n\n<h4>1.0.8<\/h4>\n\n<ul>\n<li>Prefix plugin option and settings identifiers with hamidreza_ for WordPress.org compliance.<\/li>\n<li>Migrate stored settings from the legacy hrwcn_settings option key.<\/li>\n<\/ul>\n\n<h4>1.0.7<\/h4>\n\n<ul>\n<li>Remove bundled translation files; translations are managed through translate.wordpress.org.<\/li>\n<li>Document Telegram and Bale external services in the readme.<\/li>\n<\/ul>\n\n<h4>1.0.6<\/h4>\n\n<ul>\n<li>Initial release.<\/li>\n<\/ul>","raw_excerpt":"Send WooCommerce order notifications to Telegram or Bale.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/ru.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/342405","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/ru.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/ru.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/ru.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=342405"}],"author":[{"embeddable":true,"href":"https:\/\/ru.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/mrhamidreza"}],"wp:attachment":[{"href":"https:\/\/ru.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=342405"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/ru.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=342405"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/ru.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=342405"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/ru.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=342405"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/ru.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=342405"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/ru.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=342405"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}