Notifications on Discord for WooCommerce
| 开发者 | jarryd-long |
|---|---|
| 更新时间 | 2026年4月23日 04:32 |
| PHP版本: | 7.1 及以上 |
| WordPress版本: | 6.8 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
详情介绍:
@here, @everyone, or a Discord role ID for any individual status. Set a role ping on failed payments so your team gets alerted immediately, without pinging everyone for every order.
Custom Embed Colors
Every notification status has its own color picker in the settings. Each one comes pre-set to a sensible default (green for completed, amber for pending, red for failed, and so on), but you can change any of them to match your brand or make certain alerts stand out at a glance in Discord.
Minimum Order Value Filter
Reduce noise by only sending notifications for orders above a threshold you set. Useful if you run frequent low-value transactions and only want to be notified for meaningful orders.
Test Button Per Webhook
Every webhook row has a built-in Test button. Click it to send a live test embed to Discord so you can confirm everything is wired up correctly before going live.
Notification Log
An optional log records every notification sent - including the order or subscription number, status, products, order value, and the HTTP response code returned by Discord. Logs auto-purge after a configurable number of days (default: 7).
Developer Filters
ppsndw_woo_discord_payload- modify the full Discord payload before it is sent for order and subscription notificationsppsndw_woo_discord_low_stock_payload- modify the payload for low stock notifications
安装:
- Go to Plugins > Add New and search for "Notifications on Discord for WooCommerce".
- Click Install Now, then Activate.
- Alternatively, download the zip from WordPress.org, go to Plugins > Add New > Upload Plugin, and upload the file.
- Open Discord and go to the channel you want to receive notifications in.
- Click the gear icon next to the channel name to open Edit Channel.
- Go to Integrations > Webhooks > New Webhook.
- Give the webhook a name, optionally set an avatar, then click Copy Webhook URL.
- In your WordPress dashboard, go to WooCommerce > Discord Notifications.
- On the Notifications tab, find the order status you want to be notified for.
- Check the Enable box, paste your webhook URL, and optionally enter a mention.
- Click Test to send a test notification to Discord and confirm it works.
- Click Save Settings.
- Go to the Logs tab.
- Enable logging and set your preferred auto-purge retention period.
- All sent notifications will appear in the log table with response codes so you can confirm delivery.
屏幕截图:
常见问题:
I'm not receiving any notifications in Discord
Discord webhooks only accept requests from publicly accessible URLs. If your site is running locally (e.g. on localhost or a private staging environment), Discord cannot reach it and notifications will silently fail. Deploy to a live, publicly accessible server and test again.
How do I send notifications to different Discord channels per order status?
Each status row has its own Webhook URL field. Simply paste a different webhook URL for each status to route them to separate channels.
Can I use one webhook for all statuses?
Yes. Paste the same webhook URL into every status row you want to enable. All notifications will go to the same channel.
How do I ping my team for failed payments?
In the Mention column next to the Failed status, enter @here, @everyone, or a Discord role ID in the format <@&123456789012345678>. That mention will be included in the notification message so the right people get alerted immediately.
Where do I find a Discord role ID?
Enable Developer Mode in Discord (User Settings > Advanced > Developer Mode), then right-click any role in Server Settings > Roles and click Copy Role ID.
What is the minimum order value filter?
Found at the top of the Notifications tab, this setting lets you suppress notifications for orders below a dollar threshold you set. Set it to 0 to notify for all orders regardless of value.
Does this work with WooCommerce Subscriptions?
Yes. If WooCommerce Subscriptions is installed and active, a Subscription Notifications section will automatically appear in the settings with all supported subscription statuses.
Does this work with WooCommerce High-Performance Order Storage (HPOS)?
Yes. The plugin is fully compatible with WooCommerce HPOS (custom order tables) and has declared compatibility accordingly.
How does the new customer notification work?
A notification fires on a customer's very first order. For registered customers, it checks their total order count. For guests, it checks whether any previous order exists with the same billing email address. If it's their first, the notification fires.
The Test button says it worked but I don't see anything in Discord
Double-check the webhook URL - even a single extra character will cause it to silently fail. Also make sure the webhook hasn't been deleted in Discord. You can verify by opening the channel's Integrations settings and confirming the webhook still exists.
Can I customise what data is sent to Discord?
Yes. Use the ppsndw_woo_discord_payload filter to modify or replace the payload array before it is sent. For low stock notifications, use ppsndw_woo_discord_low_stock_payload. Both filters receive the full payload array and the relevant object (order, subscription, or product).
How do I turn off logging?
Go to WooCommerce > Discord Notifications > Logs tab and uncheck Enable Logging, then save. Existing log entries are kept but no new ones will be written. You can purge all existing entries using the Purge All Logs button.
Will my data be deleted if I uninstall the plugin?
Not by default. To remove all plugin settings, the log table, and scheduled events on deletion, go to the Logs tab and enable Delete Data on Uninstall before deleting the plugin.
My site is not in English - will the notifications work?
Yes. The plugin is translation-ready and loads its own text domain. All static text can be translated using standard WordPress translation tools. Customer names, product names, and order data are passed through as-is from WooCommerce.
更新日志:
- New Feature: Added per-status color picker - choose a custom embed color for each notification directly from the settings page, with the existing defaults pre-selected for backwards compatibility
- Enhancement: Test button now sends the selected color and status label - the test embed reflects the actual color configured for that row and shows the status name in the title (e.g. "Completed Test Notification")
- New Feature: Added WooCommerce Subscriptions support - notifications for Active, On Hold, Cancelled, Expired, Pending Cancellation, Renewal Payment Complete, and Renewal Payment Failed subscription events
- New Feature: Added Discord notification log with enable/disable toggle, configurable auto-purge retention period (default 7 days), manual purge option, and daily cron cleanup
- New Feature: Added low stock alert notifications - sends a dedicated embed to Discord when a product hits its WooCommerce low stock threshold
- New Feature: Added new customer notifications - fires on a customer's first-ever order, covering both registered and guest customers
- New Feature: Added @mention support per status - specify @here, @everyone, or a Discord role ID to ping your team for critical events
- New Feature: Added minimum order value filter - only send notifications for orders above a configured threshold
- New Feature: Added test notification button per webhook - sends a live test embed to Discord directly from the settings page
- New Feature: Added status-specific embed colors - green for completed/active/renewals, amber for pending/on-hold, red for failed/cancelled/expired, grey for refunded
- New Feature: Added customer details to order and subscription embeds - customer name, email, and country with flag emoji
- New Feature: Added ppsndw_woo_discord_payload filter to allow customisation of the data sent to Discord
- New Feature: Added ppsndw_woo_discord_low_stock_payload filter for low stock notification customisation
- New Feature: Added uninstall.php - removes log table, all plugin options, and scheduled cron events when the plugin is deleted (opt-in via settings)
- Enhancement: Redesigned settings page with tabbed layout (Notifications and Logs), compact single-row-per-status table, and section headings
- Enhancement: Moved settings page under the WooCommerce menu
- Enhancement: Added Discord embed field truncation to respect API limits (title 256 chars, field values 1024 chars), preventing silent rejections with long product lists
- Enhancement: Added response code capture - the HTTP status returned by Discord is now logged alongside each notification entry
- Enhancement: Added edit_url storage in the log table at write time, ensuring HPOS-compatible order links in the log view without extra queries
- Enhancement: Added load_plugin_textdomain() so translation files in /languages are properly loaded
- Enhancement: Updated Tested Up To for WordPress 6.8 and WooCommerce 9.4
- Security: Escaped all dynamic output in the settings page with esc_html(), esc_attr(), and wp_kses_post()
- Security: Sanitize webhook URLs with esc_url_raw() instead of sanitize_text_field()
- Security: Replaced date() with gmdate() for timezone-safe timestamp generation
- Security: Added defined('ABSPATH') || exit guard to all PHP include files to prevent direct file access
- Enhancement: Declared WooCommerce High-Performance Order Storage (HPOS) compatibility
- Enhancement: Replaced new WC_Order() with wc_get_order() for WooCommerce HPOS compatibility
- Enhancement: Order edit URL now uses the WooCommerce native method compatible with HPOS
- Enhancement: Fixed country flag emoji generation to use pure PHP UTF-8 encoding, removing the mbstring extension requirement
- Bug Fix: Cancelled order status settings were incorrectly mapped to refunded option IDs, preventing cancelled notifications from working
- Bug Fix: Fixed new customer notification hook - switched from woocommerce_checkout_order_created to woocommerce_new_order to cover admin-created and REST API orders
- Enhancement: Updated Tested Up To for WordPress core and WooCommerce
- Initial release