[FIX] TrackShip emails show empty body when Email Template Customizer (ETC) is active
Environment
WooCommerce 10.2.1 • PHP 8.1.33 • Email Template Customizer for Woo v1.2.18 • TrackShip v1.9.6
(Reproducible with or without SMTP.)
Symptom
TrackShip notifications (Arrived / Delivered / Ready for pickup) are sent with an empty email body when ETC is enabled. Disabling ETC makes the emails normal again.
Root cause
ETC’s compatibility layer hooks into TrackShip and re-renders the message using ETC’s template, which in some cases wipes the body. The hook is added in:
/wp-content/plugins/email-template-customizer-for-woo/includes/compatible.php
Constructor of VIWEC\INC\Compatible:
add_filter( ‘trackship_mail_content’, [ $this, ‘trackship_mail_content’ ], 99, 2 );
Quick fix (works immediately, but will be overwritten by plugin updates)
Edit the file above and comment out the hook registration:
// add_filter( ‘trackship_mail_content’, [ $this, ‘trackship_mail_content’ ], 99, 2 );
After commenting out that line, TrackShip emails are delivered with their own content/body again, while WooCommerce core emails continue to use ETC templates.
Suggestion to vendor
Please add a setting to exclude TrackShip emails from ETC or guard the compatibility layer so it doesn’t override TrackShip’s rendered content.
Hello,
Thank you for your detailed report and for sharing the fix. We really appreciate the effort.
Actually, that is simply removing one of our plugin’s features. If the email body is showing as empty, it may be due to a conflict on your specific site environment. It could be possible that a theme or plugin conflict is causing this behavior. In this case, we would recommend testing by taking the following steps: https://docs.woocommerce.com/document/woocommerce-self-service-guide/
If you don’t want to perform these tests on the live site, I would recommend reaching out to your web host to see if they offer a staging site as part of your hosting package. If not, then I’d recommend using the WP Staging plugin to duplicate the site.
If you prefer to remove that filter, you can do it by adding your own PHP snippet to unhook it instead of editing plugin files directly. That won’t be overridden by updating plugin.
Kind regards.
