Table of Contents
Problem Description #
After updating WordPress or WooCommerce, the plugin causes PHP fatal errors or the plugin becomes non-functional.
Common symptoms
- White screen, fatal error in wp-admin, or plugin deactivated.
- Error stack pointing to plugin files.
Cause
- Major WP/WooCommerce upgrades occasionally change hooks, function signatures, or DB structure; plugin code may need update. In several threads users reported issues after updates. WordPress.org
Solution (step-by-step)
- Put site into maintenance mode (if live site impacted).
- Check the fatal error message: WP dashboard or server error log will show the stack and file line. Copy error message.
- Temporarily disable the plugin: Rename the plugin folder via FTP (/wp-content/plugins/amount-left-free-shipping-woocommerce) to deactivate it if you cannot access WP admin.
- Update plugin to latest version: If a fix was released, update. If not, revert WP/WC update if you have a recent backup and need the site up while awaiting a patch.
- Open a support ticket with error details: Include WP / WooCommerce versions, PHP version, plugin version, theme, and error logs. Plugin maintainers typically respond and provide a patch or instructions. WordPress.org
- Test on staging first for core updates in the future.
Prerequisites
- FTP or hosting control panel access (for emergency deactivation).
- Backups available.
Additional Notes
- Use staging to test core updates before production rollout. Report exact error logs to support for fastest help.
