Email Notifications
Woo Sell Services includes 6 WooCommerce email classes that send notifications at key points in the service order workflow.
Email Classes
Section titled “Email Classes”| Email class | Recipient | Trigger |
|---|---|---|
WC_Requirement_Order_Email |
Customer | Order placed - prompts the customer to fill requirements |
WC_Requirement_Received_Email |
Vendor (product author) | Customer submits the requirement form |
WC_Order_Ready_Email |
Customer | Vendor submits a final delivery |
WC_Order_Accepted_Email |
Vendor (product author) | Customer accepts the delivery |
WC_Order_Rejected_Email |
Admin email (configurable) | Customer rejects the delivery |
WC_Order_Conversation_Email |
Customer and/or vendor | New conversation message (sent via cron with delay) |
Enabling Emails
Section titled “Enabling Emails”Emails are controlled by two layers.
Plugin-Level Toggles
Section titled “Plugin-Level Toggles”At WP Admin > WB Plugins > Woo Sell Services > Notification:
- Enable Service Email - gates requirement, delivery, accepted, and rejected emails.
- Enable Conversation Email - gates conversation message emails.
WooCommerce-Level Toggles
Section titled “WooCommerce-Level Toggles”At WP Admin > WooCommerce > Settings > Emails, each Woo Sell Services email has its own enable/disable toggle, subject, and heading. Both the plugin-level and the WooCommerce-level toggle must be enabled for an email to send.
The conversation email has an additional author_enabled toggle in its WooCommerce settings that controls whether the vendor also receives a copy. It supports a {product_name} placeholder in the subject and heading. Since 5.8.6, order emails are hardened against special characters in product names.
Conversation Email Delay
Section titled “Conversation Email Delay”Conversation emails are not sent immediately. A cron job runs every 5 minutes and selects unread messages whose timestamp is older than the configured delay. If the other user reads the message via live conversation first, no email is sent. Configure the delay at WB Plugins > Woo Sell Services > General > Email Conversation Delay (in minutes).
Requirement Reminder Cron
Section titled “Requirement Reminder Cron”A cron job runs every 5 minutes to check for orders still in Waiting For Requirement. If the configured reminder interval (12 or 24 hours) has passed since the order was placed, the requirement email is re-sent to the customer. Each order is reminded only once, tracked via the requirement_notification_sent meta flag.
Customizing Email Content
Section titled “Customizing Email Content”Subject and Heading
Section titled “Subject and Heading”In WooCommerce > Settings > Emails, click Manage on any Woo Sell Services email to set the subject and heading.
Templates
Section titled “Templates”Email templates live in the plugin at woo-sell-services/woocommerce/templates/emails/, with an HTML and a plain-text version of each:
| Template | Format |
|---|---|
customer-submit-requirement.php |
HTML |
customer-order-ready.php |
HTML |
admin-order-accepted.php |
HTML |
admin-order-rejected.php |
HTML |
admin-requirements-received.php |
HTML |
customer-vendor-order-conversation.php |
HTML |
plain/*.php |
Plain-text version of each of the above |
Overriding Templates
Section titled “Overriding Templates”- Create a
woocommerce/emails/directory in your active theme. - Copy a template from the plugin’s
woocommerce/templates/emails/directory into it. - Edit the copied file.
WordPress uses your theme’s version instead of the plugin’s.
Support Agent Emails
Section titled “Support Agent Emails”When Enable Conversation Co-Author is active, assigned support agents (co-authors) receive copies of conversation emails.