Hamidreza Order Notifier
| 开发者 | mrhamidreza |
|---|---|
| 更新时间 | 2026年10月27日 13:16 |
| 捐献地址: | 去捐款 |
| PHP版本: | 7.4 及以上 |
| WordPress版本: | 7.1 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
详情介绍:
Hamidreza Order Notifier sends WooCommerce order status notifications directly to your Telegram or Bale bot chat.
Features:
- Send notifications for selected WooCommerce order statuses
- Support for Telegram and Bale (Markdown formatting)
- Persian / Jalali dates support ({date_jalali}, {date_time_jalali})
- Telegram custom reverse proxy API base URL & SOCKS5 / HTTP proxy for firewalled servers
- Interactive 1-click placeholder palette for easy template editing
- Delivery logs history tracking the last 30 notification events with timestamps and errors
- Silent notification toggle (send messages without alert sounds or vibration)
- Multiple chat IDs and optional delivery to both Telegram and Bale
- Inline Open order button in Telegram and Bale messages
- Custom message template with extensive placeholders
- Optional fields: product SKU, customer note, coupon code, and shipping cost
- Live preview message before saving
- Developer filters and actions for customization
- Modern tabbed interface with full RTL layout support
- Test connection button on the settings page
- Background delivery so checkout is not blocked
- Settings page under WooCommerce admin menu
- Translation-ready and RTL-friendly
- Requires WooCommerce as a hard dependency
安装:
- Upload the plugin folder to the
/wp-content/plugins/directory, or install through the WordPress admin Plugins screen. - Make sure WooCommerce is installed and active.
- Activate the plugin through the "Plugins" menu in WordPress.
- Go to
WooCommerce > Order Notifier. - Choose Telegram or Bale, then enter your bot token and chat ID.
- Click "Send test message" to verify the connection.
- Enable notifications and choose the order statuses you want.
- Click "Save settings".
屏幕截图:
常见问题:
Does this plugin require WooCommerce?
Yes. WooCommerce must be installed and active. The plugin will not activate without WooCommerce.
Where is the settings page?
The settings page is available under WooCommerce > Order Notifier. A Settings link is also shown on the Plugins screen.
Does it support Bale?
Yes. You can choose Telegram or Bale from the plugin settings.
Where do I find my Telegram bot token?
Create a bot using @BotFather in Telegram. BotFather will give you an authentication token.
Where do I find my chat ID?
Message your bot, then read the chat ID from getUpdates, or use a helper bot such as @userinfobot. Group chat IDs are often negative. For Bale, use getUpdates on tapi.bale.ai.
How can I check that it works?
Use Send test message on the settings page. If the message arrives in your chat, live order notifications are ready.
更新日志:
1.6.1
- Refreshed plugin banners with clean, high-DPI typography and feature highlights for both English and Persian (RTL) displays.
- Enhanced network resilience and custom reverse proxy handling.
- General UI improvements and performance polish.
- Fixed custom message templates so placeholder-like text typed by customers (for example in order notes) is no longer expanded.
- Fixed the sample preview order link when WooCommerce High-Performance Order Storage (HPOS) is enabled.
- Fixed the generic error message shown when a notification delivery fails.
- Added Jalali / Persian date conversion for notifications: {date_jalali} and {date_time_jalali}.
- Added custom Telegram reverse proxy API base URL support for firewalled servers and custom network environments.
- Added SOCKS5 and HTTP proxy support for Telegram API connections with optional authentication.
- Added interactive 1-click placeholder palette to easily insert tags into custom message templates.
- Added delivery logs tab to view the last 30 notification attempts with status, timestamps, and error responses.
- Added silent notifications option to send Telegram messages without sound or vibration.
- Modernized admin user interface with tabbed navigation and complete RTL layout styling.
- Added new placeholders: {customer_email}, {shipping_method}, {items_count}, {city}, and {province}.
- Added AJAX action to clear delivery logs.
- Added separate chat IDs for Telegram and Bale with per-platform settings sections (existing shared list kept as fallback)
- Bot tokens are never shown again after saving; an empty token field keeps the saved value, with a masked hint and wp-config constant support
- Message template editor stays empty by default so the automatic layout keeps updating; added Insert default layout and Reset to default buttons, and the preview now shows both plain text and Markdown
- Plain-text fallback now always includes the order link, and the duplicate queue lock is cleared when the order status changes
- Site name and URL shown on a single line under the message title
- Added developer hooks: hron_should_notify, hron_notification_message, hron_notification_sent, hron_notification_failed, hron_chat_ids, and hron_delivery_platforms
- Added support for multiple chat IDs (one per line)
- Added optional delivery to both Telegram and Bale at the same time
- Added inline Open order button for Telegram and Bale messages
- Added site name and domain at the top of the default notification message
- Disabled link previews for URLs in notification messages
- Added optional message fields: product SKU, customer note, coupon code, and shipping cost
- Added custom message template with placeholders
- Added Preview message on the settings page
- Fixed Bale test message using the wrong bot token when both tokens were saved
- Tested up to WordPress 7.1
- Updated author metadata and refreshed plugin visual assets.
- Added the shipping address (with billing address fallback) below purchased items in order notifications.
- Refined the dedicated WooCommerce settings page with a responsive two-column layout and configuration summary
- Added suggested privacy policy text for order data sent to Telegram or Bale
- Improved accessibility for test results and selected order status controls
- Prevented stale and duplicate background notification jobs
- Clear pending notification jobs when the plugin is deactivated
- Hardened bot token and chat ID sanitization
- Declared compatibility with WordPress 7.0 and WooCommerce 11.0
- Redesigned settings page with status badge, platform cards, and clearer grouping
- Added Send test message to verify Telegram or Bale credentials
- Bot token field is now hidden by default, with a show/hide toggle
- Notifications are queued in the background so checkout is not delayed
- Failed deliveries retry automatically and add an order note
- Telegram and Bale messages now use Markdown (with plain-text fallback)
- Message includes order number, payment method, and admin order link
- Removed API error log setting
- Shop managers with manage_woocommerce can open the settings page
- Added Settings link on the Plugins screen
- Validate credentials before notifications can be enabled
- Refactored codebase into modular class-based architecture
- Settings page moved to WooCommerce submenu (WooCommerce > Order Notifier)
- WooCommerce is now a hard dependency - plugin will not activate without it
- Added dedicated admin CSS for cleaner settings page
- Error logging now works when WP_DEBUG is enabled
- Updated WordPress and WooCommerce compatibility headers
- Improved code organization following WordPress coding standards
- Prefix plugin option and settings identifiers with hamidreza_ for WordPress.org compliance.
- Migrate stored settings from the legacy hrwcn_settings option key.
- Remove bundled translation files; translations are managed through translate.wordpress.org.
- Document Telegram and Bale external services in the readme.
- Initial release.