Problem Description
After updating the plugin or WooCommerce, some sites experience PHP warnings/notices, or JS errors that affect payment gateway filtering, making the plugin behave unpredictably or breaking checkout.
Common Symptoms
- Deprecated notices or warnings in WP dashboard plugins list or logs. WordPress.org+1
- After update, payment gateways no longer filter correctly, or checkout fails.
- In plugin changelog, recent versions list fixes for JS errors and compatibility. WPFactory+1
Cause
- WooCommerce or WordPress core updates may deprecate functions or change APIs; plugin needs to update accordingly.
- Custom themes or other plugins may rely on older gateway behavior, causing conflicts after update.
- Browser caching or minification/optimization plugins may serve old JS/CSS, leading to mismatches.
Solution (step-by-step)
- Always use the latest stable version of the plugin and ensure it is compatible with your WooCommerce version. Check changelog for compatibility notes. WPFactory+1
- After update, clear all caches (server, CDN, WP cache, browser cache).
- Check for JS errors in browser console and PHP errors in server logs (enable WP_DEBUG temporarily).
- If errors appear: revert to previous version (if available), then test on staging, or disable conflicting plugins/themes.
- Notify WPFactory support with full error message, site environment, WooCommerce & WP versions, list of active plugins and theme — to help them debug.
Prerequisites
- Site backup before updates.
- Access to server logs / WP debug mode.
Additional Notes
- For store owners: always test plugin updates on a staging copy before production.
- Document any customizations affecting payment gateways or checkout to ease troubleshooting when updates hit.
